Recevez les réponses conversationnelles de Google AI Mode

Posez une question à Google AI Mode depuis le marché de votre choix et recevez sa réponse conversationnelle avec les pages qu’elle cite.

Ce que vous obtenez

• text : la réponse complète d’AI Mode, en général plus longue et plus détaillée qu’un AI Overview.
• sources : les pages citées par la réponse, avec URL et titre.
• Un type de tâche dédié, AIMODE, pour mesurer AI Mode et les AI Overviews comme deux surfaces distinctes.

Fonctionnement

AI Mode est la recherche conversationnelle de Google : une question reçoit une réponse rédigée complète, avec des liens vers les pages qui l’appuient. Chaque tâche pose votre requête à AI Mode depuis le pays choisi et renvoie la réponse et ses sources telles que les voient les gens de ce marché.

AI Mode répond en profondeur aux questions de comparaison et de recommandation, et il nomme les marques qu’il recommande. Suivez-le à côté des AI Overviews pour voir comment une même requête se comporte sur les deux surfaces.

Cas d’usage

• Suivez les requêtes de recommandation et de comparaison où AI Mode nomme des marques.
• Comparez les pages citées par AI Mode avec celles des AI Overviews pour la même requête.

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

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.querystringObligatoire

La requête, rédigée comme un utilisateur la tape dans le champ de recherche.

payload.countrystring

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

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": "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, 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 ses titres, listes et tableaux, dans chaque résultat.

response.sourcesarray

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

response.shoppingCardsarray

Fiches produits affichées avec la réponse : nom, prix, boutique, note et lien.

response.inlineProductsarray

Noms de produits liés dans les phrases de la réponse, avec position et productLink.

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 AI Mode terminée utilise 2 crédits.