主题
Google AI Mode SERP 概览
Google AI Mode SERP 接口用于获取 Google AI Mode 功能下的搜索结果。本平台会尽可能模拟指定的搜索地点、语言与搜索环境,以返回与任务提交时搜索结果高度一致的数据。
响应中的 check_url 可用于核验结果。建议使用浏览器无痕模式访问该链接,以减少本地 Cookie、登录状态和历史记录对结果的影响。
> 本接口不会模拟用户偏好、搜索历史等个性化因素,因此返回结果不个性化排序或。
可用接口
实时高级结果
POST /v3/serp/google/ai_mode/live/advanced/
获取指定、语言和地点的 Google AI Mode 搜索结果结构化数据。适用于需要同步返回结果的场景。
实时 HTML 结果
POST /v3/serp/google/ai_mode/live/html/
获取指定、语言和地点对应的 Google AI Mode 原始 HTML 页面。适用于需要自行解析页面结构或保存原始页面快的场景。
数据获取方式
Google AI Mode SERP 支持实时(Live)与标准(Standard)两种获取方式。
Live 实时方式
Live 方式在单次请求中同步返回结果,无需创建任务后再单独查询结果。
适用接口:
POST /v3/serp/google/ai_mode/live/advanced/POST /v3/serp/google/ai_mode/live/html/
适合需要即时展示搜索结果、在线分析或用户请求同步响应的业务。由于实时采集资源消耗更高,该方式的计费通常高于 Standard 方式。
Standard 标准方式
Standard 方式采用“创建任务 + 获取结果”的异步流程,适合不要求实时返回、希望降低采集成本的批量任务。
1. 创建任务
POST /v3/serp/google/ai_mode/task_post/
POST 请求体为 JSON 数组,即使提交一个任务也需要使用数组结构:
json
[
{
"keyword": "best project management software",
"language_code": "en",
"location_code": 2840
}
]单次 POST 请求最多可 100 个任务。
2. 获取任务结果
任务完成后,可通过对应的 Task GET 接口获取结果:
- 高级结构化结果:
GET /v3/serp/google/ai_mode/task_get/advanced/{id} - 原始 HTML 结果:
GET /v3/serp/google/ai_mode/task_get/html/{id}
{id} 为创建任务时返回的任务 ID。
使用回调接收结果
创建 Standard 任务时,可以指定以下回调字段:
| 字段 | 说明 |
|---|---|
pingback_url | 任务完成后,本平台向该地址发送完成通知。收到通知后,您可再调用 Task GET 接口获取结果。 |
postback_url | 任务完成后,本平台直接将结果发送至指定地址。使用该字段时,同时指定数据返回类型。 |
使用 postback_url 时,需要指定获取函数类型:
advanced:返回结构化高级结果;html:返回原始 HTML 结果。
查询已完成任务
如果使用 Standard 方式且未设置 pingback_url 或 postback_url,可调用 Tasks Ready 接口获取已完成但尚未拉取结果的任务 ID 列表,再通过对应的 Task GET 接口获取任务结果。
请求频率限制
Google AI Mode SERP 接口的 POST 与 GET 请求合计支持:
平台限流以认证说明中的 30/60/120 次/分钟规则为准;
- 每个 POST 请求最多提交 100 个任务。
如需更高的并发或调用额度,请联系技术支持。
优级与计费
Live 方式实时返回结果,通常最高的请求成本。
Standard 方式支持以下执行优级:
normal:普通优级,适合常规批量采集;high:高优级,适合希望更快完成任务的场景。
任务深度 depth过默认值时,会增加任务成本。计费结果数量按以下规则计算:
- 桌面端:每 20 条结果计费一次;
- 移动端:每 10 条结果计费一次。
扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
实用场景
- 监控 AI Mode 品牌:定期采集品牌词和竞品词的 AI Mode 结果,评估品牌是否被 AI 回答引用或推荐。
- 分析 AI 搜索答案来源:通过高级结构化结果识别 AI 回答引用的网站与页面,挖掘高价值来源和外链机会。
- 追踪搜索意图变化:对核心持续采集 AI Mode 结果,发现传统自然搜索结果与 AI 回答之间的意图差异。
- 构建竞品选题库:提取 AI Mode 回答覆盖的主题、引用页面和问题,为团队制定选题与优化策略。
- 保存搜索结果页面快:使用 HTML 接口归档原始搜索结果页面,用于页面结构分析、结果审计与历史变化比对。