SERP API 概览

SERP API 用于获取搜索引擎结果页数据，覆盖多类搜索场景与多个搜索引擎。

本接口一组完整的 SERP 端点，可用于抓取指定关键词、搜索引擎、语言、地区条件下的搜索结果。支持的主流搜索引擎：

• Google
• Bing
• YouTube
• Yahoo
• Baidu
• Naver
• Seznam

返回结果会严格基于你创建任务时指定的以下参数生成：

• 搜索引擎
• 语言
• 地区

本平台会尽可能高精度地模拟目标地区与搜索环境，因此返回的结果应尽量接近任务提交时该条件下的真实搜索结果。你也可以通过响应中的 check_url，使用浏览器无痕模式进行核验，以确认结果性。

需要注意的是，系统不会考虑以下个性化因素，因此这些因素不会反映在返回的 SERP 结果中：

• 用户偏好
• 搜索历史
• 登录状态个性化
• 个性化排序因素

设备与操作系统支持

在创建任务时，你可以指定希望获取哪种设备类型与操作系统下的 SERP 结果。

设备类型

• 移动端（Mobile）
• 支持操作系统：iOS、Android
• 桌面端（Desktop）
• 支持操作系统：Windows、macOS

注意：Google News、Events、Images、Search By Image、Jobs 当前支持 desktop。

附加能力

除基础 SERP 结果抓取外，本接口还提供以下附加功能（适用于容的搜索引擎）：

• SERP Screenshot：获取结果页截图
• AI Summary：获取搜索结果的 AI 摘要

SERP 功能类型

SERP API 提供三种标准功能类型：Regular、Advanced、HTML。

1）Regular

Regular 适用于自然搜索类型，可返回：

• 自然搜索结果
• 付费广告结果

适用维度：

• 指定
• 指定搜索引擎
• 指定地区

2）Advanced

Advanced 适用于本接口支持的搜索引擎类型，提供更完整的搜索结果结构化视图，适合需要提取更多 SERP素的场景。

3）HTML

HTML 适用于整个 SERP API 体系，可返回指定关键词、搜索引擎和地区下的原始 SERP HTML 页面。

调用方式

SERP 结果支持两种主要获取方式：Standard 和 Live。

Live 方法

如果你的系统要求实时返回结果，建议使用 Live 方法。

特点：

• 实时获取结果
• 无需分开执行 POST 与 GET
• 调用链更短，适合在线查询、即时展示等场景

Standard 方法

如果你不要求实时返回，可以使用 Standard 方法。

特点：

• 需分开执行 POST 创建任务、GET 获取结果
• 成本更低
• 适合批量采集、离线分析、定时任务等场景

使用 Standard 方法时，本平台会完成任务采集，随后你再获取结果。

回调机制

设置任务时，你还可以通过以下字段接收异步通知：

• pingback_url：任务完成后通知你
• postback_url：任务完成后直接将结果推送到你的地址

如果使用 postback_url，还需要额外指定用于结果返回的功能类型：

• regular
• advanced
• html

已完成任务获取流程

如果你使用 Standard 方法，且未设置 pingback_url 或 postback_url，可以通过以下方式拉取已完成任务：

1. 调用 Tasks Ready 端点，获取所有已完成但尚未被提取的任务 ID 列表
2. 再调用 Task GET 端点，根据任务 ID 获取结果

这种方式适合自行管理轮询与结果消费流程的系统。

请求频率限制

接口整体频率限制如下：

• POST + GET 合计最多 2000 次/分钟
• 每个 POST 请求中最多 100 个任务

如需更高额，可联系平台申请调整。

优级与计费

SERP 端点的费用取决于：

• 调用方法
• 任务执行优级
• 部分附加参数

方法与优级

Live

Live 方法实时返回结果，因此通常是成本最高的方式。

Standard

Standard 方法支持两种优级：

1. normal
2. high

优级越高，通常执行越快，费用也会不同。

depth 对费用的影响

如果你将 depth 设置为高于默认值，任务费用会增加。

例如：

• 若默认 depth 为 10
• 则系统通常会按每 10 条结果作为一个计费单位

也就是说，当你请求更深层的结果页时，费用会相应上升。

费用说明

本文为概览页，不列出端点单价。费用受以下因素影响：

• 搜索引擎
• 功能类型（regular / advanced / html）
• 获取方式（standard / live）
• 优级
• depth
• 附加参数

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

你也可以通过单独调用用户数据接口查看当前账户的使用与消耗，例如 /v3/appendix/user_data/。

沙箱测试

你可以使用沙箱环境测试请求结构、参数格式与基础集成流程，再切换到正式环境进行调用。

常见容路径

以下为本接口体系下常见的容路径示例：

• /v3/serp/
• /v3/serp/google/
• /v3/serp/bing/
• /v3/serp/youtube/
• /v3/serp/yahoo/
• /v3/serp/baidu/
• /v3/serp/naver/
• /v3/serp/seznam/
• /v3/serp/screenshot
• /v3/serp/ai_summary
• /v3/appendix/user_data/
• /v3/appendix/sandbox/

认证方式

所有请求均应通过 Bearer Token 鉴权。

curl 示例

curl -X GET "https://api.seermartech.cn/v3/serp/" \
 -H "Authorization: Bearer smt_live_YOUR_KEY"

Python 示例

import requests

url = "https://api.seermartech.cn/v3/serp/"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY"
}

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)

TypeScript 示例

const response = await fetch("https://api.seermartech.cn/v3/serp/", {
 method: "GET",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY"
 }
});

console.log(response.status);
console.log(await response.text);

使用建议

• 需要即时结果时，优使用 Live
• 需要控制成本时，优使用 Standard
• 批量采集时，合理拆分 POST 任务，每次不 100 条
• 对结果完整度要求较高时，优评估 Advanced
• 对页面还原、选择器解析或二次抽取有要求时，使用 HTML
• 对费用敏感时，谨提高 depth

实用场景

• 监控排名：按、地区、语言持续抓取 SERP，跟踪自然结果与广告位变化，支撑 SEO 排名监控与竞争分析。
• 分析本地化搜索结果：模拟不同国家、城市或语言环境下的搜索页面，评估本地 SEO 表现，指导区域化与落地页优化。
• 识别 SERP 特征机会：通过 advanced 结果识别新闻、图片、问答、视频等模块机会，优化形态与点击布局。
• 构建搜索快留档：结合 html 或截图能力保存搜索结果原始页面，用于效果复盘、异常取证和搜索版式变更对比。
• 批量采集行业报：通过 Standard 方法定时抓取大量结果，低成本建立竞品监测、广告投放观察和市场趋势分析数据集。