Naver SERP API 概览

Naver SERP API 用于获取 Naver 搜索引擎中指定的前 15 条搜索结果。您可按、设备类型和操作系统获取对应的搜索结果数据。

Naver 的搜索结果不区分地理位置和界面语言，因此任务参数中不 location 或 language。但您可以使用任意语言提交；不同的语言可能导致不同的搜索结果。

响应中的 check_url 可用于核验采集结果。建议使用浏览器无痕模式访问该链接，以减少本地 Cookie、登录状态和历史记录的影响。本接口会忽略用户偏好、搜索历史等个性化因素，因此返回结果不个性化排序影响。

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

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

排名字段

本接口使用以下字段描述结果在搜索结果页中的排名：

字段	说明
rank_group	结果在所属 SERP素组的排名。例如，某条自然结果在自然搜索结果组中的位置。
rank_absolute	结果在整个 SERP 页面所有中的绝对位置。

例如，图片、地图、本地结果等模块可能插在自然搜索结果之间，因此同一结果的 rank_group 与 rank_absolute 可能不同。

支持的功能

Naver SERP API 提供以下三种数据获取功能。

Regular

Regular 功能返回指定的前 15 条自然搜索结果和付费搜索结果。

适用于需获取基础自然排名与广告结果的场景。

Advanced

Advanced 功能返回指定的前 15 条搜索结果，并提供更完整的 SERP素数据，可能：

• images：图片结果
• local_pack：本地结果
• map：地图结果
• related_searches：搜索
• video：视频结果

适用于需要分析搜索结果页结构、富媒体模块及搜索需求的场景。

HTML

HTML 功能返回指定对应的原始 SERP HTML 页面。

适用于需要自行解析页面结构、保留原始页面或排查 SERP素展示问题的场景。

数据获取方式

Naver SERP API 支持 Standard（标准） 数据获取方式。

标准方式采用异步任务流程，需要分别发送 POST 请求创建任务，再通过 GET 请求获取已完成任务的结果。该方式成本更低，适合批量采集和非实时查询需求。

任务完成后，您可通过以下方式接收或获取数据：

1. 轮询获取结果

   • 创建任务时不传 pingback_url 和 postback_url。
   • 通过 Tasks Ready 接口获取尚未读取的已完成任务 ID 列表。
   • 再通过 Task GET 接口按任务 ID 获取结果。

2. Pingback 回调通知

   • 创建任务时指定 pingback_url。
   • 任务完成后，本平台会向该地址发送完成通知。
   • 收到通知后，您仍需调用任务结果接口获取数据。

3. Postback 直接推送结果

   • 创建任务时指定 postback_url。
   • 任务完成后，本平台会将结果直接推送至该地址。
   • 使用 postback_url 时，同时指定数据功能类型：regular、advanced 或 html。

可使用沙箱接口 /v3/appendix/sandbox/ 测试任务创建及请求流程。

请求限制

限制项	限制值
平台限流以认证说明中的 30/60/120 次/分钟规则为准
单次 POST 请求中的任务数	最多 100 个

如需提高调用额，请联系技术支持。

优级与计费

Standard 方式支持以下两种任务优级：

1. Normal（普通优级）：适用于常规批量任务。
2. High（高优级）：适用于对结果返回速度要求更高的任务。

任务的 depth过默认值时会增加计费。例如，默认深度为 15 条结果，若请求更多结果，将按每增加一个 15 条结果区间计费。

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

使用建议

• 使用 check_url 在无痕模式下核验结果页，确认采集数据与目标页面一致。
• 若需自然结果及广告结果，优选择 regular，以减少不的数据处理。
• 若需识别图片、地图、本地、视频等页面模块，使用 advanced。
• 若需保留页面原始结构或自行解析未结构化，使用 html。
• 批量提交任务时，建议将每个 POST 请求控制在 100 个任务，并结合 Tasks Ready 接口分批拉取结果。

实用场景

• 监控排名：跟踪品牌词、核心产品词及竞品词在 Naver 中的自然排名变化，为韩国市场 SEO 优化提供依据。
• 识别 SERP 富媒体机会：通过 advanced 结果识别图片、视频、地图和本地结果模块，制定更适合的与结构化数据策略。
• 分析本地搜索竞争度：获取 local_pack 和 map 数据，评估门店、服务区域或本地商家在 Naver 搜索中的机会。
• 挖掘搜索需求：分析 related_searches 字段，扩展库并发现用户的长尾搜索意图。
• 归档原始搜索页面：使用 HTML 功能保存指定的原始 SERP 页面，用于页面审计、竞品展示分析和异常结果排查。