DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: Google AI Mode SERP
Gibt Googles AI-Mode-Antwort für eine Abfrage zurück, mit den Quellen, die sie bei Google zitiert, synchron. Gibt keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count und items zurück. advanced ist die Standardwahl; nehmen Sie regular, wenn nur die Rangliste zählt, und html nur, um zu prüfen, was der Parser verworfen hat. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.004.
- Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.
Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.
- Typ: array (object | null)[]
- browserTyp: integer | null
_screen _height Bildschirmhöhe des Browsers
Optionales Feld
Sie können eine benutzerdefinierte Bildschirmhöhe des Browsers festlegen, um Pixel-Rankings für ein bestimmtes Gerät zu berechnen;
kann im folgenden Bereich angegeben werden:
240-9999;standardmäßig ist der Parameter gesetzt auf:
1080fürdesktop;640fürmobileunterandroid;812fürmobileunteriOS;Hinweis: um diesen Parameter zu verwenden, setzen Sie
calculate_rectanglesauftrue - browserTyp: integer | null
_screen _resolution _ratio Bildschirmauflösungsverhältnis des Browsers
Optionales Feld
Sie können ein benutzerdefiniertes Bildschirmauflösungsverhältnis des Browsers festlegen, um Pixel-Rankings für ein bestimmtes Gerät zu berechnen;
kann im folgenden Bereich angegeben werden:
0.5-3;standardmäßig ist der Parameter gesetzt auf:
1fürdesktop;3fürmobileunterandroid;3fürmobileunteriOS;Hinweis: um diesen Parameter zu verwenden, setzen Sie
calculate_rectanglesauftrue - browserTyp: integer | null Format: int64
_screen _width Bildschirmbreite des Browsers
Optionales Feld
Sie können eine benutzerdefinierte Bildschirmbreite des Browsers festlegen, um Pixel-Rankings für ein bestimmtes Gerät zu berechnen;
kann im folgenden Bereich angegeben werden:
240-9999;standardmäßig ist der Parameter gesetzt auf:
1920fürdesktop;360fürmobileunterandroid;375fürmobileunteriOS;Hinweis: um diesen Parameter zu verwenden, setzen Sie
calculate_rectanglesauftrue - calculateTyp: boolean | null
_rectangles Pixel-Rankings für SERP-Elemente in erweiterten Ergebnissen berechnen
Optionales Feld
Das Pixel-Ranking bezeichnet den Abstand zwischen dem Ergebnis-Snippet und der oberen linken Ecke des Bildschirms;
Weitere Informationen im Help Center>>
standardmäßig ist der Parameter auf
falsegesetztHinweis: bei
truewird die Gebühr pro Aufgabe mit 2 multipliziert - deviceTyp: string | null
Gerätetyp
Optionales Feld
Ergebnisse für einen bestimmten Gerätetyp zurückgeben
Kann die Werte annehmen:
desktop,mobileStandardwert:
desktop - keywordTyp: string
Keyword
Pflichtfeld
Sie können im Feld
keywordbis zu 700 Zeichen angebenalle %## werden dekodiert (das Zeichen „+“ wird in ein Leerzeichen dekodiert)
wenn Sie das Zeichen „%“ für Ihr
keywordbenötigen, geben Sie es als „%25“ an;wenn Sie das Zeichen „+“ für Ihr
keywordbenötigen, geben Sie es als „%2B“
weitere Informationen zu den Regeln und Einschränkungen der Felder
keywordundkeywordsin DataForSEO-APIs finden Sie in diesem Help-Center-Artikel - languageTyp: string
_code Sprachcode der Suchmaschine
Pflichtfeld, wenn Sie
language_namenicht angeben;bei Verwendung dieses Feldes müssen Sie
language_namenicht angeben;die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem
language_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/google/ai_mode/languages - languageTyp: string
_name vollständiger Name der Sprache der Suchmaschine
Pflichtfeld, wenn Sie
language_codenicht angeben;bei Verwendung dieses Feldes müssen Sie
language_codenicht angeben;die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem
language_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/google/ai_mode/languages; - locationTyp: integer
_code Standortcode der Suchmaschine
Pflichtfeld, wenn nicht angegeben
location_nameoderlocation_coordinatebei Verwendung dieses Feldes ist keine Angabe von
location_nameoderlocation_coordinatenötigdie Liste der verfügbaren Standorte der Suchmaschinen mit ihrem
location_codeerhalten Sie durch eine separate Anfrage an diehttps://api.dataforseo.com/v3/serp/google/locationsHinweis: In der Google Search Help finden Sie die Liste der Länder, in denen AI Mode derzeit verfügbar ist
- locationTyp: string
_coordinate GPS-Koordinaten eines Standorts
Pflichtfeld, wenn nicht angegeben
location_nameoderlocation_codebei Verwendung dieses Feldes ist keine Angabe von
location_nameoderlocation_codenötigDer Parameter
location_coordinatemuss im Format "latitude,longitude,zoom" angegeben werdenwenn "zoom" nicht angegeben ist, wird 9z als Standardwert verwendet
die maximale Anzahl der Nachkommastellen für "latitude" und "longitude": 7
der Mindestwert für "zoom": 4z
der Höchstwert für "zoom": 18z
Beispiel:
52.6178549,-155.352142,18z - locationTyp: string
_name vollständiger Name des Suchmaschinen-Standorts
Pflichtfeld, wenn nicht angegeben
location_codeoderlocation_coordinatebei Verwendung dieses Feldes ist keine Angabe von
location_codeoderlocation_coordinatenötigdie Liste der verfügbaren Standorte der Suchmaschine mit ihrem
location_nameerhalten Sie durch eine separate Anfrage an diehttps://api.dataforseo.com/v3/serp/google/locationsHinweis: In der Google Search Help finden Sie die Liste der Länder, in denen AI Mode derzeit verfügbar ist
- osTyp: string | null
Betriebssystem des Geräts
Optionales Feld
wenn Sie
desktopim Felddeviceangeben, wählen Sie aus folgenden Werten:windows,macosStandardwert:
windowswenn Sie
mobileim Felddeviceangeben, wählen Sie aus folgenden Werten:android,iosStandardwert:
android - tagTyp: string | null
benutzerdefinierter Aufgabenbezeichner
optionales Feld
Das Zeichenlimit beträgt 255
Sie können diesen Parameter verwenden, um die Aufgabe zu identifizieren und dem Ergebnis zuzuordnen
Den angegebenen
tag-Wert finden Sie imdata-Objekt der Antwort
- Typ: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveAdvancedResponseInfo200
- Typ: number | null Format: doublecost
Gesamtkosten der Aufgaben in USD
- Typ: integer | nullstatus
_code allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier
- Typ: string | nullstatus
_message allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- Typ: array (object | null)[] | nulltasks
Array von Aufgaben
- Typ: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveAdvancedTaskInfo
- costTyp: number | null Format: double
Gesamtkosten der Aufgaben in USD
- dataTyp: object | null
Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben
- propertyTyp: object | null
Name
- idTyp: string | null
Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format
- pathTyp: array (string | null)[] | null
URL-Pfad
- resultTyp: array (object | null)[] | null
Array von Ergebnissen
- checkTyp: string | null
_url direkte URL zu den Suchmaschinenergebnissen
Sie können sie verwenden, um sicherzustellen, dass wir genaue Ergebnisse geliefert haben - datetimeTyp: string | null
Datum und Uhrzeit des Eingangs des Ergebnisses
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-11-15 12:57:46 +00:00 - itemTyp: array (string | null)[] | null
_types Arten von Suchergebnissen in der SERP
enthält die in der SERP gefundenen Arten von Suchergebnissen (items).
mögliche Elementtypen:ai_overview - itemsTyp: array (object | null)[] | null
Einträge des Elements
- itemsTyp: array (object | null)[] | null
im Element vorhandene Einträge
- positionTyp: string | null
die Ausrichtung des Elements in der SERP
mögliche Werte:left,right - typeTyp: string | null
Elementtyp
- markdownTyp: string | null
- pageTyp: integer | null
SERP-Seite
SERP-Seite, auf der das Element rankt - positionTyp: string | null
die Ausrichtung des Elements in der SERP
mögliche Werte:left,right - rankTyp: integer | null
_absolute absolutes Ranking in der SERP
absolute Position unter allen Elementen in der SERP - rankTyp: integer | null
_group Gruppenrang in der SERP
Position innerhalb einer Gruppe von Elementen mit identischentype-Werten
Positionen von Elementen mit anderentype-Werten werden ausrank_groupausgelassen - rectangleTyp: object | null · Response36Afe1097B20_AiModeRectangleInfo
Rechteckparameter
enthält kartesische Koordinaten und Pixeldimensionen des Snippets des Ergebnisses in der SERP
entsprichtnull, wenncalculate_rectanglesin der POST-Anfrage nicht auftruegesetzt ist- heightTyp: number | null Format: double
Höhe des Elements in Pixeln
- widthTyp: number | null Format: double
Breite des Elements in Pixeln
- xTyp: number | null Format: double
x-Achsen-Koordinate die x-Achsen-Koordinate der oberen linken Ecke des Snippets des Ergebnisses, wobei die obere linke Ecke des Bildschirms der Ursprung ist
- yTyp: number | null Format: double
y-Achsen-Koordinate die y-Achsen-Koordinate der oberen linken Ecke des Snippets des Ergebnisses, wobei die obere linke Ecke des Bildschirms der Ursprung ist
- referencesTyp: array (object | null)[] | null
zusätzliche Referenzen zum Eintrag
enthält Referenzen auf Webseiten, die zur Generierung vonai_overviewverwendet worden sein könnten- domainTyp: string | null
Domainname der Referenz
- positionTyp: string | null
die Ausrichtung des Elements in der SERP
mögliche Werte:left,right - sourceTyp: string | null
Name oder Titel der Referenzquelle
- textTyp: string | null
Text der Komponente
- titleTyp: string | null
Anchor-Text des Links
- typeTyp: string | null
Elementtyp
- urlTyp: string | null
Link-URL
- typeTyp: string | null
Elementtyp
- xpathTyp: string | null
- itemsTyp: integer | null Format: int64
_count die Anzahl der im
items-Array zurückgegebenen Ergebnisse - keywordTyp: string | null
Keyword, das in einem POST-Array empfangen wurde
das Keyword wird mit dekodierten %## zurückgegeben (das Pluszeichen '+' wird in ein Leerzeichen dekodiert) - languageTyp: string | null
_code Sprachcode in einem POST-Array
- locationTyp: integer | null
_code Standortcode in einem POST-Array
- refinementTyp: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips Suchverfeinerungs-Chips
in diesem Fall ist der Wertnull- itemsTyp: array (object | null)[] | null
Einträge des Elements
- domainTyp: string | null
Domain in der SERP
- optionsTyp: array (object | null)[] | null
weitere Optionen zur Suchverfeinerung
- domainTyp: string | null
Domain in der SERP
- titleTyp: string | null
Titel des Elements
- typeTyp: string | null
Elementtyp
- urlTyp: string | null
Such-URL mit Verfeinerungsparametern
- titleTyp: string | null
Titel des Elements
- typeTyp: string | null
Elementtyp
- urlTyp: string | null
Such-URL mit Verfeinerungsparametern
- typeTyp: string | null
Elementtyp
- xpathTyp: string | null
der XPath des Elements
- seTyp: string | null
_domain Suchmaschinen-Domain in einem POST-Array
- seTyp: integer | null Format: int64
_results _count Gesamtzahl der Ergebnisse in der SERP
- spellTyp: object | null · Response36Afe1097B20_SpellInfo
Autokorrektur der Suchmaschine
wenn die Suchmaschine Ergebnisse für ein korrigiertes Keyword geliefert hat, geben wir das von der Suchmaschine korrigierte Keyword und die Art der Autokorrektur an;
in diesem Fall ist der Wertnull- keywordTyp: string | null
Keyword, das durch die Autokorrektur der Suchmaschine ermittelt wurde die Ergebnisse werden für das korrigierte Keyword bereitgestellt
- typeTyp: string | null
Art der Autokorrektur mögliche Werte: did_you_mean, showing_results_for, no_results_found_for, including_results_for Hinweis: Yahoo und Yandex unterstützen nur die folgende Autokorrekturart: including_results_for
- typeTyp: string | null
Elementtyp
- resultTyp: integer | null Format: int64
_count Anzahl der Elemente im Ergebnis-Array
- statusTyp: integer | null
_code Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier
- statusTyp: string | null
_message Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- timeTyp: string | null
Ausführungszeit in Sekunden
- Typ: integer | null Format: int64tasks
_count Die Anzahl der Aufgaben im tasks-Array
- Typ: integer | null Format: int64tasks
_error Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden
- Typ: string | nulltime
Gesamtausführungszeit, Sekunden
- Typ: string | nullversion
Die aktuelle Version der API
application/json - 400
Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
- 401
Ein gültiger Felo-API-Schlüssel ist erforderlich.
- 402
Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
- 403
Das Konto ist für diesen Vorgang nicht berechtigt.
- 429
Ein Anfrage- oder Ausgabenlimit wurde erreicht.
- 502
Der Dienst konnte die Anfrage nicht abschließen.
- 503
Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
- 504
Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
- default
Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "what is google ai mode"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"page": null,
"position": null,
"xpath": null,
"markdown": null,
"items": [
"[Max Depth Exceeded]"
],
"references": [
"[Max Depth Exceeded]"
],
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}