> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Naver 搜索结果 API（NAVER_SERP）

> 获取某个查询的一页 Naver 网页文档结果，或以文本读取一个 naver.com 页面。

`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`）。 |

## 搜索

```bash theme={"theme":"css-variables"}
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 页：

```json theme={"theme":"css-variables"}
{
  "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 页面

```bash theme={"theme":"css-variables"}
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。 |

例如：

```json theme={"theme":"css-variables"}
{
  "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`；见[不支持的标志](/zh/engines/response-options.md#不支持的标志)。
* 其他请求错误见[错误](/zh/concepts/errors.md)。

## 相关内容

* [Naver AI 简报](/zh/engines/naver-ai-brief.md)：也会返回摘要下方的网页文档
* [Naver AI 标签页](/zh/engines/naver-ai-tab.md)
* [地区与位置](/zh/engines/capacity.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.