AIGC标识 按城市取谷歌搜索结果: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 做什么

  1. 多城市排名对比:同一个词跑 5 个城市,比较 local_results 和 organic。
  2. 本地商家线索:按城市拿 local pack,再做去重。
  3. 区域内容差异:同一篇文章在不同城市的排名和展示模块可能不同。

完整参数和示例在 SerpBase 中文文档。先把 GET /google/locations 跑通,再批量跑城市,比直接拼城市名稳。

posted @ 2026-11-16 12:06  蜘蛛人  阅读(6)  评论(0)    收藏  举报