按城市取谷歌搜索结果:location 参数用法
同一个关键词,在北京搜和在上海搜,Google 给出的本地结果是两套。只传 gl 和 hl 不够,因为这两个参数只决定国家和语言,不决定城市。要让 Google 按城市取结果,需要 location。
这篇把 location 的用法、canonical name 的查法,以及几个容易踩的点讲清楚。示例用 SerpBase 的 Google Web Search 端点,1 credit 一次,500 免费 credits 不绑卡。
三个参数的分工
gl:国家,两位国家码,例如us、de、jp。hl:语言,例如en、de、ja。location:城市或地区,必须是 Google 的 canonical name,例如Munich,Bavaria,Germany。
location 只对 mobile 布局生效;device: pc 时 Google 按出口 IP 定位,location 会被忽略。要做城市级对比,把 device 固定为 mobile,并且 gl、hl、location 一起固定,否则结果不可比。
先查 canonical name
不要自己拼城市名。先用免费的 GET /google/locations 查:
curl "https://api.serpbase.dev/google/locations?q=munich&country_code=de&limit=5" \
-H "X-API-Key: YOUR_API_KEY"
返回里每个地点的 canonical_name 就是可以传给 location 的值:
{
"status": 0,
"locations": [
{
"canonical_name": "Munich,Bavaria,Germany",
"name": "Munich",
"country_code": "DE",
"target_type": "City"
}
]
}
这个接口 0 credits,60 次/分,不计入端点额度。
按城市请求
import os
import requests
resp = requests.post(
"https://api.serpbase.dev/google/search",
headers={"X-API-Key": os.environ["SERPBASE_API_KEY"]},
json={
"q": "coffee shops",
"gl": "de",
"hl": "de",
"location": "Munich,Bavaria,Germany",
"device": "mobile",
},
timeout=60,
)
data = resp.json()
print(data["status"], data["credits_charged"])
for item in data.get("organic", [])[:5]:
print(item["rank"], item["title"], item["link"])
常见问题
- 名字不在列表里:Google 不会报错,而是忽略
location,按没有 location 跑。所以先查 canonical name,再发请求。 - 大小写和逗号后的空格:不敏感,
Munich,Bavaria,Germany和munich, bavaria, germany等价。 - PC 布局:
location不生效。要坐标级结果,用 Maps 端点的lat/lng,或者用uule;不要拿location硬套。 - 翻页:
page每页单独计费,城市参数要在每一页都带上。
适合拿 location 做什么
- 多城市排名对比:同一个词跑 5 个城市,比较
local_results和organic。 - 本地商家线索:按城市拿 local pack,再做去重。
- 区域内容差异:同一篇文章在不同城市的排名和展示模块可能不同。
完整参数和示例在 SerpBase 中文文档。先把 GET /google/locations 跑通,再批量跑城市,比直接拼城市名稳。

浙公网安备 33010602011771号