Chaque source de Gemini arrive avec son niveau de confiance

Capturez la réponse de l’application Gemini à chaque prompt sur votre marché, avec les sources web qui appuient la réponse et un niveau de confiance pour chacune.

Ce que vous obtenez

• text : la réponse complète de Gemini, avec markdown sur demande.
• sources : les pages web sur lesquelles Gemini appuie sa réponse, avec URL et titre.
• confidence_level sur chaque source : la force du lien que Gemini établit entre cette source et sa réponse, pour pondérer les citations.

Fonctionnement

Chaque tâche pose votre question à l’application Gemini grand public depuis le pays choisi et renvoie la réponse que vos clients y voient. Gemini combine ce qu’il sait avec ce qu’il trouve sur le web, et la liste des sources indique précisément les pages qui appuient la réponse.

Envoyez à Gemini les mêmes prompts qu’à ChatGPT et Perplexity pour comparer les marques que chaque moteur recommande et les pages auxquelles il se fie.

Cas d’usage

• Suivez la façon dont Gemini décrit votre marque et vos concurrents.
• Pondérez les citations par niveau de confiance pour trouver les sources les plus influentes de votre catégorie.
• Comparez Gemini aux autres moteurs sur un même ensemble de prompts.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête 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 }
    }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.promptstringObligatoire

La question, rédigée comme un utilisateur la tape dans le chat. Jusqu’à 100 000 caractères.

payload.countrystring

Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.

payload.locationstring

Un lieu situé dans country, comme une gare, un quartier ou une adresse, jusqu’à 200 caractères. Le moteur répond comme à un utilisateur qui s’y trouve. Pour CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP.

payload.include.markdownboolean

Avec true, la réponse arrive aussi en markdown, avec ses titres, listes, tableaux et liens.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

idempotencyKeystring

Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "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, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.textstring

La réponse en texte brut.

response.markdownstring

La réponse avec sa mise en forme : titres, listes, tableaux et liens.

response.sourcesarray

Les pages citées par la réponse, dans l’ordre du moteur, avec position, url et label.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

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

Tarif

Chaque tâche Gemini terminée utilise 1 crédit.