SeerMarTech 文档控制台

Google Maps Live Advanced

POST/v3/serp/google/maps/live/advanced

实时获取 Google Maps 本地商家搜索结果,包含商家名称、地址、评分、评论数、类别等。适用于本地 SEO、门店竞品分析、地理位置营销。

参考价:¥0.0320 / 次(实际以请求返回为准)

请求体

参数类型必填说明
keywordstring搜索词,如「咖啡店 上海」
location_codeinteger目标地区代码
language_codestring语言代码
depthinteger返回商家数量,默认 100

请求示例

curl

curl -X POST "https://api.seermartech.cn/v3/serp/google/maps/live/advanced" \ -H "Authorization: Bearer smt_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '[{ "keyword": "咖啡店", "location_code": 2156, "language_code": "zh" }]'

Python

import requests resp = requests.post( "https://api.seermartech.cn/v3/serp/google/maps/live/advanced", headers={"Authorization": "Bearer smt_live_YOUR_KEY"}, json=[{"keyword": "咖啡店", "location_code": 2156, "language_code": "zh"}], timeout=60, ) data = resp.json() items = data["tasks"][0]["result"][0]["items"] for item in items[:5]: if item.get("type") == "maps_search": print(item.get("title"), item.get("rating", {}).get("value"))

TypeScript

const resp = await fetch( "https://api.seermartech.cn/v3/serp/google/maps/live/advanced", { method: "POST", headers: { Authorization: "Bearer smt_live_YOUR_KEY", "Content-Type": "application/json", }, body: JSON.stringify([{ keyword: "咖啡店", location_code: 2156, language_code: "zh", }]), } ); const data = await resp.json(); console.log(data.tasks[0].result[0].items.slice(0, 5));

响应字段(常用)

字段说明
items[].title商家名称
items[].address地址
items[].rating.value评分
items[].rating.votes_count评论数
items[].category商家类别

业务场景