Baidu-Organic-SERP-Aufgaben einstellen
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Baidu-Organic-SERP-Aufgaben einstellen
Stellt die Rangfolge der Ergebnisse für ein Keyword bei Baidu 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-Endpunkt antwortet sofort und ist für eine einzelne Abfrage einfacher; verwenden Sie die Warteschlange, wenn eine Reihe von Keywords 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)[]
- depthTyp: integer | null
Parsing-Tiefe
Optionales Feld
Anzahl der Ergebnisse in der SERP
Standardwert:10
Hö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
mögliche Werte:desktop,mobile,tablet
Standardwert:desktop - getTyp: boolean | null
_website _url direkte URL für jedes gelistete Ergebnis angeben
Optionales Feld
beitrueenthalten die zurückgegebenen Ergebnisse direkte URLs der gelisteten Websites
standardmäßig sind die URLs in Baidu-Ergebnissen von der Suchmaschine kodiert,
zum Beispiel:http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLStandardwert:false
Hinweis: beitruewird die Gebühr pro Aufgabe mit 10 multipliziert, da unser System für jede gelistete Website eine separate Anfrage ausführt, um ihre direkte URL zurückzugeben - 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 „%“ für Ihrkeywordbenötigen, geben Sie es als „%25“ an;
wenn Sie das Zeichen „+“ für Ihrkeywordbenötigen, geben Sie es als „%2B“ anweitere 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 nicht angebenlanguage_name
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}}/languagesHinweis: Die einzige in der Suchmaschine Baidu unterstützte Sprache istChinese (Simplified)mit dem Sprachcodezh_CN. Baidu kann jedoch auch Ergebnisse für Suchanfragen in anderen Sprachen zurückgeben, daher ist die Angabe vonkeywordauf Chinesisch nicht zwingend erforderlichBeispiel:
zh_CN - languageTyp: string
_name vollständiger Name der Sprache der Suchmaschine
Pflichtfeld, wenn Sie nicht angebenlanguage_code
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}}/languagesHinweis: Die einzige in der Suchmaschine Baidu unterstützte Sprache istChinese (Simplified). Baidu kann jedoch auch Ergebnisse für Suchanfragen in anderen Sprachen zurückgeben, daher ist die Angabe vonkeywordauf Chinesisch nicht zwingend erforderlichBeispiel:
Chinese (Simplified) - 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:2156 - locationTyp: string
_coordinate GPS-Koordinaten eines Standorts
Pflichtfeld, wenn Sie nicht angebenlocation_nameoderlocation_code
bei Verwendung dieses Feldes müssen Sielocation_nameoderlocation_codenicht angeben
der Parameterlocation_coordinatesollte im Format "latitude,longitude,radius" angegeben werden
die maximale Anzahl von Dezimalstellen für "latitude" und "longitude": 7
der Mindestwert für "radius": 199.9 (mm)
der Höchstwert für "radius": 199999 (mm)bei Verwendung dieses Feldes basieren die zurückgegebenen Ergebnisse auf der nächstgelegenen Stadt zu Ihren Koordinaten. Daher empfehlen wir nicht, dieses Feld zu verwenden, da die Ergebnisse für die angegebenen Koordinaten möglicherweise nicht relevant sind
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:New York,New York,United States - 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
wenn Sie im Felddevicetabletangeben, wählen Sie aus folgenden Werten:android,ios
Standardwert:android - pingbackTyp: string | null
_url Benachrichtigungs-URL für eine abgeschlossene 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 setzen die erforderlichen Werte vor dem Senden der Anfrage.
Beispiel:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Hinweis: Sonderzeichen inpingback_urlwerden URL-kodiert;
d. h. das Zeichen#wird zu%23kodiert - postbackTyp: string
_data postback_url-Datentyp
Pflichtfeld, wenn Siepostback_urlangeben
entspricht dem Datentyp, der an Ihren Server gesendet wird
mögliche Werte:regular,html - postbackTyp: string | null
_url URL zum Senden von Aufgabenergebnissen
Optionales Feld
Sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den imgzip-Format komprimierten Ergebnissen an die von Ihnen angegebenepostback_url
Sie können die Zeichenfolge ‘$id’ als$id-Variable und ‘$tag’ als URL-kodierte$tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
Beispiel:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Hinweis: Sonderzeichen inpostback_urlwerden URL-kodiert;
d. h. das Zeichen#wird zu%23kodiert - priorityTyp: integer | null
- 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
- Typ: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- 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_SerpBaiduOrganicTaskPostTaskInfo
- 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/baidu/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2156,
"keyword": "best iphone ever",
"tag": "some_string_123",
"priority": 2
}
]'
{
"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
}
]
}