主题
SERP API 概览
SERP API 用于获取搜索引擎结果页（SERP）数据，覆盖常见搜索引擎及多种结果获取方式。完整端点列表请参考 /v3/serp/endpoints/。
本接口支持以下搜索引擎：
- Google：
/v3/serp/google/ - Bing：
/v3/serp/bing/ - YouTube：
/v3/serp/youtube/ - Yahoo：
/v3/serp/yahoo/ - 百度：
/v3/serp/baidu/ - Naver：
/v3/serp/naver/ - Seznam：
/v3/serp/seznam/
返回结果由任务中指定的、搜索引擎、语言和地理位置决定。本平台会模拟目标地区及搜索引擎环境，以尽可能贴近任务创建时对应条件下的搜索结果。
响应中的 check_url 可用于验证结果。建议在浏览器无痕模式下访问该地址，以减少本地 Cookie、登录状态等因素的影响。
> 注意：本接口不会模拟用户搜索历史、个人偏好及个性化搜索因素，因此返回的结果不此类个性化影响。
设备与操作系统
创建 SERP 任务时，可指定以下设备类型及操作系统：
| 设备类型 | 支持的操作系统 |
|---|---|
mobile | ios、android |
desktop | windows、macos |
> 注意：Google News、Events、Images、Search By Image 和 Jobs 当前支持 desktop 设备类型。
附加功能
除常规 SERP 结果获取外，还可使用以下容搜索引擎的功能：
- SERP 截图：
/v3/serp/screenshot - AI 搜索摘要：
/v3/serp/ai_summary
SERP 数据类型
SERP API 提供三种标准结果类型：regular、advanced 和 html。
| 类型 | 适用范围 | 返回 |
|---|---|---|
regular | 自然搜索类型 | 返回指定、搜索引擎和地区的自然结果及付费搜索结果。 |
advanced | 所有支持的 SERP 搜索引擎 | 返回更完整的搜索结果页结构及各类 SERP素。 |
html | 所有支持的 SERP 搜索引擎 | 返回指定搜索条件下的原始 SERP HTML 页面。 |
通常：
- 需自然排名、广告结果等基础数据时，使用
regular。 - 需要知识面板、地图、本地、图片、视频、问答等完整页面时，使用
advanced。 - 需要自行解析页面结构或留存原始页面时，使用
html。
数据获取方式
本平台提供两种获取 SERP 结果的方式：实时方式（Live）和标准方式（Standard）。
Live 实时方式
Live 方式在单次请求中同步返回结果，适用于需要即时获取搜索结果的业务场景。
特点：
- 无需分别发送任务创建和结果获取请求。
- 请求完成后直接返回 SERP 数据。
- 响应速度快，适合实时查询。
- 相较标准方式，单次任务成本更高。
Standard 标准方式
Standard 方式采用异步任务处理流程，适用于不要求立即返回结果的场景。
型流程如下：
- 通过 POST 请求创建 SERP 任务。
- 等平台完成任务采集。
- 获取已完成任务 ID 或接收回调通知。
- 通过对应的 Task GET 端点获取结果。
Standard 方式通常比 Live 方式更经济，并支持以下两种执行优级：
normal：普通优级。high：高优级，通常更快的任务处理速度。
使用回调接收结果
创建 Standard 任务时，可以按需指定以下字段：
| 字段 | 说明 |
|---|---|
pingback_url | 任务完成后，本平台向该地址发送完成通知。收到通知后，您可再调用 Task GET 端点获取数据。 |
postback_url | 任务完成后，本平台将结果直接推送到该地址。 |
使用 postback_url 时，还指定数据获取类型，即以下字段值之一：
regularadvancedhtml
查询已完成任务
如果使用 Standard 方式且未 pingback_url 或 postback_url，可按以下方式获取结果：
- 调用 Tasks Ready 端点，获取已完成但尚未提取的任务 ID 列表。
- 使用对应的 Task GET 端点，根据任务 ID 获取 SERP 结果。
请求限制
SERP API 的调用限制如下：
| 限制项 | 限制值 |
|---|---|
| 平台限流以认证说明中的 30/60/120 次/分钟规则为准 | |
| 单次 POST 请求中的任务数量 | 最多 100 个任务 |
如需提升并发或任务数量限制，请联系技术支持。
优级与计费
SERP 任务的费用取决于以下因素：
- 数据获取方式：Live 或 Standard。
- Standard 任务优级：
normal或high。 - 所选搜索引擎、结果类型及附加参数。
- 请求的结果深度
depth。 - 是否使用截图、AI 摘要等附加能力。
Live 方式以实时返回为目标，通常最高的单次任务成本。Standard 方式的 normal 优级通常成本更低，high 优级则以更快处理速度为目标。
> 注意：当 depth过端点默认值时，任务费用会增加。若默认深度为 10，则每增加 10 条结果通常会产生额外计费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
可通过 /v3/appendix/user_data/ 查询账户及用量信息。测试环境可参考 /v3/appendix/sandbox/。
实用场景
- 监控核心排名：按地区、语言和设备定期抓取自然结果与广告结果，评估 SEO 优化成效并及时发现排名波动。
- 分析竞品搜索：获取目标下的完整 SERP素，识别竞品在自然结果、广告、本地或精选摘要中的覆盖。
- 追踪本地搜索表现：指定城市或区域及移动设备条件，检查门店、服务商或本地业务在地图与本地结果中的展示位置。
- 构建实时查询：使用 Live 方式为站运营平台、选词或客服系统即时返回指定搜索条件下的结果。
- 留存页面结构与 SERP 证据：通过
html结果或截图功能保存指定时间点的搜索页面，用于页面分析、审计和竞品变化追踪。