Google-AI-Overviews-API: Übersichtstext, Quellen und SERP

GOOGLE durchsucht google.com und liefert die AI Overview zusammen mit der Suchergebnisseite, auf der sie steht.


taskType	`GOOGLE`
Aliase	`GOOGLE_AIO`
Liest	`query` (greift auf `prompt` zurück)
Credits	1,25
Land	Optional, Standard `US`. `CN` fragt Googles US-Markt von einem Gerät in Peking.
Standort	Akzeptiert `payload.location`. Siehe Regionen und Standort.

Anfrage

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE", "payload": { "query": "best CRM for a small team", "country": "US" } }'

Antwort

Die Antwort ist ein Suchergebnis-Umschlag, der die AI Overview als ein nullbares Element enthält: aioverview.

aioverview: null bedeutet, dass Google für diese Anfrage keine AI Overview angezeigt hat. Das ist kein Fehler: Der Task wird abgeschlossen, und die Ergebnisfelder darum herum sind weiterhin befüllt.

Feld	Typ	Beschreibung
`aioverview`	object oder `null`	Die AI Overview. Felder unten.
`organicResults`	array	Organische Ergebnisse.
`peopleAlsoAsk`	array	Das Panel „Ähnliche Fragen“.
`relatedSearches`	array	Verwandte Suchen.
`knowledgeGraph`	object	Das Knowledge Panel.
`ads`	array	Anzeigen oben und unten.
`map`	array	Das Local Pack: `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews`, `category`, `price`, `snippet`, `image`.
`serp`	object	Weitere Panels: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`.
`rawContent`	string	Das HTML der gerenderten Ergebnisseite. Nur mit `include.rawResponse`.
`text`, `sources`		Veraltete Kopien von `aioverview.text` und `aioverview.sources`. Lesen Sie in neuem Code `aioverview.*`.

Ergebnis-Panels werden weggelassen, wenn die Seite keine hat, nie als null oder [] gesendet. Behandeln Sie jedes als optional.

`aioverview`

Feld	Typ	Beschreibung
`text`	string	Der Übersichtstext. Titel von Produktkarten bleiben darin erhalten.
`sources`	array	`position`, `url`, `label` und `description`.
`markdown`	string	Die Übersicht als Markdown. Nur mit `include.markdown` oder `include.aioverview.markdown`.
`shoppingCards`	array	Produktkacheln neben der Antwort: `title`, `position`, `price`, `oldPrice`, `store`, `rating`, `reviews`, `thumbnail`, `productLink`.
`inlineProducts`	array	In der Antwort verlinkte Produktnamen: `title`, `position`, `productLink`.
`citationPills`	array	Ein Eintrag pro Quelle hinter jedem Zitat-Chip.
`videos`	array	Videos, die die Übersicht zeigt: `title`, `link`, `platform`, `channel`, `duration`.
`sponsored`	array	Gesponserte Einträge in der Übersicht: `label`, `title`, `advertiser`.

Produkt-, Chip-, Video- und Sponsored-Felder erscheinen nur, wenn die Übersicht sie zeigt. price.currency ist das angezeigte Symbol ($, €), reviews behält Googles Abkürzung (2.3K), und productLink ist Googles Produktseite. In citationPills teilen sich Quellen im selben Chip eine citationPillId, nummeriert in der Reihenfolge der Antwort, und position verweist auf den passenden Eintrag in aioverview.sources. Eine Seite, die nur ein Chip zitiert, steht ebenfalls in aioverview.sources, hinter den Seiten, die die Übersicht aufführt; zeigt Google keinen Titel, ist ihr label leer. Jeder Eintrag hat label, url, domain und, wenn Google sie zeigt, site, description und thumbnail. Enthält die Antwort markdown, gibt markdownOffset die Stelle des Chips darin an; sponsored-Einträge tragen auf dieselbe Weise labelOffset, markdownOffset und noteOffset. Zum Beispiel:

{
  "aioverview": {
    "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
    "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }],
    "citationPills": [
      { "label": "CRM guide for small teams", "citationPillId": 1, "url": "https://www.example.com/crm-guide", "domain": "example.com", "position": 1 }
    ]
  },
  "organicResults": [
    { "position": 1, "title": "The best CRM for small teams", "link": "https://www.example.com/crm-guide", "snippet": "..." }
  ],
  "relatedSearches": [{ "query": "free crm for small team" }],
  "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }]
}

Include-Flags

Flag	Wirkung
`markdown`	Fügt `aioverview.markdown` hinzu. `include.aioverview.markdown` bewirkt dasselbe.
`rawResponse`	Fügt `rawContent` hinzu, die gerenderte Ergebnisseite.
`html`	Fügt `html` hinzu, die Ergebnisseite als teilbare Datei. Siehe HTML-Seiten.
`analysis`	Fügt `analysis` hinzu, 1 Credit. Siehe Antwortanalyse.
`citationAnalysis`	Führt eine Citation Analysis der Übersicht aus.

searchQueries, ads und shopping haben keine Wirkung. Siehe Markdown und Rohantworten. Für organische Ergebnisse ohne Übersicht, schneller und für 1 Credit, nutzen Sie die Google-Suche.

China

Google zeigt dem chinesischen Markt keine AI Overview. Ein CN-Task fragt daher Googles US-Markt (gl=us) von einem Gerät mit Standort Peking, so wie Menschen auf dem Festland Google erreichen. Ein Task mit eigenem payload.location verwendet stattdessen diesen Standort.

Erste Schritte

Grundlagen

Antwort-Engines

Suche und Webdaten

Anfrageoptionen

Recherche

GEO-Monitoring

Konto und Daten

Google-AI-Overviews-API: Übersichtstext, Quellen und SERP

Anfrage

Antwort

`aioverview`

Include-Flags

China

Verwandte Seiten

​Anfrage

​Antwort

​aioverview

​Include-Flags

​China

​Verwandte Seiten

Anfrage

Antwort

`aioverview`

Include-Flags

China

Verwandte Seiten