API do Google AI Overviews: texto da visão geral, fontes e SERP

GOOGLE busca no google.com e retorna o AI Overview junto com a página de resultados de busca em que ele aparece.


taskType	`GOOGLE`
Aliases	`GOOGLE_AIO`
Lê	`query` (recorre a `prompt`)
Créditos	1,25
País	Opcional, padrão `US`. `CN` consulta o mercado dos EUA do Google a partir de um dispositivo em Pequim.
Localização	Aceita `payload.location`. Veja Regiões e localização.

Requisição

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" } }'

Resposta

A resposta é um envelope de resultados de busca que traz o AI Overview como um membro anulável, aioverview.

aioverview: null significa que o Google não exibiu um AI Overview para a consulta. Não é erro: a tarefa é concluída, e os campos de resultados ao redor continuam preenchidos.

Campo	Tipo	Descrição
`aioverview`	object ou `null`	O AI Overview. Campos abaixo.
`organicResults`	array	Resultados orgânicos.
`peopleAlsoAsk`	array	O painel “As pessoas também perguntam”.
`relatedSearches`	array	Buscas relacionadas.
`knowledgeGraph`	object	O painel de conhecimento.
`ads`	array	Anúncios do topo e do rodapé.
`map`	array	O pacote local: `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews`, `category`, `price`, `snippet`, `image`.
`serp`	object	Outros painéis: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`.
`rawContent`	string	O HTML renderizado da página de resultados. Só com `include.rawResponse`.
`text`, `sources`		Cópias obsoletas de `aioverview.text` e `aioverview.sources`. Em código novo, leia `aioverview.*`.

Os painéis de resultados são omitidos quando a página não os tem, nunca enviados como null ou []. Trate cada um como opcional.

`aioverview`

Campo	Tipo	Descrição
`text`	string	O texto da visão geral. Os títulos dos cartões de produto ficam nele.
`sources`	array	`position`, `url`, `label` e `description`.
`markdown`	string	A visão geral em Markdown. Só com `include.markdown` ou `include.aioverview.markdown`.
`shoppingCards`	array	Blocos de produto ao lado da resposta: `title`, `position`, `price`, `oldPrice`, `store`, `rating`, `reviews`, `thumbnail`, `productLink`.
`inlineProducts`	array	Nomes de produto com link na resposta: `title`, `position`, `productLink`.
`citationPills`	array	Uma entrada por fonte por trás de cada chip de citação.
`videos`	array	Vídeos que a visão geral mostra: `title`, `link`, `platform`, `channel`, `duration`.
`sponsored`	array	Itens patrocinados dentro da visão geral: `label`, `title`, `advertiser`.

Os campos de produto, chip, vídeo e patrocínio só aparecem quando a visão geral os mostra. price.currency é o símbolo como exibido ($, €), reviews mantém a abreviação do Google (2.3K) e productLink é a página de produto do Google. Em citationPills, as fontes do mesmo chip compartilham um citationPillId, numerado na ordem da resposta, e position aponta para a entrada correspondente de aioverview.sources. Uma página citada só por um chip também está em aioverview.sources, depois das páginas que a visão geral lista, e seu label fica vazio quando o Google não mostra um título. Cada entrada tem label, url, domain e, quando o Google os mostra, site, description e thumbnail. Quando a resposta traz markdown, markdownOffset indica o lugar do chip nele; as entradas de sponsored trazem labelOffset, markdownOffset e noteOffset do mesmo jeito. Por exemplo:

{
  "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" }]
}

Flags include

Flag	Efeito
`markdown`	Adiciona `aioverview.markdown`. `include.aioverview.markdown` faz o mesmo.
`rawResponse`	Adiciona `rawContent`, a página de resultados renderizada.
`html`	Adiciona `html`, a página de resultados como um arquivo compartilhável. Veja Páginas HTML.
`analysis`	Adiciona `analysis`, 1 crédito. Veja Análise da resposta.
`citationAnalysis`	Executa uma Citation Analysis sobre a visão geral.

searchQueries, ads e shopping não têm efeito. Veja Markdown e respostas brutas. Para resultados orgânicos sem a visão geral, mais rápido e por 1 crédito, use o Google Search.

China

O Google não mostra AI Overview no mercado da China. Por isso, uma tarefa CN consulta o mercado dos EUA do Google (gl=us) a partir de um dispositivo localizado em Pequim, como as pessoas na China continental acessam o Google. Uma tarefa com sua própria payload.location usa essa localização.

Primeiros passos

Conceitos principais

Mecanismos de resposta

Busca e dados da web

Opções de requisição

Pesquisa

Monitoramento GEO

Conta e dados

API do Google AI Overviews: texto da visão geral, fontes e SERP

Requisição

Resposta

`aioverview`

Flags include

China

Relacionados

​Requisição

​Resposta

​aioverview

​Flags include

​China

​Relacionados

Requisição

Resposta

`aioverview`

Flags include

China

Relacionados