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

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

> Google을 검색하고 AI 개요를 출처, 상품, 인용 칩과 함께, 그 주변의 검색 결과 페이지까지 받습니다.

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

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

## 요청

```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": "GOOGLE", "payload": { "query": "best CRM for a small team", "country": "US" } }'
```

## 응답

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

> [!WARNING]
>
> `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`이 붙습니다.

예시:

```json theme={"theme":"css-variables"}
{
  "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 페이지](/ko/engines/html-pages.md)를 참고하세요. |
| `analysis` | `analysis`를 추가합니다. 1크레딧. [답변 분석](/ko/engines/answer-analysis.md)을 참고하세요. |
| `citationAnalysis` | 개요에 [Citation Analysis](/ko/research/citation-analysis.md)를 실행합니다. |

`searchQueries`, `ads`, `shopping`은 효과가 없습니다. [Markdown과 원본 응답](/ko/engines/response-options.md)을 참고하세요. 개요 없이 자연 검색 결과만 더 빠르게 1크레딧에 받으려면 [Google 검색](/ko/engines/google-serp.md)을 쓰세요.

## 중국

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

## 관련 문서

* [Google AI 개요 제품 페이지](https://querying.ai/ko/engines/google-ai-overviews)
* [Google AI 모드](/ko/engines/google-ai-mode.md)
* [엔진 개요](/ko/engines/overview.md)


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