Google V2 SERP：概览

本组接口用于获取 Google 搜索结果页（SERP）数据。返回结果与提交任务时指定的、搜索引擎及地理位置。本平台会模拟指定的位置与搜索环境，以尽可能还原任务创建时对应条件下的搜索结果。

可通过响应中的 check_url 在浏览器无痕模式下打开并核验结果性。系统不会纳用户偏好、搜索历史及个性化因素，因此返回数据不个性化搜索结果。

创建任务时可指定以下设备与操作系统组合：

• 移动端（Mobile）：iOS、Android
• 桌面端（Desktop）：Windows、macOS

Google V2 SERP 接口能力

常规结果

POST /v3/serp/google/v2/live/regular/

Google V2 SERP Regular 接口返回付费搜索结果和自然搜索结果。

该接口不会完整展示精选摘要（Featured Snippet）及 SERP 扩展。如需获取更完整的搜索结果页结构，请使用高级结果接口。

高级结果

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

Google V2 SERP Advanced 接口返回指定、搜索引擎和地理位置下的详细搜索结果数据，能够提供精选摘要及 SERP 扩展的完整概览。

容路径中也可参考：

POST /v3/serp/google/organic/live/advanced/

原始 HTML

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

Google V2 SERP HTML 接口返回指定、搜索引擎和地理位置对应的原始搜索结果页 HTML。

数据获取方式

本平台提供两种获取 SERP 数据的方式：实时模式（Live）和标准模式（Standard）。

实时模式（Live）

实时模式适用于需要立即获得搜索结果的场景。调用 Live 接口时，无需分别创建任务和查询任务结果；一次请求即可同步返回结果。

常用接口：

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

实时模式通常更高的处理优级和参考价格。

标准模式（Standard）

标准模式适用于不要求实时返回结果、但更成本控制的场景。该方式需要分两步完成：

1. 通过任务创建接口提交采集任务；
2. 在任务完成后，通过任务结果接口获取数据。

容路径：

• POST /v3/serp/google/v2/task_post/
• GET /v3/serp/google/v2/task_get/regular/

提交任务时，还可以设置以下回调参数：

• pingback_url：任务完成后，本平台向该地址发送完成通知。
• postback_url：任务完成后，本平台将结果直接推送到该地址。

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

请求限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准**。

• 每个 POST 请求最多可 100 个任务。
• 如需提高调用限额，请联系技术支持。

优级与计费

实时模式会在请求时即时返回结果，因此通常最高的参考价格。

标准模式支持以下两种执行优级：

1. 普通优级（Normal）
2. 高优级（High）

任务费用还会受到部分增值参数影响。

可能产生额外费用的参数

以下参数或条件会提高任务费用：

• calculate_rectangles
• load_async_ai_overview
• people_also_ask_click_depth
• keyword 中搜索运算符
• depth过默认值

支持计费加成的搜索运算符：

• allinanchor:
• allintext:
• allintitle:
• allinurl:
• define:
• filetype:
• id:
• inanchor:
• info:
• intext:
• intitle:
• inurl:
• link:
• site:

费用计算规则

使用增值参数时，最终任务费用会按所选方法、执行优级及增值参数的组合进行计算。

计算如下：

费用 = B × C × K × (D / 默认值)

：

变量	说明
B	所选请求方式和执行优级对应的基础价格
C	当 calculate_rectangles: true 或 load_async_ai_overview: true 时，取值为 2
K	当 keyword含额外搜索运算符时，取值为 5
D	depth 的值，按向上取整规则计算

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

认证说明

调用接口时，在请求头中携带 Bearer Token：

Authorization: Bearer smt_live_YOUR_KEY

实用场景

• 监控核心排名：按指定国家、城市、设备和语言采集自然搜索结果，持续追踪品牌词、产品词及竞品词的排名变化。
• 分析竞品搜索：提取指定下的付费结果与自然结果，识别竞品域名的投放覆盖范围和 SEO 可见性。
• 识别 SERP 特殊：通过高级结果接口获取精选摘要、People Also Ask 等扩展结果，评估高位置的机会。
• 构建本地化 SEO 报告：针对不同城市、国家及终端设备采集结果，为多地区业务制定本地搜索优化策略。
• 还原页面结构进行解析：调用 HTML 接口获取原始搜索结果页，用于自定义解析、页面验证和 SERP 变化审计。