Receba os AI Overviews do Google em Markdown

Leia AI Overviews em aioverview.markdown com os títulos, listas e tabelas que o Google organiza.

O que muda

• aioverview.markdown: o AI Overview em Markdown, com títulos, listas, tabelas e negrito no lugar.
• aioverview.text continua igual e traz as mesmas palavras, então o código que lê o texto simples segue funcionando.
• As respostas do Google AI Mode trazem o mesmo Markdown em markdown em cada resultado.

Como funciona

O Google organiza um AI Overview com títulos, passos numerados, listas e tabelas comparativas. aioverview.text guarda as palavras, e aioverview.markdown preserva também a estrutura, então você mostra o resumo como quem pesquisa o vê ou lê a estrutura no código. As páginas citadas continuam em aioverview.sources.

Ative com include.aioverview.markdown: true. A opção comum include.markdown: true, que outros mecanismos já leem, também ativa.

Onde ajuda

• Mostre AI Overviews nos seus painéis e relatórios com a formatação original.
• Descubra quais marcas o Google inclui nos passos, tabelas e comparações de um resumo.
• Divida um resumo nas suas seções para ver quais temas o Google aborda primeiro.

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 robot vacuum for pet hair",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

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.

Resposta

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

{
  "success": true,
  "task": {
    "id": "8dcde5b1-2f53-40b3-b048-05075b03c4a9",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.237Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.",
      "markdown": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.\n\n### Top Robot Vacuums for Pet Hair\n\n**Roborock Saros Z70**\n\nNamed a top overall pick by experts for its strong hard-floor pickup, smart obstacle recognition, and self-emptying dock. It costs around $1,000.\n\n**MOVA V50**\n\nPraised as a top performer in dog hair tests and obstacle avoidance. It features a dual brush roller and app controls for auto-emptying frequency, usually priced under $700.\n\n…",
      "sources": [
        {
          "position": 2,
          "url": "https://www.rtings.com/robot-vacuum/reviews/best/pet-hair",
          "label": "RTINGS.com"
        },
        {
          "position": 3,
          "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-robot-vacuum-for-pet-hair/",
          "label": "Forbes Vetted"
        }
      ]
    }
  }
}

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

A overview em Markdown, na estrutura que o Google mostra: títulos ###, listas, tabelas e negrito.

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

O preço continua em 2 créditos por tarefa concluída, com o Markdown incluído.