Cada fonte do Gemini chega com seu nível de confiança

Capture o que o app do Gemini responde a qualquer prompt no seu mercado, com as fontes da web que sustentam a resposta e um nível de confiança para cada uma.

O que você recebe

• text: a resposta completa do Gemini, com markdown quando você pedir.
• sources: as páginas da web em que o Gemini apoia a resposta, com URL e título.
• confidence_level em cada fonte: a força com que o Gemini liga aquela fonte à resposta, para você ponderar as citações.

Como funciona

Cada tarefa faz a sua pergunta ao app do Gemini para consumidores a partir do país definido e devolve a resposta que seus clientes veem lá. O Gemini combina o que sabe com o que encontra na web, e a lista de fontes mostra exatamente quais páginas sustentam a resposta.

Envie ao Gemini os mesmos prompts que você manda ao ChatGPT e ao Perplexity para comparar quais marcas cada mecanismo recomenda e em quais páginas cada um confia.

Onde ajuda

• Acompanhe como o Gemini descreve a sua marca e os seus concorrentes.
• Pondere as citações pela confiança para encontrar as fontes de maior peso na sua categoria.
• Compare o Gemini com os outros mecanismos em um mesmo conjunto de prompts.

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": "GEMINI",
    "payload": {
      "prompt": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

Campos da requisição

taskTypestringObrigatório

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

payload.promptstringObrigatório

A pergunta, escrita como o usuário digita no chat. Até 100.000 caracteres.

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

Um lugar dentro de country, como uma estação, um bairro ou um endereço, com até 200 caracteres. O motor responde como a um usuário que está ali. Para CHATGPT, GEMINI, GOOGLE, AIMODE e GOOGLE_SERP.

payload.include.markdownboolean

Com true, chega também markdown: a resposta com títulos, listas, tabelas e links.

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": "40b806b8-c057-4003-934e-98ab5fef2cef",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.665Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "markdown": "Here are 3 top wireless earbuds for commuting:\n\n* **[Bose QuietComfort Ultra Wireless Noise Cancelling Earbuds](…)**: The best choice for commuting, offering unmatched noise cancellation to block …\n…",
    "sources": [
      {
        "position": 3,
        "url": "https://google.com/search?q=EarFun+Air+Pro+4+Wireless+In-ear+headphones&…"
      },
      {
        "position": 5,
        "url": "https://google.com/search?q=Anker+Soundcore+Liberty+5+True+Wireless+Bluetooth+Earbuds&…"
      }
    ]
  }
}

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 a formatação: títulos, listas, tabelas e links.

response.sourcesarray

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

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 Gemini concluída usa 1 crédito.