DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Historische Rangübersicht
Die Rangübersicht einer Domain zu jedem Zeitpunkt der verfügbaren Historie. Dieser Endpunkt hat keinen Limit-Parameter, wird aber pro Aufruf statt pro Element abgerechnet – senden Sie daher die gesamte Liste auf einmal. Eingebettet in das DataForSEO-Envelope: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage liefert weiterhin HTTP 200. Prüfen Sie zuerst get_dataforseo_labs_google_available_history – es nennt die vorhandenen Daten, und ein Datum außerhalb davon liefert nichts statt eines Fehlers. Der aktuelle Snapshot ist post_dataforseo_labs_google_domain_rank_overview_live.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.1356.
- Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.
Nur Referenzmetadaten, kein Kontenangebot und keine garantierte Preis- oder Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.
- Typ: array (object | null)[]
- correlateTyp: boolean | null
Daten mit zuvor erhaltenen Datensätzen korrelieren
Optionales Feld
Standardwert:true
Wenn Sie diesen Parameter verwenden, korreliert unser System die aktuell erhaltenen Daten mit zuvor erhaltenen Datensätzen
dieser Parameter soll Inkonsistenzen abmildern, die durch Änderungen an unserer Datenbank entstehen können
wir empfehlen,correlateimmer auftruezu setzen - dateTyp: string | null
_from Startdatum des Zeitraums
Optionales Feld
Wenn Sie dieses Feld nicht angeben, werden die Daten für die letzten 6 Monate bereitgestellt
minimal möglicher Wert:2020-10-01
Datumsformat:"yyyy-mm-dd" - dateTyp: string | null
_to Enddatum des Zeitraums
Optionales Feld
Wenn Sie dieses Feld nicht angeben, wird standardmäßig das heutige Datum verwendet
Datumsformat:"yyyy-mm-dd"
Beispiel:"2021-04-01" - ignoreTyp: boolean | null
_synonyms sehr ähnliche Keywords ignorieren
Optionales Feld
beitruewerden nur Daten auf Basis von Kern-Keywords zurückgegeben, Daten für alle sehr ähnlichen Keywords werden ausgeschlossen;
Standardwert:false - includeTyp: boolean | null
_clickstream _data Daten aus clickstream-basierten Metriken in das Ergebnis aufnehmen oder ausschließen
Optionales Feld
wenn der Parameter auftruegesetzt ist, erhalten Sie die Felderclickstream_etv,clickstream_gender_distributionundclickstream_age_distributionmit Clickstream-Daten in der Antwort;
Standardwert:false;Hinweis: Historische Clickstream-Daten sind ab 2024/05 (Mai 2024) verfügbar;
bei aktiviertem Parameter wird der doppelte Preis für die Anfrage berechnet;
Weitere Informationen zur Berechnung clickstream-basierter Metriken finden Sie in diesem Help-Center-Artikel - languageTyp: string | null
_code Sprachcode
Pflichtfeld, wenn Sielanguage_namenicht angeben
Hinweis: Sie müssen entwederlanguage_nameoderlanguage_codeangeben
Die Liste der verfügbaren Standorte mitlanguage_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:en - languageTyp: string
_name vollständiger Name der Sprache
Pflichtfeld, wenn Sielanguage_codenicht angeben
Hinweis: Sie müssen entwederlanguage_nameoderlanguage_codeangeben
Die Liste der verfügbaren Standorte mitlanguage_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:English - locationTyp: integer
_code Standortcode
Pflichtfeld, wenn Sielocation_namenicht angeben
Hinweis: Sie müssen entwederlocation_nameoderlocation_codeangeben
Die Liste der verfügbaren Standorte mitlocation_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:2840 - locationTyp: string
_name vollständiger Name des Standorts
Pflichtfeld, wenn Sielocation_codenicht angeben
Hinweis: Sie müssen entwederlocation_nameoderlocation_codeangeben
Die Liste der verfügbaren Standorte mitlocation_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Beispiel:United Kingdom - tagTyp: string | null
Benutzerdefinierte Aufgaben-ID
Optionales Feld
Zeichenlimit: 255
Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
Den angegebenen Werttagfinden Sie imdata-Objekt der Antwort - targetTyp: string
Domain
Pflichtfeld
der Domainname der Zielwebsite
die Domain geben Sie ohnehttps://undwww.an
- Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo200
- 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_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
- 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
- itemsTyp: array (object | null)[] | null
enthält historische Ranking- und Traffic-Daten
- metricsTyp: object | null
Rankingdaten zur angegebenen Domain
- propertyTyp: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamTyp: object | null
_age _distribution - propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- clickstreamTyp: number | null Format: double
_etv geschätztes Traffic-Volumen auf Basis von Clickstream-Daten
berechnet als Produkt aus Click-Through-Rate und Clickstream-Suchvolumenwerten aller Keywords, für die die Domain rankt
um Ergebnisse für dieses Feld zu erhalten, muss der Parameterinclude_clickstream_dataauftruegesetzt sein
mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel - clickstreamTyp: object | null
_gender _distribution - propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countTyp: integer | null Format: int64
Gesamtzahl der organischen SERPs, die die Domain oder Subdomain enthalten
- estimatedTyp: number | null
_paid _traffic _cost geschätzte Kosten der Umwandlung von organischem Suchtraffic in bezahlten
stellt die geschätzten monatlichen Kosten (USD) für Anzeigen für alle Keywords in der Kategorie dar, für die die Domain oder Subdomain rankt
die Metrik wird als Produkt der organischenetv- und der bezahltencpc-Werte berechnet und gibt die Kosten an, das geschätzte monatliche organische Traffic-Volumen über PPC-Werbung in der Google-Suche zu erzielen
mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel - etvTyp: number | null
geschätztes Traffic-Volumen
geschätzter organischer monatlicher Traffic zur Domain oder Subdomain
berechnet als Produkt aus CTR (Click-Through-Rate) und Suchvolumenwerten aller Keywords in der Kategorie, für die die Domain oder Subdomain rankt
mehr über die Berechnung der Metrik erfahren Sie in diesem Help-Center-Artikel - isTyp: integer | null
_down Rang gesunken
gibt an, wie viele gerankte Elemente des angegebenen Ziels gesunken sind - isTyp: integer | null
_lost verlorene gerankte Elemente
gibt an, wie viele gerankte Elemente des angegebenen Ziels zuvor in SERPs erschienen sind, aber bei der letzten Prüfung nicht gefunden wurden - isTyp: integer | null
_new Anzahl neuer gerankter Elemente
gibt an, wie viele neue gerankte Elemente für das angegebene Ziel gefunden wurden - isTyp: integer | null
_up Rang gestiegen
gibt an, wie viele gerankte Elemente des angegebenen Ziels gestiegen sind - posTyp: integer | null
_1 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 1 rangt
- posTyp: integer | null
_11 _20 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 11–20 rangt
- posTyp: integer | null
_2 _3 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 2–3 rangt
- posTyp: integer | null
_21 _30 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 21–30 rangt
- posTyp: integer | null
_31 _40 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 31–40 rangt
- posTyp: integer | null
_4 _10 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 4–10 rangt
- posTyp: integer | null
_41 _50 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 41–50 rangt
- posTyp: integer | null
_51 _60 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 51–60 rangt
- posTyp: integer | null
_61 _70 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 61–70 rangt
- posTyp: integer | null
_71 _80 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 71–80 rangt
- posTyp: integer | null
_81 _90 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 81–90 rangt
- posTyp: integer | null
_91 _100 Anzahl organischer SERPs, in denen die Domain oder Subdomain auf Platz 91–100 rangt
- monthTyp: integer | null
Monat, für den die Daten bereitgestellt werden
- seTyp: string | null
_type Typ der Suchmaschine
- yearTyp: integer | null
Jahr, für das die Daten bereitgestellt werden
- itemsTyp: integer | null Format: int64
_count die Anzahl der im Array
itemszurückgegebenen Ergebnisse - languageTyp: string | null
_code Sprachcode in einem POST-Array
- locationTyp: integer | null
_code Standortcode in einem POST-Array
- seTyp: string | null
_type Typ der Suchmaschine
- targetTyp: string | null
Zieldomain in einem POST-Array
- totalTyp: integer | null Format: int64
_count Gesamtmenge der für Ihre Anfrage relevanten Ergebnisse in unserer Datenbank
- 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/dataforseo_labs/google/historical_rank_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29"
}
]'
{
"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": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"year": null,
"month": null,
"metrics": null
}
]
}
]
}
]
}