> ## 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 탭에 질문하고 답변을 Markdown으로, 출처, 장소, 상품, 이미지, 동영상과 함께 받습니다.

`NAVER_AI_TAB`은 네이버 검색에 항상 켜져 있는 대화형 답변인 네이버 AI 탭에 묻습니다.

| | |
| - | - |
| taskType | `NAVER_AI_TAB` |
| 별칭 | `NAVER_AI_MODE` |
| 읽는 필드 | `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_TAB", "payload": { "query": "best running shoes for flat feet", "country": "KR" } }'
```

## 응답

| 필드 | 타입 | 설명 |
| - | - | - |
| `text` | string | 답변. |
| `markdown` | string | 네이버의 카드를 제자리에 넣은 답변. 플래그 없이 반환됩니다. |
| `sources` | array | `position`, `url`, `label`, `description`. |
| `map` | array | 장소 질문의 장소: `name`, `position`, `placeId`, `location`, `url`, `mapsUrl`, `reviews`, `category`, `image`. |
| `products` | array | 쇼핑 질문의 상품. |
| `images` | array | 답변과 함께 나온 이미지: `title`, `url`, `image`, `thumbnail`, `source`, `sourceName`. |
| `videos` | array | 답변과 함께 나온 동영상. |
| `rawContent` | string | 원본 이벤트 스트림. `include.rawResponse`일 때만. |

`markdown`에서 인용은 `sources[].position`에 맞춘 `[n]`으로, 이미지는 `![title](url)`로, 장소와 상품 카드는 링크된 줄로 나옵니다.

예시:

```json theme={"theme":"css-variables"}
{
  "text": "For flat feet, look for stability shoes with firm arch support ...",
  "markdown": "For flat feet, look for **stability shoes** with firm arch support [1].",
  "sources": [{ "position": 1, "url": "https://blog.naver.com/...", "label": "Running shoes for flat feet", "description": "..." }]
}
```

네이버가 정책상 답변을 거부하면 태스크는 그 거부 문구와 `type`이 `policy_declined`인 `notice`와 함께 완료됩니다.

## 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-tab)
* [네이버 AI 브리핑](/ko/engines/naver-ai-brief.md)
* [엔진 개요](/ko/engines/overview.md)


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