> ## 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 のウェブ文書結果を1ページ分取得するか、naver.com のページを1つテキストとして読みます。

`NAVER_SERP` は NAVER のウェブ文書タブの結果を1ページ(1ページ15件)返します。`"action": "page"` を指定すると、naver.com のページ(ブログ記事、カフェ記事、ニュース、知恵袋(Knowledge iN)の回答、その他あらゆる naver.com ページ)を1つ読み、そのテキストを返します。

| | |
| - | - |
| `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` | いいえ | 既定値は NAVER の市場である `KR`。 |

たとえば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" }`。読み取れる場合、`message` は NAVER の文言をそのまま載せます。 |

完了したタスクで `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)、会員しか読めないカフェ記事、読み取れる本文がないページ。

## 制限とエラー

* `NAVER_SERP` は `markdown`、`rawResponse`、`searchQueries` を無視します。`html` と `analysis` は `422`、`citationAnalysis` は `400` で拒否します。[未対応のフラグ](/ja/engines/response-options.md#未対応のフラグ)を参照してください。
* その他のリクエストエラーは[エラー](/ja/concepts/errors.md)に記載しています。

## 関連

* [NAVER AI ブリーフィング](/ja/engines/naver-ai-brief.md): 要約の下の自然検索文書も返します
* [NAVER AI タブ](/ja/engines/naver-ai-tab.md)
* [地域と位置](/ja/engines/capacity.md)


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