Guia rápido da API de dados de busca com IA

Crie uma chave, envie uma pergunta e receba a resposta por consulta ou webhook.

Envie uma tarefa

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer vt_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026" },
    "webhook": { "url": "https://yours.app/hooks/querying" }
  }'

Seu webhook recebe

{
  "task": {
    "id": "8f2c1e40-…",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-07-17T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "The best wireless earbuds in 2026 are …",
    "sources": [
      { "position": 1,
        "url": "https://example.com/review",
        "label": "Best earbuds, reviewed" }
    ],
    "timing": { "totalMs": 7400 }
  }
}

1. Preparar a chave de API

Crie uma conta gratuita e gere uma chave no painel. Salve-a na variável de ambiente do servidor QUERYING_API_KEY e use-a no servidor. Novas contas recebem 500 créditos antes de adicionar uma forma de pagamento.

2. Enviar uma pergunta

O comando envia uma pergunta ao Gemini com BR como país. O texto mantém o idioma em que você o escreveu. Use o task.id da resposta de aceitação na próxima etapa.

cURL

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "melhores fones sem fio para o trajeto",
    "country": "BR"
  }
}'

3. Obter o resultado concluído

Troque TASK_ID pelo ID recebido. Em QUEUED ou PROCESSING, consulte novamente após uma pausa. Em COMPLETED, leia response; em FAILED, trate o erro. Obtenha e guarde o resultado dentro de 24 horas após a conclusão.

cURL

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

4. Receber resultados por webhook

Adicione webhook.url ao JSON e prepare um receptor HTTPS com a verificação de assinatura documentada. São até 5 tentativas: o envio inicial e 4 novas tentativas com espera progressiva. Elimine entregas duplicadas usando task.id.

JSON

{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "melhores fones sem fio para o trajeto",
    "country": "BR"
  },
  "webhook": {
    "url": "https://your-server.example.com/querying-webhook"
  }
}

5. Adicionar motores e medições periódicas

Confira taskType, prompt ou query, países aceitos e estrutura de resposta de cada motor. Resolva limites de saldo ou concorrência antes de tentar novamente. Salve um conjunto fixo de perguntas em Monitors para acompanhar a visibilidade da marca.

Feito para esses times

Uma fonte de dados estruturada para equipes que analisam a busca com IA.

Monitoramento GEO e AEO

Acompanhe como os mecanismos de busca com IA mencionam sua marca, produtos e concorrentes, por motor, país e prompt.

Saiba mais

Inteligência competitiva

Veja quais marcas os motores de IA citam e quais produtos recomendam no seu mercado.

Saiba mais

Dashboards para agências

Monitore dezenas de clientes simultaneamente com APIs batch e webhooks, cruzando motores e regiões.

Saiba mais

Pesquisa e análise

Estude o comportamento de busca com IA em diferentes mercados com dados estruturados para pesquisa acadêmica, estratégia de conteúdo e SEO.

Saiba mais

Todos os casos de uso →

Recursos relacionados

Comece com 500 créditos grátis

Execute sua primeira tarefa no Playground ou chame a API com sua chave.

Comece grátis Ver preços