主题
Seznam SERP API 概览
Seznam SERP API 用于获取指定、地点、设备类型及操作系统下的 Seznam 搜索结果。Seznam 是捷本地市场常用的搜索引擎；建议使用捷语进行检索，英文同样可以返回结果。
默认，本接口每个任务返回 10 条搜索结果的 SERP 页面。可通过 depth 参数获取更多结果，但当 depth 大于 10 时会产生额外费用。
返回结果会根据任务中设置的、地点 和 语言 参数生成。Seznam SERP API 支持捷语语言参数。
本平台会尽可能模拟所设置的检索条件，以使返回结果接近任务创建时对应条件下的搜索结果。您可以在浏览器无痕模式中打开响应返回的 check_url，核验结果页面。
> 用户偏好、搜索历史及个性化因素不会纳结果计算，因此返回的 SERP 数据不个性化排序影响。
支持的设备与操作系统
创建任务时，可指定以下设备类型和操作系统：
| 设备类型 | 支持的操作系统 |
|---|---|
mobile | ios、android |
desktop | windows、macos |
排名字段说明
SERP 结果使用以下字段表示排名：
| 字段 | 说明 |
|---|---|
rank_group | 结果在所属 SERP素分组中的排名。例如，自然搜索结果、广告结果等各自分组的位置。 |
rank_absolute | 结果在整页 SERP 所有中的绝对位置。 |
例如，某条自然搜索结果可能在自然结果分组中排第 1 位，即 rank_group: 1；但前方若存在广告、精选摘要等整页位置 rank_absolute 可能大于 1。
SERP 数据功能
Seznam SERP API 提供以下三类数据获取功能：
| 功能 | 说明 |
|---|---|
regular | 返回指定、搜索引擎和地点下的前 100 条自然搜索结果及付费搜索结果。 |
advanced | 返回前 100 条搜索结果，并提供更多 SERP素数据，例如 images、local_pack、featured_snippet、related_searches 和 video。 |
html | 返回指定、搜索引擎和地点对应的原始 SERP HTML 页面。 |
请求方式
Seznam SERP API 支持 Standard（标准） 数据获取方式。
标准方式采用异步任务模式：
- 通过
POST请求创建任务； - 本平台采集并处理搜索结果；
- 通过
GET请求获取已完成任务的结果。
创建任务时，也可以设置以下回调字段：
| 字段 | 说明 |
|---|---|
pingback_url | 任务完成后，本平台向该地址发送完成通知。 |
postback_url | 任务完成后，本平台将结果直接推送至该地址。使用此字段时，还指定数据获取功能：regular、advanced 或 html。 |
如果未设置 pingback_url 或 postback_url，可按以下流程获取结果：
- 调用 Tasks Ready 接口，获取已完成但尚未提取结果的任务 ID 列表；
- 使用 Task GET 接口，按任务 ID 拉取对应结果。
请求限制
| 限制项 | 上限 |
|---|---|
| 平台限流以认证说明中的 30/60/120 次/分钟规则为准 | |
| 单次 POST 请求中的任务数 | 最多 100 个任务 |
如需提高请求限额，请联系本平台技术支持。对于大批量 SERP 任务，建议采用分批提交、回调接收和定期拉取已完成任务的方式，重复查询或出速率限制。
执行优级与计费
Standard 方式支持两种任务执行优级：
- Normal priority：普通优级；
- High priority：高优级。
高优级通常意味着更快的任务处理速度，计费也相应不同。
付费参数
以下参数会增加单个任务的费用：
| 参数 | 计费规则 |
|---|---|
depth | 当值大于 10 时，按结果深度阶梯增加费用。 |
任务最终费用按以下计算：
text
费用 = B × (D / 10)：
| 变量 | 说明 |
|---|---|
B | 所选数据功能及执行优级对应的基础价格 |
D | depth 向上取整至下一个 10 的倍数后的值 |
例如，若 depth 设置为 23，则 D 按 30 计算；若设置为 10，则按基础价格计算。
扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
沙箱测试
可通过 Sandbox 测试 Seznam SERP API 的任务创建、结果解析及响应处理流程。
实用场景
- 监测捷排名：按、地点和设备类型获取 Seznam 搜索结果，评估网站在捷本地搜索市场中的自然排名表现。
- 追踪竞品搜索可见性：提取自然结果、付费结果及排名字段，识别竞争对手在目标查询下的位置与投放。
- 分析 SERP 特殊：使用
advanced功能采集local_pack、featured_snippet、图片和视频等，判断页面的竞争结构。 - 核验本地化搜索表现：结合捷地点参数和桌面端、移动端，对比不同地区与终端上的搜索结果差异。
- 归档搜索页面原始结构：使用
html功能保存原始 SERP HTML，用于页面解析、结果复核和历史快留存。