Google V2 SERP：Google 地图搜索结果概览

本接口使用 POST /v3/serp/google/v2/live/advanced/，用于实时获取 Google 地图搜索结果中排名靠前的最多 100 条结果。

返回结果由指定的、搜索引擎和地理位置参数决定。接口基于 Google 地图中的 “搜索此区域（Search this area）” 参数执行搜索，这是在自定义位置范围进行 Google 地图搜索的方式。为确保排名位置准确，请在任务参数中启用该选项。

本平台会尽可能精确地模拟指定的搜索位置和设备环境，使返回结果与任务创建时对应参数下的搜索结果保持一致。你可以在隐身模式下访问响应中的 check_url，核验结果是否符合预期。

系统不会使用用户偏好、搜索历史或个性化因素，因此这些因素不会反映在返回的 SERP 结果中。

支持的设备与操作系统

创建任务时，可以指定用于获取 Google 地图结果的设备类型和操作系统：

移动设备
- iOS
- Android
桌面设备
- Windows
- macOS

Google V2 SERP 接口

实时查询

POST /v3/serp/google/v2/live/advanced/

该接口用于根据指定的、搜索引擎和地理位置，实时返回最多 100 条 Google 地图搜索结果。

示例请求：

bash

curl -X POST "https://api.seermartech.cn/v3/serp/google/v2/live/advanced/" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "keyword": "咖啡店",
      "location_code": 1023191,
      "language_code": "zh-CN",
      "device": "mobile",
      "os": "ios",
      "depth": 100
    }
  ]'

> 上述参数用于展示请求结构。可用参数及取值请以对应接口的参数定义为准。

数据获取方式

本平台提供两种 SERP 数据获取方式：标准方式和实时方式。

实时方式

实时方式适用于需要立即获得结果的场景：

使用 POST /v3/serp/google/v2/live/advanced/ 提交请求；
接口直接返回查询结果；
无需分别调用任务创建和任务获取接口；
相比标准方式，实时方式的请求成本通常更高。

标准方式

标准方式适用于不要求实时返回结果的场景：

使用 POST /v3/serp/google/v2/task_post/ 创建任务；
等系统完成数据采集；
使用 GET /v3/serp/google/v2/task_get/advanced/ 获取结果。

标准方式通常比实时方式更经济。你也可以在创建任务时设置以下回调参数：

pingback_url：任务完成后通知指定地址；
postback_url：任务完成后将结果发送到指定地址。

如果使用 postback_url，还需要指定用于获取数据的 advanced 函数。

如果使用标准方式时未设置 pingback_url 或 postback_url，可以调用 Tasks Ready 接口，获取所有已完成但尚未提取的任务 ID，再通过 Task GET 接口获取对应结果。

请求限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准POST 和 GET API 请求，合计计算；

每次 POST 请求最多 100 个任务；
如需提高调用上限，请联系平台技术支持。

优级与计费

标准方式支持两种任务优级，分别对应不同的执行速度和计费标准：

Normal：普通优级；
High：高优级。

实时方式会立即返回结果，因此通常采用更高的计费标准。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

`depth` 对计费的影响

将 depth 设置为高于默认值会增加任务成本。计费结果数量区间计算：

如果默认 depth 为 100，通常按每 100 条结果计费；
如果设置 "depth": 150，将按 200 条结果对应的数量区间计费，任务价格相当于乘以 2。

结果核验

返回结果通常 check_url，可在隐身模式下打开该地址，对比指定、位置、设备和操作系统下的 Google 地图搜索结果。

由于系统会忽略用户登录状态、搜索历史和个性化偏好，浏览器中查看到的结果可能与已登录环境或个性化环境下的结果存在差异。

接口路径

实时高级查询：POST /v3/serp/google/v2/live/advanced/
标准方式创建任务：POST /v3/serp/google/v2/task_post/
标准方式获取高级结果：GET /v3/serp/google/v2/task_get/advanced/

实用场景

监控本地排名：批量查询不同城市或商圈的 Google 地图结果，评估门店在本地搜索中的位置。
对比竞品地图表现：针对相同和位置采集竞争门店排名，分析竞品覆盖区域与排名差异。
验证本地 SEO 优化效果：在优化前后使用一致的、位置和设备参数进行查询，衡量地图排名变化。
发现区域市场机会：按城市、经纬度或自定义搜索区域采集结果，识别排名较弱但需求较高的本地市场。
构建门店排名报表：结合 check_url 和 SERP 结果，为连锁门店生成按地区、设备和拆分的排名监测报告。

Google V2 SERP：Google 地图搜索结果概览 ​

支持的设备与操作系统 ​

Google V2 SERP 接口 ​

实时查询 ​

数据获取方式 ​

实时方式 ​

标准方式 ​

请求限制 ​

优级与计费 ​

depth 对计费的影响 ​

结果核验 ​

接口路径 ​

实用场景 ​