> ## 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 AIブリーフィング API: AI要約、出典、ウェブ結果

> NAVERで検索し、AIブリーフィングの要約ボックスを、出典、関連する質問、その下のウェブ文書とともに受け取ります。

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

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

## リクエスト

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

```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_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` で失敗します。

例:

```json theme={"theme":"css-variables"}
{
  "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クレジット。[回答の分析](/ja/engines/answer-analysis.md)を参照してください。 |
| `citationAnalysis` | ブリーフィングに対して[Citation Analysis](/ja/research/citation-analysis.md)を実行します。 |

`markdown` にフラグは不要です。`searchQueries`、`ads`、`shopping` は効果がありません。`html` は `422 EVIDENCE_UNSUPPORTED` で拒否されます。[Markdownと生のレスポンス](/ja/engines/response-options.md)を参照してください。

## 関連ページ

* [NAVER AIブリーフィング製品ページ](https://querying.ai/ja/engines/naver-ai-brief)
* [NAVER AIタブ](/ja/engines/naver-ai-tab.md)
* [NAVER検索](/ja/engines/naver-serp.md)
* [エンジンの概要](/ja/engines/overview.md)


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