Google V2 SERP：Local Finder 概览

本接口用于获取 Google Local Finder 搜索结果。支持以下接口：

POST /v3/serp/google/v2/live/advanced/：实时返回结构化的 Local Finder 搜索结果。
POST /v3/serp/google/v2/live/html/：实时返回 Local Finder 搜索结果的原始 HTML。
POST /v3/serp/google/v2/task_post/：提交标准任务。
GET /v3/serp/google/v2/task_get/advanced/：获取标准任务的结构化结果。

返回结果由、搜索引擎和地理位置决定。本平台会尽可能准确地模拟指定的搜索位置和搜索环境，使任务提交时获取的结果接近对应参数下的真实搜索结果。

每个任务返回的 check_url 可用于复核结果。建议在无痕模式下访问该地址，以减少浏览器个性化设置对结果验证的影响。本平台不会将用户偏好、搜索历史及个性化因素反映到返回的 SERP 结果中。

支持的设备与操作系统

提交任务时，可以指定获取结果所对应的设备类型和操作系统：

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

接口能力

结构化结果

POST /v3/serp/google/v2/live/advanced/ 用于实时获取指定、搜索引擎和地理位置下的 Local Finder 结构化结果。

该接口适用于需要立即获得排名、商家信息及 SERP 字段的场景。

HTML 结果

POST /v3/serp/google/v2/live/html/ 用于实时获取指定查询条件下的 Local Finder 原始 HTML 页面。

该接口适用于需要自行解析页面结构，或需要保留完整页面的场景。

数据获取方式

本平台提供两种结果获取方式：实时方式和标准方式。

实时方式

实时方式通过以下接口直接提交请求并返回结果：

http

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

该方式无需分别调用任务提交接口和结果查询接口，适合对响应时效要求较高的业务。实时方式的费用通常高于标准方式。

标准方式

标准方式需要提交任务，再获取任务结果：

http

POST /v3/serp/google/v2/task_post/
GET /v3/serp/google/v2/task_get/advanced/

标准方式的执行流程如下：

调用 POST /v3/serp/google/v2/task_post/ 提交一个或多个任务。
等任务执行完成。
调用 GET /v3/serp/google/v2/task_get/advanced/ 获取结构化结果。

标准方式不要求实时返回结果，费用通常低于实时方式。任务完成后，也可以通过回调方式接收通知或结果。

回调方式

提交标准任务时，可设置以下字段：

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

如果使用 postback_url，还需要指定结果处理函数：

advanced：返回结构化结果。
html：返回原始 HTML。

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

请求示例

以下示例使用实时结构化接口。请求体是 JSON 数组，即使只提交一个任务，也需要使用数组格式。

bash

curl --request POST \
  --url https://api.seermartech.cn/v3/serp/google/v2/live/advanced/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "北京咖啡店",
      "location_code": 215ಡಿ,
      "language_code": "zh-CN",
      "device": "desktop",
      "os": "windows",
      "depth": 20
    }
  ]'

> 请根据使用的地区替换 location_code。上例中的字段用于展示请求格式，可用参数以对应接口文档为准。

频率限制

本平台对 POST 和 GET 请求总量实施频率限制：

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

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

优级与计费

实时方式会立即执行任务，因此通常最高的请求成本。

标准方式提供两种任务优级：

Normal：普通优级。
High：高优级，通常更快的执行速度。

任务费用还会受到以下因素影响：

所选的数据获取方式。
标准任务的执行优级。
depth 参数。
设备类型。

当 depth 高于默认值时，任务费用会增加。结果计费规则如下：

桌面设备：每 20 条结果计费一次。
移动设备：每 10 条结果计费一次。

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

结果验证

接口返回的结果中可能 check_url 字段。可以在无痕模式下访问该地址，检查指定、位置、设备和操作系统下的搜索页面，从而验证返回数据是否符合预期。

需要注意的是，真实搜索页面可能受到以下因素影响：

用户登录状态。
浏览器设置。
本地个性化。
搜索历史。
搜索引擎临时实验或页面变化。

本平台返回的数据会忽略用户偏好、搜索历史及个性化因素。

实用场景

监控本地商家排名：定期查询多个城市和下的 Local Finder 排名，评估门店本地 SEO 表现。
比较竞品本地可见度：批量获取目标区域的商家结果，分析竞品出现频率、排名位置和覆盖范围。
验证本地 SEO 优化效果：在调整商家资料、评价策略或本地页面后，对比不同时间点的 SERP 结果变化。
构建本地搜索数据集：通过结构化接口采集不同和地区的商家结果，为市场研究、选址和区域拓展提供数据支持。
留存搜索页面证据：使用 HTML 接口保存 Local Finder 页面，用于页面解析、审计和搜索结果变更追踪。

Google V2 SERP：Local Finder 概览 ​

支持的设备与操作系统 ​

接口能力 ​

结构化结果 ​

HTML 结果 ​

数据获取方式 ​

实时方式 ​

标准方式 ​

回调方式 ​

请求示例 ​

频率限制 ​

优级与计费 ​

结果验证 ​

实用场景 ​