NAVER 検索結果 API (NAVER_SERP) - querying.ai

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

検索

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ページ目:

{
  "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 のページを読む

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

制限とエラー

NAVER_SERP は markdown、rawResponse、searchQueries を無視します。html と analysis は 422、citationAnalysis は 400 で拒否します。未対応のフラグを参照してください。
その他のリクエストエラーはエラーに記載しています。

関連

NAVER AI ブリーフィング: 要約の下の自然検索文書も返します
NAVER AI タブ
地域と位置