Google AI 개요 API: 개요 텍스트, 출처, SERP

GOOGLE은 google.com을 검색하고 AI 개요를 그것이 실린 검색 결과 페이지와 함께 반환합니다.


taskType	`GOOGLE`
별칭	`GOOGLE_AIO`
읽는 필드	`query` (없으면 `prompt`)
크레딧	1.25
국가	선택, 기본값 `US`. `CN`은 베이징에 있는 기기에서 Google 미국 시장에 묻습니다.
위치	`payload.location`을 받습니다. 지역과 위치를 참고하세요.

요청

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE", "payload": { "query": "best CRM for a small team", "country": "US" } }'

응답

응답은 AI 개요를 nullable 멤버 하나(aioverview)로 담은 검색 결과 봉투입니다.

aioverview: null은 해당 검색어에 Google이 AI 개요를 보여주지 않았다는 뜻입니다. 오류가 아니며, 태스크는 완료되고 주변 결과 필드는 그대로 채워집니다.

필드	타입	설명
`aioverview`	object 또는 `null`	AI 개요. 필드는 아래에 있습니다.
`organicResults`	array	자연 검색 결과.
`peopleAlsoAsk`	array	”People also ask”(관련 질문) 패널.
`relatedSearches`	array	관련 검색어.
`knowledgeGraph`	object	지식 패널.
`ads`	array	상단과 하단 광고.
`map`	array	로컬 팩: `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews`, `category`, `price`, `snippet`, `image`.
`serp`	object	기타 패널: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`.
`rawContent`	string	렌더링된 결과 페이지 HTML. `include.rawResponse`일 때만.
`text`, `sources`		`aioverview.text`와 `aioverview.sources`의 지원 중단 사본. 새 코드에서는 `aioverview.*`를 읽으세요.

결과 패널은 페이지에 없으면 null이나 []로 보내지 않고 생략합니다. 모든 패널을 선택 필드로 다루세요.

`aioverview`

필드	타입	설명
`text`	string	개요 텍스트. 상품 카드 제목도 들어 있습니다.
`sources`	array	`position`, `url`, `label`, `description`.
`markdown`	string	Markdown 개요. `include.markdown` 또는 `include.aioverview.markdown`일 때만.
`shoppingCards`	array	답변 옆의 상품 타일: `title`, `position`, `price`, `oldPrice`, `store`, `rating`, `reviews`, `thumbnail`, `productLink`.
`inlineProducts`	array	답변 안에 링크된 상품 이름: `title`, `position`, `productLink`.
`citationPills`	array	인용 칩마다 그 뒤의 출처를 출처 하나당 한 항목으로.
`videos`	array	개요에 나온 동영상: `title`, `link`, `platform`, `channel`, `duration`.
`sponsored`	array	개요 안의 스폰서 항목: `label`, `title`, `advertiser`.

상품, 칩, 동영상, 스폰서 필드는 개요에 나올 때만 실립니다. price.currency는 화면에 보인 기호($, €) 그대로이고, reviews는 Google의 축약 표기(2.3K)를 유지하며, productLink는 Google 상품 페이지입니다. citationPills에서 같은 칩의 출처는 답변 순서대로 매긴 citationPillId를 공유하고, position은 해당하는 aioverview.sources 항목을 가리킵니다. 칩만 인용한 페이지도 개요가 보여 준 출처 뒤로 aioverview.sources에 들어 있고, Google이 제목을 보여 주지 않으면 label이 빈 문자열입니다. 각 항목에는 label, url, domain과, Google이 보여 줄 때 site, description, thumbnail이 있습니다. 응답에 markdown이 있으면 markdownOffset이 그 안에서 칩의 위치를 알려 주며, sponsored 항목에도 같은 방식으로 labelOffset, markdownOffset, noteOffset이 붙습니다. 예시:

{
  "aioverview": {
    "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
    "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }],
    "citationPills": [
      { "label": "CRM guide for small teams", "citationPillId": 1, "url": "https://www.example.com/crm-guide", "domain": "example.com", "position": 1 }
    ]
  },
  "organicResults": [
    { "position": 1, "title": "The best CRM for small teams", "link": "https://www.example.com/crm-guide", "snippet": "..." }
  ],
  "relatedSearches": [{ "query": "free crm for small team" }],
  "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }]
}

include 플래그

플래그	효과
`markdown`	`aioverview.markdown`을 추가합니다. `include.aioverview.markdown`도 같습니다.
`rawResponse`	렌더링된 결과 페이지인 `rawContent`를 추가합니다.
`html`	결과 페이지를 공유 가능한 파일로 담은 `html`을 추가합니다. HTML 페이지를 참고하세요.
`analysis`	`analysis`를 추가합니다. 1크레딧. 답변 분석을 참고하세요.
`citationAnalysis`	개요에 Citation Analysis를 실행합니다.

searchQueries, ads, shopping은 효과가 없습니다. Markdown과 원본 응답을 참고하세요. 개요 없이 자연 검색 결과만 더 빠르게 1크레딧에 받으려면 Google 검색을 쓰세요.

중국

Google은 중국 시장에 AI 개요를 보여주지 않습니다. 그래서 CN 태스크는 중국 본토 사용자가 Google에 접속하는 방식대로, 베이징에 있는 기기에서 Google 미국 시장(gl=us)에 묻습니다. 태스크에 payload.location이 있으면 그 위치를 대신 씁니다.

시작하기

핵심 개념

답변 엔진

검색과 웹 데이터

요청 옵션

리서치

GEO 모니터링

계정과 데이터

Google AI 개요 API: 개요 텍스트, 출처, SERP

요청

응답

`aioverview`

include 플래그

중국

관련 문서

​요청

​응답

​aioverview

​include 플래그

​중국

​관련 문서

요청

응답

`aioverview`

include 플래그

중국

관련 문서