응답 옵션: Markdown, 원본 응답, include 플래그

payload.include는 태스크 응답에 선택 필드를 더합니다. 플래그는 모두 boolean이며, 엔진마다 일부만 적용됩니다.

{
  "taskType": "PERPLEXITY",
  "payload": {
    "prompt": "best CRM for a small team",
    "country": "US",
    "include": { "markdown": true, "rawResponse": true }
  }
}

플래그

플래그	더하는 것
`markdown`	답변의 Markdown. `markdown`에 담깁니다(`GOOGLE`과 `BING_SEARCH`는 `aioverview.markdown`).
`rawResponse`	엔진의 원본 출력. `rawResponse` 또는 `rawContent`로 옵니다(아래 참고).
`searchQueries`	엔진이 실행한 검색어. `searchQueries`에 담깁니다.
`ads`, `shopping`	광고와 상품 카드. `CHATGPT`만 해당합니다.
`html`	엔진이 보여 준 화면. HTML 페이지를 참고하세요.
`analysis`	브랜드, 추천, 감성, 출처 종류. 답변 분석을 참고하세요.
`entityDetails`	답변의 카드마다 상세 창. 무료이며 `CHATGPT`만 해당합니다. ChatGPT를 참고하세요.
`citationAnalysis`	답변의 Citation Analysis. 아래를 참고하세요.

지원 매트릭스

✓ 적용, always 플래그 없이도 항상 반환, — 효과 없음(무시), ✗ 거절.

taskType	`markdown`	`rawResponse`	`searchQueries`	`html`	`analysis`	`citationAnalysis`
`CHATGPT`	✓ (기본 켜짐)	✓	✓ (기본 켜짐)	✓	✓	✓
`GEMINI`	✓	✓	—	✓	✓	✓
`PERPLEXITY`	✓	✓	✓	✓	✓	✓
`GOOGLE`	✓	✓ `rawContent`	—	✓	✓	✓
`AIMODE`	always	✓ `rawContent`	—	✓	✓	✓
`BING_COPILOT`	✓	✓	always	✗	✗	✓
`NAVER_AI_BRIEF`	always	✓ `rawContent`	—	✗	✓	✓
`NAVER_AI_TAB`	always	✓ `rawContent`	—	✗	✓	✓
`META_AI`	always	✓	always	✓	✗	✗
`QWEN`	always	✓	always	✗	✗	✗
`DOUBAO`	always	✓	always	✗	✗	✗
`GOOGLE_SERP`	—	✓ `rawContent`	—	✗	✗	✗
`BING_SEARCH`	✓	✓ `rawContent`	—	✗	✗	✓
`NAVER_SERP`, `COMMERCE_SERP`, `COMMERCE_PRODUCT`, `REDDIT`, `WEB_SCRAPE`, `WEB_MAP`, `WEB_CRAWL`, `KEYWORD_VOLUME`	—	—	—	✗	✗	✗

ads와 shopping은 CHATGPT에서만 동작하며 기본으로 켜져 있습니다. 다른 엔진은 모두 무시합니다. searchQueries가 “always”이면 플래그와 관계없이 엔진이 그 필드를 반환한다는 뜻입니다.

플래그 없이 받는 Markdown

AIMODE, NAVER_AI_BRIEF, NAVER_AI_TAB, META_AI, QWEN, DOUBAO는 모든 답변에 markdown을 반환합니다. 이 엔진들에서 Markdown은 text의 사본이 아니라 제목, 목록, 표, 카드가 제자리에 있는 답변의 실제 형태입니다. CHATGPT도 기본으로 반환하며, 빼려면 "markdown": false를 보내세요. GOOGLE은 예전 플래그인 include.aioverview.markdown도 받으며, include.markdown과 같게 동작합니다.

원본 응답

rawResponse는 CHATGPT를 포함한 모든 엔진에서 기본으로 꺼져 있습니다. 원본 출력은 두 필드 중 하나로 옵니다.

rawResponse: 파싱된 스트림 이벤트의 배열(CHATGPT, GEMINI, PERPLEXITY, BING_COPILOT, META_AI, QWEN, DOUBAO).
rawContent: 문자열. GOOGLE, AIMODE, GOOGLE_SERP, BING_SEARCH는 렌더링된 결과 페이지 HTML 전체이고, NAVER_AI_BRIEF와 NAVER_AI_TAB은 네이버의 원본 이벤트 스트림입니다.

이 필드는 수백 KB에 이를 수 있으므로 필요할 때만 요청하세요.

지원하지 않는 플래그

플래그에 따라 동작이 다릅니다.

플래그	지원하지 않는 엔진에서
`markdown`, `rawResponse`, `searchQueries`, `ads`, `shopping`	조용히 무시합니다. 오류도 필드도 없습니다.
`html`	`422 EVIDENCE_UNSUPPORTED`.
`analysis`	`payload.include.analysis`에 대한 `422 VALIDATION_ERROR`.
`citationAnalysis`	`payload.include.citationAnalysis`에 대한 `400 VALIDATION_ERROR`.
`entityDetails`	`payload.include.entityDetails`에 대한 `422 VALIDATION_ERROR`.
`screenshot`	모든 엔진에서 `400 VALIDATION_ERROR`. 더 이상 제공하지 않으므로 `html`을 쓰세요.

html, screenshot, citationAnalysis는 boolean이어야 하고(아니면 400 VALIDATION_ERROR), analysis도 마찬가지입니다(422 VALIDATION_ERROR). 모든 거절은 크레딧을 예약하기 전, 제출 시점에 일어납니다.

Citation Analysis

include.citationAnalysis: true를 보내면 답변이 완료된 뒤 그 답변에 대한 Citation Analysis를 시작합니다. 별도로 과금되는 태스크이며, 답변의 webhook은 분석을 기다렸다가 보내고, 조회 결과는 response.citationAnalysis 아래에 분석을 담습니다. CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, BING_SEARCH, BING_COPILOT, NAVER_AI_BRIEF, NAVER_AI_TAB에서 동작합니다. API 키에 CITATION_ANALYSIS 제출 권한도 있어야 합니다(없으면 403). 결과와 가격은 Citation Analysis를 참고하세요.

시작하기

핵심 개념

답변 엔진

검색과 웹 데이터

요청 옵션

리서치

GEO 모니터링

계정과 데이터

응답 옵션: Markdown, 원본 응답, include 플래그

플래그

지원 매트릭스

플래그 없이 받는 Markdown

원본 응답

지원하지 않는 플래그

Citation Analysis

관련 문서

​플래그

​지원 매트릭스

​플래그 없이 받는 Markdown

​원본 응답

​지원하지 않는 플래그

​Citation Analysis

​관련 문서

플래그

지원 매트릭스

플래그 없이 받는 Markdown

원본 응답

지원하지 않는 플래그

Citation Analysis

관련 문서