DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Keyword-Übersicht
Alles, was Labs über eine Liste von keywords weiß, in einem Aufruf: Volumen, Schwierigkeit, Intent, Wettbewerb und die ausgelösten SERP-Features. Gibt se_type, location_code, language_code, items_count und items zurück. 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. Beginnen Sie hier, wenn Sie Keywords haben; post_dataforseo_labs_google_keyword_ideas_live ist der Weg, wenn Sie mehr davon brauchen.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.0254.
- 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)[]
- 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_keyword_info,keyword_info_normalized_with_clickstreamundkeyword_info_normalized_with_bingin der Antwort
Standardwert:false
bei aktiviertem Parameter wird der doppelte Preis für die Anfrage berechnetWeitere Informationen zur Berechnung clickstream-basierter Metriken finden Sie in diesem Help-Center-Artikel
- includeTyp: boolean | null
_serp _info Daten aus der SERP für jedes Keyword einschließen
Optionales Feld
beitruegeben wir ein Arrayserp_infomit SERP-Daten (Anzahl der Suchergebnisse, relevante URL und SERP-Features) für jedes Keyword in der Antwort zurück
Standardwert:false - keywordsTyp: array string[]
Keywords
Pflichtfeld
Maximale Anzahl der Keywords, die Sie angeben können: 700
Maximale Zeichenzahl je Keyword: 80
Maximale Wortzahl je Keyword-Phrase: 10
die angegebenen Keywords werden in Kleinbuchstaben umgewandelt, die Daten werden in einem separaten Array bereitgestelltHinweis: Wenn einige der in diesem Array angegebenen Keywords in den erhaltenen Ergebnissen fehlen, enthält unsere Datenbank diese Keywords nicht und kann keine Daten dazu liefern
für die in den Ergebnissen fehlenden Keywords wird Ihnen nichts berechnetWeitere Informationen zu Regeln und Einschränkungen der Felder
keywordundkeywordsin DataForSEO-APIs 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
- Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo200
- 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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
- 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 Keywords und zugehörige Daten
- avgTyp: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info Backlink-Daten für das zurückgegebene Keyword
dieses Objekt liefert die durchschnittliche Anzahl von Backlinks, verweisenden Seiten und Domains sowie die durchschnittlichen Rangwerte unter den Top-10-Websites, die für das Keyword organisch ranken- backlinksTyp: number | null
durchschnittliche Anzahl von Backlinks
- dofollowTyp: number | null
durchschnittliche Anzahl von Dofollow-Links
- lastTyp: string | null
_updated _time Datum und Uhrzeit der Aktualisierung der Keyword-Daten
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-11-15 12:57:46 +00:00 - mainTyp: number | null
_domain _rank - rankTyp: number | null
- referringTyp: number | null
_domains durchschnittliche Anzahl verweisender Domains
- referringTyp: number | null
_main _domains durchschnittliche Anzahl verweisender Hauptdomains
- referringTyp: number | null
_pages durchschnittliche Anzahl verweisender Seiten
- seTyp: string | null
_type Typ der Suchmaschine
- clickstreamTyp: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info Clickstream-Daten für das zurückgegebene Keyword
um Ergebnisse für dieses Feld abzurufen, muss der Parameterinclude_clickstream_dataauftruegesetzt sein- ageTyp: object | null
_distribution - propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- genderTyp: object | null
_distribution - propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- lastTyp: string | null
_updated _time Datum und Uhrzeit der Aktualisierung der Keyword-Daten
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-11-15 12:57:46 +00:00 - monthlyTyp: array (object | null)[] | null
_searches monatliche Suchanfragen
stellt die (ungefähre) Anzahl der Suchanfragen zu dieser Keyword-Idee dar (für die letzten zwölf Monate verfügbar), ausgerichtet auf die angegebenen geografischen Standorte- monthTyp: integer | null
Monat
- searchTyp: integer | null
_volume durchschnittliche monatliche Suchvolumenrate
- yearTyp: integer | null
Jahr
- searchTyp: integer | null Format: int64
_volume durchschnittliches monatliches Suchvolumen
stellt die (ungefähre) Anzahl der Suchanfragen für die jeweilige Keyword-Idee auf google.com dar
- keywordTyp: string | null
Keyword
das Keyword wird mit dekodiertem %## zurückgegeben (das Pluszeichen '+' wird zu einem Leerzeichen dekodiert) - keywordTyp: object | null · Response36Afe1097B20_KeywordInfo
_info Keyword-Daten für das zurückgegebene Keyword
- categoriesTyp: array integer[] | null
- competitionTyp: number | null
Wettbewerb
gibt die relative Wettbewerbsintensität für das jeweilige Keyword an. Der Wert basiert auf Google Ads-Daten und kann zwischen 0 und 1 (einschließlich) liegen - competitionTyp: string | null
_level - cpcTyp: number | null
Kosten pro Klick
gibt die durchschnittlichen Kosten pro Klick (USD) an, die für das Keyword historisch bezahlt wurden - highTyp: number | null
_top _of _page _bid maximales Gebot, damit die Anzeige oben auf der ersten Seite erscheint
gibt den Wert an, der über etwa 80 % der niedrigsten Gebote liegt, für die Anzeigen ausgeliefert wurden (basierend auf Google Ads-Statistiken für Werbetreibende)
der Wert kann je nach dem in einer POST-Anfrage angegebenen Standort abweichen - lastTyp: string | null
_updated _time Datum und Uhrzeit der Aktualisierung der Keyword-Daten
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-11-15 12:57:46 +00:00 - lowTyp: number | null
_top _of _page _bid minimales Gebot, damit die Anzeige oben auf der ersten Seite erscheint
gibt den Wert an, der über etwa 20 % der niedrigsten Gebote liegt, für die Anzeigen ausgeliefert wurden (basierend auf Google Ads-Statistiken für Werbetreibende)
der Wert kann je nach dem in einer POST-Anfrage angegebenen Standort abweichen - monthlyTyp: array (object | null)[] | null
_searches monatliche Suchanfragen
stellt die (ungefähre) Anzahl der Suchanfragen zu dieser Keyword-Idee dar (für die letzten zwölf Monate verfügbar), ausgerichtet auf die angegebenen geografischen Standorte- monthTyp: integer | null
Monat
- searchTyp: integer | null
_volume durchschnittliche monatliche Suchvolumenrate
- yearTyp: integer | null
Jahr
- seTyp: string | null
_type Typ der Suchmaschine
- searchTyp: integer | null Format: int64
_volume durchschnittliches monatliches Suchvolumen
stellt die (ungefähre) Anzahl der Suchanfragen für die jeweilige Keyword-Idee auf google.com dar - searchTyp: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend Veränderungen des Suchvolumentrends
gibt die prozentuale Veränderung des Suchvolumens gegenüber dem vorherigen Zeitraum an- monthlyTyp: integer | null
prozentuale Veränderung des Suchvolumens gegenüber dem Vormonat
- quarterlyTyp: integer | null
prozentuale Veränderung des Suchvolumens gegenüber dem Vorquartal
- yearlyTyp: integer | null
prozentuale Veränderung des Suchvolumens gegenüber dem Vorjahr
- keywordTyp: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing enthält das mit dem Bing-Suchvolumen normalisierte Keyword-Suchvolumen
- isTyp: boolean | null
_normalized Keyword-Informationen sind normalisiert bei true werden die Werte mit Bing-Daten normalisiert
- lastTyp: string | null
_updated _time Datum und Uhrzeit der Aktualisierung des Datensatzes im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“ Beispiel: 2019-11-15 12:57:46 +00:00
- monthlyTyp: array (object | null)[] | null
_searches monatliche Suchvolumenraten Array von Objekten mit Suchvolumenraten in einem bestimmten Monat eines Jahres
- monthTyp: integer | null
Monat
- searchTyp: integer | null
_volume durchschnittliche monatliche Suchvolumenrate
- yearTyp: integer | null
Jahr
- searchTyp: integer | null
_volume aktuelle Suchvolumenrate eines Keywords
- keywordTyp: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream enthält das mit Clickstream-Daten normalisierte Keyword-Suchvolumen
- isTyp: boolean | null
_normalized Keyword-Informationen sind normalisiert bei true werden die Werte mit Bing-Daten normalisiert
- lastTyp: string | null
_updated _time Datum und Uhrzeit der Aktualisierung des Datensatzes im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“ Beispiel: 2019-11-15 12:57:46 +00:00
- monthlyTyp: array (object | null)[] | null
_searches monatliche Suchvolumenraten Array von Objekten mit Suchvolumenraten in einem bestimmten Monat eines Jahres
- monthTyp: integer | null
Monat
- searchTyp: integer | null
_volume durchschnittliche monatliche Suchvolumenrate
- yearTyp: integer | null
Jahr
- searchTyp: integer | null
_volume aktuelle Suchvolumenrate eines Keywords
- keywordTyp: object | null · Response36Afe1097B20_KeywordProperties
_properties zusätzliche Informationen zum Keyword
- coreTyp: string | null
_keyword Haupt-Keyword in einer Gruppe
enthält das Haupt-Keyword einer Gruppe, die durch den Synonym-Clustering-Algorithmus bestimmt wurde
ist der Wertnull, enthält unsere Datenbank keine Keywords, die der entsprechende Algorithmus als synonym mitkeyworderkennen konnte - detectedTyp: string | null
_language erkannte Sprache des Keywords
gibt die von unserem System erkannte Sprache des Keywords an - isTyp: boolean | null
_another _language die erkannte Sprache des Keywords weicht von der festgelegten Sprache ab
beitruestimmt die in der Anfrage festgelegte Sprache nicht mit der von unserem System für ein Keyword bestimmten Sprache überein - keywordTyp: integer | null
_difficulty Schwierigkeit des Rankings unter den ersten 10 organischen Ergebnissen für ein Keyword
gibt die Chance an, unter die ersten 10 organischen Ergebnisse für ein Keyword zu gelangen, auf einer logarithmischen Skala von 0 bis 100;
berechnet unter anderem durch Analyse der Linkprofile der ersten 10 Seiten in SERP;
mehr über die Metrik erfahren Sie in diesem Help-Center-Leitfaden - seTyp: string | null
_type Typ der Suchmaschine
- synonymTyp: string | null
_clustering _algorithm der Algorithmus zur Identifizierung von Synonymen
mögliche Werte:keyword_metrics- gibt den Algorithmus auf Basis der Parameter vonkeyword_infoantext_processing- gibt den textbasierten Algorithmus an
ist der Wertnull, enthält unsere Datenbank keine Keywords, die der entsprechende Algorithmus als synonym mitkeyworderkennen konnte - wordsTyp: integer | null Format: int64
_count Anzahl der Wörter im Keyword
gibt an, aus wie vielen Wörtern das Keyword besteht
- 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
- searchTyp: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignTyp: array (string | null)[] | null
_intent ergänzende Suchintentionen
mögliche Werte:informational,navigational,commercial,transactional - lastTyp: string | null
_updated _time Datum und Uhrzeit der Aktualisierung der Keyword-Daten
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-11-15 12:57:46 +00:00 - mainTyp: string | null
_intent Hauptsuchintention
mögliche Werte:informational,navigational,commercial,transactional - seTyp: string | null
_type Typ der Suchmaschine
- searchTyp: boolean | null
_partners gibt Daten für Google und Partnerseiten an
beitruewerden die Ergebnisse für eigene, betriebene und syndizierte Netzwerke über Google und Partnerseiten zurückgegeben, die die Google-Suche hosten;
beifalsewerden die Ergebnisse nur für Google-Suchseiten zurückgegeben - serpTyp: object | null · Response36Afe1097B20_SerpInfo
_info SERP-Daten
der Wert istnull, wenn Sie das Feldinclude_serp_infoim POST-Array nicht auftruegesetzt haben oder wenn für dieses Keyword keine SERP-Daten in unserer Datenbank vorliegen- checkTyp: string | null
_url direkte URL zu den Suchmaschinenergebnissen
Sie können sie verwenden, um sicherzustellen, dass wir genaue Ergebnisse geliefert haben - lastTyp: string | null
_updated _time Datum und Uhrzeit der Aktualisierung der Keyword-Daten
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-11-15 12:57:46 +00:00 - previousTyp: string | null
_updated _time vorletzter Zeitpunkt der Aktualisierung der SERP-Daten
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:2019-10-15 12:57:46 +00:00 - seTyp: integer | null Format: int64
_results _count Anzahl der Suchergebnisse für das zurückgegebene Keyword
- seTyp: string | null
_type Typ der Suchmaschine
- serpTyp: array (string | null)[] | null
_item _types Arten von Suchergebnissen in der SERP
enthält die in der SERP gefundenen Arten von Suchergebnissen (items)
mögliche Elementtypen:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
Hinweis: Die tatsächlichen Ergebnisse werden nur für die Elementeorganic,paid,featured_snippetundlocal_packzurückgegeben
- 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
- 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/keyword_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
}
]'
{
"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,
"location_code": null,
"language_code": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}