Os AI Overviews do Google já estão disponíveis

Envie uma busca e receba o AI Overview do Google com as páginas citadas, junto com os resultados orgânicos, as perguntas relacionadas e as buscas relacionadas da mesma página.

O que você recebe

• aioverview.text e aioverview.sources: o AI Overview e as páginas que ele cita.
• organicResults: os resultados normais da mesma página, com posição, título, link e trecho.
• peopleAlsoAsk, relatedSearches, knowledgeGraph e ads sempre que o Google os mostra.

Como funciona

Cada tarefa faz a sua busca no Google a partir do país definido e lê a página de resultados inteira. O Google decide a cada busca se mostra um AI Overview, e cada resultado concluído registra se ele apareceu: vem em aioverview, que fica null numa página só com resultados orgânicos.

Esse registro vira uma métrica. Num conjunto de palavras-chave, a parcela de buscas com AI Overview é a sua cobertura, e os próprios overviews mostram quais marcas e páginas o Google coloca em destaque.

Onde ajuda

• Meça quantas das suas palavras-chave ativam um AI Overview, mercado por mercado.
• Veja se as suas páginas são citadas no overview ou aparecem nos resultados orgânicos abaixo dele.
• Encontre novos prompts para acompanhar nas perguntas e buscas relacionadas.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho Authorization.

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 wireless earbuds for commuting",
      "country": "US"
    }
  }'

Campos da requisição

taskTypestringObrigatório

O motor que executa a tarefa, como CHATGPT ou GOOGLE.

payload.querystringObrigatório

A busca, escrita como o usuário digita na caixa de pesquisa.

payload.countrystring

Código de país de duas letras do mercado de onde a pergunta parte, como US, KR ou JP. Padrão US.

payload.include.markdownboolean

Com true, chega também aioverview.markdown: a visão geral com títulos, listas e tabelas, como o Google a mostra.

webhook.urlstring

Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

idempotencyKeystring

Seu próprio ID para a requisição. Cada chave cria uma única tarefa por conta, então um reenvio continua sendo uma tarefa.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

{
  "success": true,
  "task": {
    "id": "310ab45d-209e-4a15-8379-9379ab041d48",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:53:21.022Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Anker Soundcore Space A40 is the best wireless earbud for commuting due to its strong adaptive noise cancellation, long battery life, and compact value.",
      "sources": [
        {
          "position": 1,
          "url": "https://www.soundcore.com/products/space-a40-a3936011",
          "label": "Anker Soundcore Space A40"
        },
        {
          "position": 2,
          "url": "https://www.techtimes.com/articles/313618/20260101/best-wireless-bluetooth-earbuds-under-100-are-they-really-worth-price.htm",
          "label": "Tech Times"
        }
      ],
      "shoppingCards": [
        {
          "position": 1,
          "title": "Anker Soundcore Space A40",
          "price": { "raw": "$54.99", "value": 54.99, "currency": "$" },
          "store": "soundcore US",
          "rating": 4.4,
          "reviews": "1.2K"
        }
      ]
    },
    "organicResults": [
      {
        "position": 1,
        "title": "Highest Rated Wireless Earbuds",
        "link": "https://www.amazon.com/Highest-Rated-Wireless-Earbuds/s?k=Highest+Rated+Wireless+Earbuds",
        "snippet": "Soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, Water-Resistant, 2 Mics for AI Clear Calls, ..."
      }
    ],
    "peopleAlsoAsk": [
      { "question": "What are the best wireless earbuds for office work?" }
    ],
    "relatedSearches": [
      { "query": "Best wireless earbuds for commuting reddit" },
      { "query": "Best wireless earbuds for commuting iphone" }
    ]
  }
}

task.statusstring

QUEUED, PROCESSING e, no fim, COMPLETED com a resposta ou FAILED com error.

credits.creditsChargedinteger

Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.

response.aioverviewobject

A AI Overview com text, sources e, quando pedido, markdown. null marca uma busca que o Google responde somente com resultados.

response.aioverview.shoppingCardsarray

Cartões de produto da overview: nome, preço, loja, avaliação, avaliações e link.

response.organicResultsarray

Os resultados de busca da página: position, title, link, snippet e page.

response.peopleAlsoAskarray

As perguntas relacionadas que o Google mostra na página.

response.relatedSearchesarray

As buscas relacionadas no fim da página.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Preço

Cada tarefa concluída usa 2 créditos.