문서 / Overview / Response Schema Response Schema 모든 AI 엔진이 돌려주는 Answer 타입: 답변 본문, 인용과 출처, 카드, 언급, 후속 질문.
모든 엔진이 Answer 타입 하나를 돌려줍니다. 필드 하나는 모든 엔진에서 같은 뜻입니다.
선택 필드는 정말로 선택입니다. 없으면 엔진이 말하지 않았다는 뜻입니다. rating이 없는 카드는 별점을 보여 주지
않았습니다. 시각은 ISO 8601, UTC입니다. 금액은 기본 단위(소수 포함)와 ISO 4217 통화 코드로 나타냅니다. 모든 객체에는
ext가 있을 수 있고, 여기에는 그 엔진에만 있는 정보가 들어갑니다.
필드 타입 설명 enginestring chatgpt gemini google-aio google-ai-mode naver-ai-brief naver-ai-taboutcomestring 아래 참고 promptstring 요청한 질문 askedAtstring 질문한 시각 countrystring 질문한 시장(US, KR) languagestring? conversationobject? {id, turn, expiresAt?}. id를 conversation으로 넘기면 이어서 질문합니다titlestring? 엔진이 붙인 대화 제목 blocksBlock[] 순서대로 나열한 답변 블록. 아래 참고 textstring blocks에서 만든 일반 텍스트 답변markdownstring blocks에서 만든 마크다운 답변citationsCitation[] text의 어느 부분이 어느 출처를 인용하는지sourcesSource[] 엔진이 보여 준 모든 출처. 인용 여부와 상관없이 mentionsMention[] 엔진이 직접 표시한 브랜드, 상품, 장소 cardsCard[] 상품, 장소, 동영상, 이미지 카드. 광고 포함 suggestionsarray {text, prompt?}: 엔진이 제안한 후속 질문resultsResult[]? 답변 주변의 검색 결과(Google AI 개요, Naver AI 브리핑) pagestring? include=page일 때: 답변을 담은 독립된 HTML 페이지
값 뜻 answered엔진이 답했습니다 noAnswer이 질문에는 답을 보여 주지 않았습니다. Google은 많은 검색에서 AI 개요를, Naver는 브리핑을 보여 주지 않습니다. 에러가 아니며, 페이지의 나머지(results)는 그대로 돌려줍니다 refused엔진이 답을 거절했습니다. 엔진이 한 말은 text에 있습니다 partial엔진이 중간에 멈췄지만 일부 본문이 왔습니다
text, markdown, blocks는 한 답변의 세 가지 모습이며 항상 일치합니다. 블록은 다음 중 하나입니다.
type필드 headinglevel(1–6), markdownparagraph quotemarkdownlistordered, items: {markdown, depth}[]tableheader: string[], rows: string[][]codelanguage?, textcardscards: 엔진이 답변 중 그 자리에 보여 준 카드의 cards 인덱스rule
필드 타입 설명 start endinteger text의 문자 범위 [start, end)sourcesinteger[] sources의 인덱스
필드 타입 설명 urlstring title site favicon image snippetstring? site는 사이트 표시 이름publishedAtstring? citedboolean 인용이 가리키면 true, 엔진이 읽기만 하고 인용하지 않았으면 false
필드 타입 설명 typestring product place video image othertitle urlstring? image thumbnailstring? 이미지 카드에서는 image가 이미지 자체 width heightinteger? price originalPriceobject? {text, amount?, currency?}. text는 표시된 그대로이고, amount는 금액 하나로 분명할 때만rating reviewsnumber? merchant sitestring? badgesstring[]? 카드에 붙은 라벨, 글자 그대로("Best overall") addressstring? coordinatesobject? {lat, lng}sponsoredboolean 광고. 광고도 카드이며 따로 모으지 않습니다
필드 타입 설명 namestring kindstring brand product place othercategorystring? 엔진이 붙인 라벨, 글자 그대로 atinteger? 엔진이 표시한 text 안의 위치 cardinteger? 엔진이 카드를 보여 줬다면 cards에서의 인덱스
언급은 엔진이 직접 표시한 것뿐입니다. 본문에서 추측하지 않습니다.
답변 주변 검색 결과 하나입니다.
필드 타입 설명 positioninteger 1부터 title urlstring site favicon image snippetstring? publishedAtstring? breadcrumbsstring[]? 페이지가 결과에 표시한 경로 sitelinksarray? {title, url}
같은 Answer가 SERP API 의 Google 검색 결과에 있는 aiOverview
항목의 answer이기도 합니다.
ChatGPT, Gemini, Google AI 개요, Google AI Mode, Naver AI가 질문에 내놓는 답변을 모든 인용, 출처, 상품 카드, 브랜드 언급과 함께 답변 타입 하나로 제공합니다.
ChatGPT의 답변과 인용, 출처, 상품 카드, 브랜드 언급. 대화와 사진을 지원합니다.