Naver 搜索结果 API（NAVER_SERP） - querying.ai

NAVER_SERP 返回 Naver 网页文档标签页结果的一页，每页 15 篇文档。使用 "action": "page" 时，它读取一个 naver.com 页面（博客文章、Cafe 文章、新闻、知识问答回答或任何其他 naver.com 页面）并返回其文本。


`taskType`	`NAVER_SERP`
输入	`query`（搜索时必填）；`page`、`country`；或 `action: "page"` 配合 `url`、`maxChars`
积分	每个任务 1 积分
国家	默认 `KR`。
位置	不支持（`422 LOCATION_UNSUPPORTED`）。

搜索

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "NAVER_SERP", "payload": { "query": "running shoes for flat feet", "page": 2 } }'

字段	必填	说明
`query`	是	搜索查询，1-100,000 个字符。缺少 `query` 时接受 `prompt`。
`page`	否	结果页码，1 到 10 的整数，默认 `1`。其他值返回 `422 VALIDATION_ERROR`。
`country`	否	默认 `KR`，即 Naver 的市场。

例如第 2 页：

{
  "organicResults": [
    { "position": 16, "title": "...", "link": "https://...", "displayedLink": "example.com›path", "snippet": "...", "page": 2 }
  ]
}

字段	说明
`organicResults`	页面上的文档。`position` 跨页累计，因此第 2 页的第一篇文档是 `16`。每行都带有它所在的 `page`。
`notice`	Naver 将结果隐藏在年龄验证之后时出现：`{ "type": "age_verification_required", "scope": "organicResults", "message" }`。能读取到 Naver 的提示时，`message` 原样引用它。

已完成任务中的 organicResults 为空，表示 Naver 本身没有返回文档。

读取 naver.com 页面

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "NAVER_SERP", "payload": { "action": "page", "url": "https://blog.naver.com/example/223000000000", "maxChars": 10000 } }'

字段	必填	说明
`action`	是	`page`。
`url`	是	`naver.com` 或其子域名上的 `https` 地址。其他地址返回 `422 VALIDATION_ERROR`。
`maxChars`	否	`text` 的上限，1,000 到 50,000 的整数，默认 20,000。

例如：

{
  "type": "blog",
  "url": "https://blog.naver.com/example/223000000000",
  "title": "...",
  "text": "...",
  "author": "...",
  "publishedAt": "...",
  "images": ["https://..."],
  "truncated": false
}

字段	说明
`type`	`blog`、`cafe`、`news`、`terms`、`kin` 或 `generic`。
`title`、`text`	页面的标题和正文文本。
`author`、`publishedAt`、`cafeName`	页面提供时返回。
`images`	正文中最多 30 个图片地址。
`truncated`	`text` 在 `maxChars` 处被截断时为 `true`。

以下情况会使任务以 PAGE_UNAVAILABLE 失败并附带原因：跳转离开 naver.com、页面不存在（404 或 410）、仅会员可读的 Cafe 文章，以及没有可读正文的页面。

限制与错误

NAVER_SERP 忽略 markdown、rawResponse 和 searchQueries。它以 422 拒绝 html 和 analysis，以 400 拒绝 citationAnalysis；见不支持的标志。
其他请求错误见错误。

相关内容

Naver AI 简报：也会返回摘要下方的网页文档
Naver AI 标签页
地区与位置