Lisez les AI Overviews dans aioverview.markdown avec les titres, listes et tableaux mis en page par Google.
Ce qui change
aioverview.markdown : l’AI Overview en Markdown, avec ses titres, listes, tableaux et passages en gras à leur place.
aioverview.text reste identique et contient les mêmes mots : le code qui lit le texte brut continue de fonctionner.
Les réponses de Google AI Mode contiennent le même Markdown dans markdown, pour chaque résultat.
Fonctionnement
Google structure un AI Overview avec des titres, des étapes numérotées, des listes et des tableaux comparatifs. aioverview.text garde les mots, et aioverview.markdown conserve aussi la structure : vous affichez l’aperçu tel que le voient les internautes, ou vous lisez sa structure dans votre code. Les pages citées restent dans aioverview.sources.
Activez-le avec include.aioverview.markdown: true. L’option commune include.markdown: true, déjà lue par les autres moteurs, l’active aussi.
Cas d’usage
Affichez les AI Overviews dans vos tableaux de bord et rapports avec leur mise en forme d’origine.
Repérez les marques que Google cite dans les étapes, tableaux et comparaisons d’un aperçu.
Découpez un aperçu en sections pour voir les sujets que Google traite en premier.
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.
payload.include.markdownboolean
Avec true, l’aperçu arrive aussi en aioverview.markdown, avec ses titres, listes et tableaux, tel que Google l’affiche.
webhook.urlstring
Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.
Réponse
Voici une tâche terminée, raccourcie pour la lecture.
JSON
{
"success": true,
"task": {
"id": "8dcde5b1-2f53-40b3-b048-05075b03c4a9",
"taskType": "GOOGLE",
"status": "COMPLETED",
"createdAt": "2026-10-02T17:16:57.237Z"
},
"credits": { "creditsToCharge": 2, "creditsCharged": 2 },
"response": {
"aioverview": {
"text": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.",
"markdown": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.\n\n### Top Robot Vacuums for Pet Hair\n\n**Roborock Saros Z70**\n\nNamed a top overall pick by experts for its strong hard-floor pickup, smart obstacle recognition, and self-emptying dock. It costs around $1,000.\n\n**MOVA V50**\n\nPraised as a top performer in dog hair tests and obstacle avoidance. It features a dual brush roller and app controls for auto-emptying frequency, usually priced under $700.\n\n…",
"sources": [
{
"position": 2,
"url": "https://www.rtings.com/robot-vacuum/reviews/best/pet-hair",
"label": "RTINGS.com"
},
{
"position": 3,
"url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-robot-vacuum-for-pet-hair/",
"label": "Forbes Vetted"
}
]
}
}
}
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.aioverviewobject
L’AI Overview avec son text, ses sources et, sur demande, markdown. null signale une requête à laquelle Google répond par les seuls résultats de recherche.
response.aioverview.markdownstring
L’overview en Markdown, dans la structure affichée par Google : titres ###, listes, tableaux et gras.
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.