> ## 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.

# 네이버 AI 브리핑 API: AI 요약, 출처, 웹문서 결과

> 네이버를 검색하고 AI 브리핑 요약 박스를 출처, 관련 질문, 그 아래의 웹문서와 함께 받습니다.

`NAVER_AI_BRIEF`는 네이버를 검색하고, 네이버 검색 결과 페이지의 AI 요약 박스인 AI 브리핑을 그 아래에 나오는 웹문서와 함께 반환합니다.

| | |
| - | - |
| taskType | `NAVER_AI_BRIEF` |
| 별칭 | `NAVER` (지원 중단) |
| 읽는 필드 | `query` (없으면 `prompt`) |
| 크레딧 | 1.25 |
| 국가 | 선택, 기본값 **`KR`**. |

## 요청

네이버는 한국 검색 엔진이므로 `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 | 일반 텍스트 브리핑. 네이버가 브리핑을 보여주지 않았으면 비어 있습니다. |
| `markdown` | string | 네이버가 쓴 그대로의 브리핑(제목, 목록, 표 포함). 플래그 없이 반환됩니다. |
| `sources` | array | `position`, `url`, `label`, `description`. |
| `relatedQuestions` | string\[] | 네이버가 제안하는 후속 질문. |
| `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)`로 나옵니다.

브리핑은 조건부입니다. 네이버는 모든 검색어에 브리핑을 보여주지 않으며, 브리핑이 없는 태스크도 완료됩니다. 브리핑과 문서는 서로 다른 네이버 요청 두 개에서 옵니다. 네이버가 문서를 찾지 못하면 `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크레딧. [답변 분석](/ko/engines/answer-analysis.md)을 참고하세요. |
| `citationAnalysis` | 브리핑에 [Citation Analysis](/ko/research/citation-analysis.md)를 실행합니다. |

`markdown`은 플래그가 필요 없습니다. `searchQueries`, `ads`, `shopping`은 효과가 없습니다. `html`은 `422 EVIDENCE_UNSUPPORTED`로 거절됩니다. [Markdown과 원본 응답](/ko/engines/response-options.md)을 참고하세요.

## 관련 문서

* [네이버 AI 브리핑 제품 페이지](https://querying.ai/ko/engines/naver-ai-brief)
* [네이버 AI 탭](/ko/engines/naver-ai-tab.md)
* [네이버 검색](/ko/engines/naver-serp.md)
* [엔진 개요](/ko/engines/overview.md)


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