Recevez les réponses conversationnelles de Google AI Mode
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.
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.
JSON
{
"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 statusQUEUED. 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.
Recherchez sur YouTube, Instagram et Threads et recevez vidéos, publications, commentaires, profils et sous-titres YouTube en JSON depuis n’importe quelle clé API, pour 0,5 crédit par requête terminée.
Donnez la recherche web à votre agent en un seul appel : chaque résultat arrive avec les passages de sa page qui répondent à la requête, pour 0,5 crédit la recherche.