Receba as respostas conversacionais do Google AI Mode

Pergunte ao Google AI Mode a partir do mercado que você escolher e receba a resposta conversacional com as páginas que ela cita.

O que você recebe

• text: a resposta completa do AI Mode, em geral mais longa e detalhada que um AI Overview.
• sources: as páginas que a resposta cita, com URL e título.
• Um tipo de tarefa próprio, AIMODE, para medir o AI Mode e os AI Overviews como superfícies separadas.

Como funciona

O AI Mode é a busca conversacional do Google: uma pergunta recebe uma resposta escrita completa, com links para as páginas por trás dela. Cada tarefa faz a sua busca no AI Mode a partir do país definido e devolve a resposta e as fontes como as pessoas desse mercado as veem.

O AI Mode responde a fundo perguntas de comparação e recomendação e cita pelo nome as marcas que recomenda. Acompanhe-o ao lado dos AI Overviews para ver como a mesma busca se comporta nas duas superfícies.

Onde ajuda

• Acompanhe as buscas de recomendação e comparação em que o AI Mode cita marcas.
• Compare as páginas citadas pelo AI Mode com as dos AI Overviews para a mesma busca.

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": "AIMODE",
    "payload": {
      "query": "best robot vacuum for pet hair",
      "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.

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": "937d9eb6-4b33-49fd-b164-df8e2911b964",
    "taskType": "AIMODE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.384Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "markdown": "The **Dreame X50 Ultra** is the overall **best robot vacuum for pet hair**, offering a massive **20,000Pa of suction** and an anti-tangle dual-brush system specifically designed to prevent pet hair wrap.\n\nWhen shopping for a pet hair-focused robot vacuum, comparing suction power, brush design, and price helps identify the right model for your home and budget.\n\n| Model | Key Pet Hair Features | Approx. Price | Best For |\n| --- | --- | --- | --- |\n| **Dreame X50 Ultra** | 20,000Pa suction, Detangling DuoBrush | ~$900 | Heavy shedding & thick carpets |\n| **Roborock Saros Z70** | 5-axis mechanical arm, ultra-thin 7.98 cm body | ~$1,000 | Moving pet toys & low furniture |\n…",
    "shoppingCards": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "price": { "raw": "$899.99", "value": 899.99, "currency": "$" },
        "store": "Dreametech",
        "rating": 4.5,
        "reviews": "538"
      }
    ],
    "inlineProducts": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "productLink": "https://www.google.com/search?ibp=oshop&prds=pvt:hg,…"
      }
    ]
  }
}

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

A resposta em texto puro.

response.markdownstring

A resposta com títulos, listas e tabelas, em todo resultado.

response.sourcesarray

As páginas que a resposta cita, na ordem do motor, com position, url e label.

response.shoppingCardsarray

Cartões de produto exibidos com a resposta: nome, preço, loja, avaliação e link.

response.inlineProductsarray

Nomes de produto com link dentro das frases da resposta, com position e productLink.

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 do AI Mode concluída usa 2 créditos.