Google-Organic-SERP-Aufgaben einstellen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google-Organic-SERP-Aufgaben einstellen
Stellt die Rangfolge der Ergebnisse für ein Keyword bei Google in die Warteschlange und gibt eine Aufgaben-id in tasks[0].id zurück. 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. Der Live-Zwilling antwortet sofort und ist für eine einzelne Abfrage einfacher; nutzen Sie die Warteschlange, wenn der Stapel einen Tool-Aufruf überdauern würde.
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)[]
- 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
Pixel-Ranking bezeichnet den Abstand zwischen dem Ergebnis-Snippet und der oberen linken Ecke des Bildschirms;
standardmäßig ist der Parameter auf
falsegesetztHinweis: Für die Verwendung dieses Parameters werden zusätzlich $0.0006 berechnet
- depthTyp: integer | null
Parsing-Tiefe
Optionales Feld
Anzahl der Ergebnisse in der SERP
Standardwert:
10Höchstwert:
700
Ihr Konto wird pro SERP mit bis zu 10 Ergebnissen abgerechnet;Eine Tiefe über 10 kann zu zusätzlichen Kosten führen, wenn die Suchmaschine mehr als 10 Ergebnisse zurückgibt;
Die Kosten können auf der Seite Pricing berechnet werden.
- deviceTyp: string | null
Gerätetyp
Optionales Feld
Ergebnisse für einen bestimmten Gerätetyp zurückgeben
Kann die Werte annehmen:
desktop,mobileStandardwert:
desktop - expandTyp: boolean | null
_ai _overview AI Overview erweitern
Optionales Feld
auf
truesetzen, um das Elementai_overviewzu erweitern;Standardwert:
false;Hinweis: Dieser Parameter gilt nur für HTML-Aufgabenergebnisse
- findTyp: array string[] | null
_targets _in SERP-Elementtypen, die auf Ziele geprüft werden
Optionales Feld
Um diesen Parameter zu aktivieren, muss auch
stop_crawl_on_matchaktiviert seinLegt fest, welche SERP-Elementtypen auf Zielübereinstimmungen geprüft werden sollen
wenn nicht angegeben, werden alle Elemente der ersten Ebene mit den Feldern
urlunddomainauf Ziele geprüftMögliche Werte:
organic,paid,local_pack,featured_snippet,events,google_flights,images,jobs,knowledge_graph,local_service,map,scholarly_articles,third_party_reviews,twitterHinweis: darf nicht dieselben Elementtypen wie
ignore_targets_inenthaltenBeispiel:
"find_targets_in": ["organic", "featured_snippet"]Mehr über diesen Parameter erfahren Sie in unserem Help Center
- groupTyp: boolean | null
_organic _results verwandte Ergebnisse anzeigen
Optionales Feld
bei Einstellung auf
truewird das Elementrelated_resultin der Antwort als Snippet des übergeordneten organischen Ergebnisses bereitgestellt;bei Einstellung auf
falsewird das Elementrelated_resultals separates organisches Ergebnis bereitgestellt;Standardwert:
true - ignoreTyp: array string[] | null
_targets _in SERP-Elementtypen, die von der Zielsuche ausgeschlossen werden
Optionales Feld
Um diesen Parameter zu aktivieren, muss auch
stop_crawl_on_matchaktiviert seinLegt fest, welche SERP-Elementtypen bei der Suche nach Zielübereinstimmungen ausgeschlossen werden sollen
Mögliche Werte:
organic,paid,local_pack,featured_snippet,events,google_flights,images,jobs,knowledge_graph,local_service,map,scholarly_articles,third_party_reviews,twitterHinweis: darf nicht dieselben Elementtypen wie
find_targets_inenthaltenBeispiel:
"ignore_targets_in": ["paid", "images"]Mehr über diesen Parameter erfahren Sie in unserem Help Center
- keywordTyp: string
keyword
Pflichtfeld
im Feld
keywordkönnen Sie bis zu 700 Zeichen angebenalle %## werden dekodiert (das Zeichen ‘+’ wird zudem 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” an;Wenn dieses Feld Parameter wie ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, wird die Berechnung pro Aufgabe mit 5 multipliziert
Mehr über Regeln und Einschränkungen der Felder
keywordundkeywordsin DataForSEO-APIs erfahren Sie in diesem Help-Center-Artikel - languageTyp: string
_code Sprachcode der Suchmaschine
Pflichtfeld, wenn nicht angegeben
language_namebei Verwendung dieses Feldes ist keine Angabe von
language_namenötigdie Liste der verfügbaren Sprachen der Suchmaschine mit ihrem
language_codeerhalten Sie durch eine separate Anfrage an diehttps://api.dataforseo.com/v3/serp/google/languagesBeispiel:
en - languageTyp: string
_name vollständiger Name der Suchmaschinensprache
Pflichtfeld, wenn nicht angegeben
language_codebei Verwendung dieses Feldes ist keine Angabe von
language_codenötigdie Liste der verfügbaren Sprachen der Suchmaschine mit ihrem
language_nameerhalten Sie durch eine separate Anfrage an diehttps://api.dataforseo.com/v3/serp/google/languagesBeispiel:
English - loadTyp: boolean | null
_async _ai _overview Asynchrones AI Overview laden
Optionales Feld
auf
truesetzen, umai_overview-Elemente in SERPs zu erhalten, auch wenn sie asynchron geladen werden;bei Einstellung auf
falseerhalten Sieai_overview-Elemente nur aus dem Cache;Standardwert:
falseHinweis: Für die Verwendung dieses Parameters werden zusätzlich $0.0006 berechnet;
wenn das Element fehlt oder
"asynchronous_ai_overview": falseenthält, werden alle zusätzlichen Kosten Ihrem Kontostand zurückerstattet - 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/locationsBeispiel:
2840 - 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,radius" angegeben werdendie maximale Anzahl der Nachkommastellen für "latitude" und "longitude": 7
der Mindestwert für "radius": 199 (mm)
der Höchstwert für "radius": 199999 (mm)
Beispiel:
53.476225,-2.243572,200 - 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/locationsBeispiel:
London,England,United Kingdom - matchTyp: string
_type Typ des Zielabgleichs
Pflichtfeld, wenn
stop_crawl_on_matchangegeben istTyp der Übereinstimmung für den
match_valueMögliche Werte:
domain– bestimmte Domain oder Subdomainwith_subdomains– Hauptdomain und Subdomainswildcard– Wildcard-Muster - matchTyp: string
_value Ziel-Domain, -Subdomain oder Wildcard-Wert
Pflichtfeld, wenn
stop_crawl_on_matchangegeben istGeben Sie eine Ziel-Domain, -Subdomain oder einen Wildcard-Wert an;
Hinweis: Domain oder Subdomain müssen ohne Anfrageprotokoll angegeben werden;
Beispiel:
"match_value": "dataforseo.com","match_value": "/blog/post-*" - maxTyp: integer | null
_crawl _pages Begrenzung der zu crawlenden Seiten
Optionales Feld
Anzahl der zu crawlenden Seiten mit Suchergebnissen
Höchstwert:
100Hinweis: Für jede gecrawlte Seite wird abgerechnet (10 organische Ergebnisse pro Seite);
mehr zur Preisgestaltung auf unserer Seite Pricing;
Hinweis Nr. 2: Die Parameter
max_crawl_pagesunddepthergänzen sich;mehr dazu in unserem Help-Center
- 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 - peopleTyp: integer | null
_also _ask _click _depth Klicks auf das entsprechende Element
Optionales Feld
Geben Sie die Klicktiefe für das Element
people_also_askan, um zusätzlichepeople_also_ask_element-Einträge zu erhalten;Hinweis Ihrem Konto werden für jeden Klick unabhängig von der Aufgabenpriorität zusätzlich $0.00015 berechnet;
wenn das Element fehlt oder wir weniger Klicks ausführen als von Ihnen angegeben, werden alle zusätzlichen Kosten Ihrem Kontostand zurückerstattet
Mögliche Werte: von
1bis4 - pingbackTyp: string | null
_url Benachrichtigungs-URL einer abgeschlossenen Aufgabe
Optionales Feld
Wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL
Sie können die Zeichenfolge ‘$id’ als
$id-Variable und ‘$tag’ als URL-kodierte$tag-Variable verwenden. Wir legen die erforderlichen Werte vor dem Senden der Anfrage fest.Beispiel:
http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagHinweis: Sonderzeichen in
pingback_urlwerden URL-kodiert;so wird das Zeichen
#in%23kodiert
mehr dazu in unserem Help-Center
- postbackTyp: string
_data postback_url-Datentyp
Pflichtfeld, wenn
postback_urlangegeben wirdentspricht dem Datentyp, der an Ihren Server gesendet wird
Mögliche Werte:
regular,advanced,html - postbackTyp: string | null
_url URL zum Senden der Aufgabenergebnisse
optionales Feld
sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den im
gzip-Format komprimierten Ergebnissen an die von Ihnen angegebenepostback_urlSie können die Zeichenfolge ‚$id‘ als
$id-Variable und ‚$tag‘ als urlencodierte$tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der AnfrageBeispiel:
http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagHinweis: Sonderzeichen in
postback_urlwerden urlencodiert;u. a. wird das Zeichen
#in%23kodiert
Weitere Informationen finden Sie in unserem Hilfe-Center
- priorityTyp: integer | null
Aufgabenpriorität
optionales Feld
kann folgende Werte annehmen:
1 – normale Ausführungspriorität (standardmäßig festgelegt);
2 – hohe Ausführungspriorität
Für Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet.Die Kosten können auf der Seite Preise berechnet werden.
- removeTyp: array string[] | null
_from _url bestimmte Parameter aus URLs entfernen
optionales Feld
Mit diesem Feld können Sie bis zu 10 Parameter angeben, die aus URLs im Ergebnis entfernt werden sollen
Beispiel:
"remove_from_url": ["srsltid"] - 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:
google.co.uk, google.com.au, google.deusw. - searchTyp: string | null
_param zusätzliche Parameter der Suchabfrage
optionales Feld
Die Liste der verfügbaren Parameter und weitere Details finden Sie hier
Hinweis: Die folgenden Suchmaschinen-Parameter werden nicht unterstützt und automatisch zurückgesetzt, wenn sie angegeben werden:lr,cr,as_qdr,as_sitesearch,as_occt,as_filetype. - 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
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 - targetTyp: string | null
_search _mode Zielübereinstimmungsmodus
optionales Feld
Um diesen Parameter zu aktivieren, muss auch
stop_crawl_on_matchaktiviert seinLegt fest, wie das Crawling beendet werden soll, wenn mehrere Ziele in
stop_crawl_on_matchangegeben sindmögliche Werte:
all,anyall– das Crawling wird erst beendet, wenn alle angegebenen Ziele gefunden wurdenany– das Crawling wird beendet, sobald ein einzelnes Ziel gefunden wurdeStandardwert:
anyWeitere Informationen zu diesem Parameter finden Sie in unserem Hilfe-Center
- 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://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
Hinweis: Die folgenden Suchmaschinen-Parameter werden nicht unterstützt und automatisch zurückgesetzt, wenn sie in der URL angegeben werden:lr,cr,as_qdr,as_sitesearch,as_occt,as_filetype.
- Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicTaskPostResponseInfo200
- 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_SerpGoogleOrganicTaskPostTaskInfo
- 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: object | null
Array von Ergebnissen
in diesem Fall ist der Wertnull - 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/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
},
{
"language_name": "English",
"location_name": "United States",
"keyword": "albert einstein",
"priority": 2,
"tag": "some_string_123",
"pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
},
{
"url": "https://www.google.co.uk/search?q=albert%20einstein&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
"postback_data": "html",
"postback_url": "https://your-server.com/postbackscript"
}
]'
{
"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": null
}
]
}