DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: erweitertes Yahoo-Organic-SERP
Gibt die Rangfolge der Ergebnisse für ein Keyword bei Yahoo synchron zurück. 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.02.
- 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)[]
- depthTyp: integer | null
Parsingtiefe
optionales Feld
Anzahl der Ergebnisse in der SERP
Standardwert:6
Maximalwert:200
Ihr Konto wird für jede SERP abgerechnet;
Jede Yahoo-SERP kann weniger als 10 Ergebnisse enthalten, daher kann eine Tiefe über dem Standardwert zu zusätzlichen Kosten führen ;
Die Kosten können auf der Seite Preise berechnet werden. - deviceTyp: string | null
Gerätetyp
Optionales Feld
Ergebnisse für einen bestimmten Gerätetyp zurückgeben
mögliche Werte:desktop,mobile
Standardwert:desktop - keywordTyp: string
Keyword
Pflichtfeld
Sie können im Feldkeywordbis zu 700 Zeichen angeben
alle %## werden dekodiert (das Zeichen ‚+‘ wird in ein Leerzeichen dekodiert)
Wenn Sie das Zeichen „%“ in Ihremkeywordverwenden möchten, geben Sie es als „%25“ an;
Wenn Sie das Zeichen „+“ in Ihremkeywordverwenden möchten, geben Sie es als „%2B“ anWeitere Informationen zu Regeln und Einschränkungen der Felder
keywordundkeywordsin DataForSEO-APIs finden Sie in diesem Hilfe-Center-Artikel - languageTyp: string
_code Sprachcode der Suchmaschine
Pflichtfeld, wenn Sielanguage_namenicht angeben
Wenn Sie dieses Feld verwenden, müssen Sielanguage_namenicht angeben
Die Liste der verfügbaren Sprachen der Suchmaschine mit ihremlanguage_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
Beispiel:enn - languageTyp: string
_name Vollständiger Name der Sprache der Suchmaschine
Pflichtfeld, wenn Sielanguage_codenicht angeben
Wenn Sie dieses Feld verwenden, müssen Sielanguage_codenicht angeben
Die Liste der verfügbaren Sprachen der Suchmaschine mit ihremlanguage_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
Beispiel:English - locationTyp: integer
_code Standortcode der Suchmaschine
Pflichtfeld, wenn Sie nicht angebenlocation_nameoderlocation_coordinate
bei Verwendung dieses Feldes müssen Sielocation_nameoderlocation_coordinatenicht angeben
die Liste der verfügbaren Standorte der Suchmaschinen mit ihremlocation_codeerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
Beispiel:2840 - locationTyp: string
_coordinate GPS-Koordinaten eines Standorts
Pflichtfeld, wenn nicht angegebenlocation_nameoderlocation_code
bei Verwendung dieses Feldes ist keine Angabe vonlocation_nameoderlocation_codenötig
der Parameterlocation_coordinatemuss im Format "latitude,longitude,radius" angegeben werden
maximale Anzahl Dezimalstellen für "latitude" und "longitude": 7
Mindestwert für "radius": 199.9 (mm)
Höchstwert für "radius": 199999 (mm)
Beispiel:53.476225,-2.243572,200 - locationTyp: string
_name vollständiger Name des Standorts der Suchmaschine
Pflichtfeld, wenn Sie nicht angebenlocation_codeoderlocation_coordinate
bei Verwendung dieses Feldes müssen Sielocation_codeoderlocation_coordinatenicht angeben
die Liste der verfügbaren Standorte der Suchmaschine mit ihremlocation_nameerhalten Sie durch eine separate Anfrage anhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
Beispiel:London,England,United Kingdom - maxTyp: integer | null
_crawl _pages - osTyp: string | null
Betriebssystem des Geräts
Optionales Feld
wenn Sie im Felddevicedesktopangeben, wählen Sie aus folgenden Werten:windows,macos
Standardwert:windows
wenn Sie im Felddevicemobileangeben, wählen Sie aus folgenden Werten:android,ios
Standardwert:android - seTyp: string | null
_domain Domain der Suchmaschine
optionales Feld
wir wählen die passende Suchmaschinen-Domain automatisch anhand des von Ihnen angegebenen Standorts und der Sprache aus
Sie können in diesem Feld jedoch eine benutzerdefinierte Suchmaschinen-Domain festlegen
Beispiel:au.search.yahoo.com,uk.search.yahoo.com,ca.search.yahoo.com, usw. - searchTyp: string | null
_param zusätzliche Parameter der Suchabfrage
optionales Feld
Die Liste der verfügbaren Parameter und weitere Details finden Sie hier - stopTyp: array (object | null)[] | null
_crawl _on _match Array von Zielen, bei denen das Crawling beendet wird optionales Feld wenn angegeben, enthält die Antwort SERP-Ergebnisse bis einschließlich des angegebenen match_value; Sie können bis zu 10 Zielwerte in diesem Array angeben Beispiel: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] Weitere Informationen zu diesem Parameter finden Sie in unserem Hilfe-Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Ihr Konto wird für jede über die angegebenen Ziele gecrawlte SERP abgerechnet
- matchTyp: string | null
_type Typ der Zielübereinstimmung Pflichtfeld, wenn stop_crawl_on_match angegeben ist; Art der Übereinstimmung für den match_value mögliche Werte: domain, with_subdomains, wildcard
- matchTyp: string | null
_value Ziel-Domain oder Wildcard-Wert Pflichtfeld, wenn stop_crawl_on_match angegeben ist; Geben Sie eine Ziel-Domain oder einen Wildcard-Wert an; Hinweis: Der Domainname muss ohne Anfrageprotokoll angegeben werden; Beispiel: dataforseo.com
- 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 | null
Ziel-Domain, Subdomain oder Webseite, für die Ergebnisse abgerufen werden sollen
optionales Feld
Eine Domain oder Subdomain sollte ohnehttps://undwww.angegeben werden.
Beachten Sie, dass die Ergebnisse vontarget-spezifischen Aufgaben nur SERP-Elemente enthalten, die eineurl-Zeichenfolge enthalten;
Sie können auch das Platzhalterzeichen (‚‘) verwenden, um das Suchmuster in der SERP anzugeben und die Ergebnisse einzugrenzen;
Beispiele:example.com- liefert Ergebnisse für die Startseite der Website mit URLs wiehttps://example.com,https://www.example.com/oderhttps://example.com/;example.com- liefert Ergebnisse für die Domain, einschließlich aller ihrer Seiten;example.com- liefert Ergebnisse für die gesamte Domain, einschließlich aller ihrer Seiten und Subdomains;example.com- liefert Ergebnisse für die Startseite unabhängig von der Subdomain, wiehttps://en.example.com;example.com/example-page- liefert Ergebnisse für die exakte URL;example.com/example-page- liefert Ergebnisse für alle URLs der Domain, die mit der angegebenen Zeichenfolge beginnen - urlTyp: string | null
direkte URL der Suchabfrage
optionales Feld
Sie können eine direkte URL angeben, und wir ordnen sie den erforderlichen Feldern zu. Beachten Sie, dass diese Methode für unsere API am schwierigsten zu verarbeiten ist und Sie außerdem die genaue Sprache und den Standort in der URL angeben müssen. In den meisten Fällen würden wir diese Methode nicht empfehlen.
Beispiel:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8
- Typ: object | null · Response36Afe1097B20_SerpYahooOrganicLiveAdvancedResponseInfo200
- 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_SerpYahooOrganicLiveAdvancedTaskInfo
- 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 - itemsTyp: array (object | null)[] | null
Elemente der in der SERP gefundenen Suchergebnisse
- pageTyp: integer | null
Seitennummer der Suchergebnisse
gibt die Nummer der SERP-Seite an, auf der sich das Element befindet - positionTyp: string | null
die Ausrichtung des Elements in der SERP
mögliche Werte:left,right - 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
- typeTyp: string | null
Elementtyp
- xpathTyp: string | null
der XPath des Elements
- itemsTyp: integer | null Format: int64
_count die Anzahl der im
items-Array zurückgegebenen Ergebnisse - keywordTyp: string | null
in einem POST-Array empfangenes Keyword
das Keyword wird dekodiert zurückgegeben (%##; das Zeichen „+“ wird in ein Leerzeichen dekodiert) - languageTyp: string | null
_code Sprachcode in einem POST-Array
- locationTyp: integer | null
_code Standortcode in einem POST-Array
- pagesTyp: integer | null Format: int64
_count abgerufene Seiten insgesamt
Gesamtzahl der im Ergebnis abgerufenen SERPs - refinementTyp: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips Suchverfeinerungs-Chips
entsprichtnull- 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- 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/yahoo/organic/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"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,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}