Lesen Sie AI Overviews über aioverview.markdown, mit den Überschriften, Listen und Tabellen, die Google anlegt.
Was sich ändert
aioverview.markdown: die AI Overview als Markdown, mit Überschriften, Listen, Tabellen und Fettdruck an ihrem Platz.
aioverview.text bleibt wie bisher und enthält dieselben Wörter, sodass Code, der den reinen Text liest, weiter funktioniert.
Antworten von Google AI Mode enthalten dasselbe Markdown in jedem Ergebnis als markdown.
So funktioniert es
Google gliedert eine AI Overview mit Überschriften, nummerierten Schritten, Aufzählungen und Vergleichstabellen. aioverview.text enthält die Wörter, und aioverview.markdown bewahrt zusätzlich die Gliederung: So zeigen Sie die Übersicht so an, wie Suchende sie sehen, oder lesen ihre Struktur im Code. Die zitierten Seiten bleiben in aioverview.sources.
Aktivieren Sie es mit include.aioverview.markdown: true. Die gemeinsame Option include.markdown: true, die andere Engines bereits lesen, aktiviert es ebenfalls.
Einsatzbereiche
Zeigen Sie AI Overviews in Ihren eigenen Dashboards und Berichten im Originalformat.
Finden Sie heraus, welche Marken Google in den Schritten, Tabellen und Vergleichen einer Übersicht nennt.
Teilen Sie eine Übersicht in ihre Abschnitte und sehen Sie, welche Themen Google zuerst behandelt.
Anfrage senden
Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.
Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.
payload.querystringPflicht
Die Suchanfrage, so formuliert, wie ein Nutzer sie ins Suchfeld tippt.
payload.countrystring
Zweistelliger Ländercode des Markts, aus dem gefragt wird, etwa US, KR oder JP. Standard US.
payload.include.markdownboolean
Mit true kommt aioverview.markdown hinzu: die Übersicht mit Überschriften, Listen und Tabellen, so wie Google sie zeigt.
webhook.urlstring
Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.
Antwort
So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.
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, dann COMPLETED mit der Antwort oder FAILED mit error.
credits.creditsChargedinteger
Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.
response.aioverviewobject
Die AI Overview mit text, sources und auf Wunsch markdown. null kennzeichnet eine Suche, die Google allein mit Suchergebnissen beantwortet.
response.aioverview.markdownstring
Die Overview als Markdown im Aufbau, den Google zeigt: ###-Überschriften, Listen, Tabellen und Fettdruck.
Ergebnis abholen
Die Anfrage liefert sofort die Aufgabe mit statusQUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis statusCOMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.
Durchsuchen Sie YouTube, Instagram und Threads und erhalten Sie Videos, Beiträge, Kommentare, Profile und YouTube-Untertitel als JSON mit jedem API-Schlüssel, für 0,5 Credits pro abgeschlossener Anfrage.
Geben Sie Ihrem Agenten Websuche mit einem Aufruf: Jedes Ergebnis kommt mit den Passagen seiner Seite, die die Anfrage beantworten, für 0,5 Credits pro Suche.