NAVER AIブリーフィング API: AI要約、出典、ウェブ結果 - querying.ai

NAVER_AI_BRIEF は NAVER で検索し、NAVERの結果ページにあるAI要約ボックスであるAIブリーフィングを、その下に表示されるウェブ文書と一緒に返します。


taskType	`NAVER_AI_BRIEF`
エイリアス	`NAVER`(非推奨)
読むフィールド	`query`(なければ `prompt`)
クレジット	1.25
国	任意、既定は `KR`。

リクエスト

NAVER は韓国の検索エンジンのため、country を省略すると KR になります。下の例では明示的に送っています。

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

レスポンス

フィールド	型	説明
`text`	string	プレーンテキストのブリーフィング。NAVERがブリーフィングを表示しなかった場合は空です。
`markdown`	string	NAVERが書いたままのブリーフィング。見出し、リスト、表を含みます。フラグなしで返ります。
`sources`	array	`position`、`url`、`label`、`description`。
`relatedQuestions`	string[]	NAVERが提案する次の質問。
`images`	array	回答とともに表示された画像: `title`、`url`、`image`、`thumbnail`、`source`、`sourceName`。
`organicResults`	array	ブリーフィングボックスの下のウェブ文書: `position`、`title`、`link`、`displayedLink`、`snippet`、`date`、`page`。
`rawContent`	string	元のイベントストリーム。`include.rawResponse` のときのみ。

markdown では、引用は sources[].position に対応する [n]、画像は ![title](url) として表されます。ブリーフィングは条件付きです。NAVER はすべてのクエリで表示するわけではなく、ブリーフィングがなくてもタスクは完了します。ブリーフィングと文書は別々のNAVERリクエストで取得します。NAVER が文書を見つけなかった場合、organicResults は空ではなく存在しません。どちらかのリクエストを読めなかった場合、タスクは ENGINE_NO_RESULT で失敗します。例:

{
  "text": "Shoes with firm arch support and a stable midsole suit flat feet ...",
  "markdown": "### Choosing shoes for flat feet\n- Firm arch support [1]\n- Stable midsole [2]",
  "sources": [{ "position": 1, "url": "https://blog.naver.com/...", "label": "Running shoes for flat feet", "description": "..." }],
  "relatedQuestions": ["Which brands make stability running shoes?"],
  "organicResults": [
    { "position": 1, "title": "Stability running shoes guide", "link": "https://www.example.com/guide", "displayedLink": "example.com", "snippet": "...", "page": 1 }
  ]
}

includeフラグ

フラグ	効果
`rawResponse`	`rawContent` を追加します。
`analysis`	`analysis` を追加します。1クレジット。回答の分析を参照してください。
`citationAnalysis`	ブリーフィングに対してCitation Analysisを実行します。

markdown にフラグは不要です。searchQueries、ads、shopping は効果がありません。html は 422 EVIDENCE_UNSUPPORTED で拒否されます。Markdownと生のレスポンスを参照してください。

関連ページ