DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vytváření úloh organického SERP Baidu
Zařadí do fronty výsledky v pořadí pro klíčové slovo v Baidu a vrátí id úlohy v tasks[0].id. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200. Živý protějšek odpovídá okamžitě a pro jedno hledání je jednodušší; do fronty zařazujte, když by dávka překonala trpělivost volání nástroje.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.02.
- Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array (object | null)[]
- depthTyp: integer | null
- deviceTyp: string | null
typ zařízení
volitelné pole
vracet výsledky pro určitý typ zařízení
možné hodnoty:desktop,mobile,tablet
výchozí hodnota:desktop - getTyp: boolean | null
_website _url zahrnout přímou URL pro každý umístěný výsledek
volitelné pole
pokud je nastaveno natrue, vrácené výsledky budou obsahovat přímé adresy URL umístěných webů
ve výchozím nastavení jsou adresy URL ve výsledcích Baidu kódovány vyhledávačem,
například:http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLvýchozí hodnota:false
Poznámka: pokud je nastaveno natrue, bude poplatek za úlohu vynásoben 10, protože náš systém provádí samostatný požadavek pro každý umístěný web, aby vrátil jeho přímou URL - keywordTyp: string
klíčové slovo
povinné pole
v polikeywordmůžete zadat až 700 znaků
všechny %## budou dekódovány (znak ‘+’ bude dekódován jako mezera)
pokud potřebujete vkeywordpoužít znak „%“, zadejte jej jako „%25“;
pokud potřebujete vkeywordpoužít znak „+“, zadejte jej jako „%2B“další informace o pravidlech a omezeních polí
keywordakeywordsv rozhraních API DataForSEO najdete v článku Centra nápovědy - languageTyp: string
_code kód jazyka vyhledávače
povinné pole, pokud nezadátelanguage_name
seznam dostupných jazyků vyhledávače s jejichlanguage_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagespoznámka: jediným jazykem podporovaným ve vyhledávači Baidu jeChinese (Simplified)s kódem jazykazh_CN. Baidu však může vracet výsledky i pro dotazy v jiných jazycích, takže zadáníkeywordv čínštině není povinnépříklad:
zh_CN - languageTyp: string
_name úplný název jazyka vyhledávače
povinné pole, pokud nezadátelanguage_code
seznam dostupných jazyků vyhledávače s jejichlanguage_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagespoznámka: jediným jazykem podporovaným ve vyhledávači Baidu jeChinese (Simplified). Baidu však může vracet výsledky i pro dotazy v jiných jazycích, takže zadáníkeywordv čínštině není povinnépříklad:
Chinese (Simplified) - locationTyp: integer
_code kód lokality vyhledávače
povinné pole, pokud nezadátelocation_namenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_namenebolocation_coordinate
seznam dostupných lokalit vyhledávačů s jejichlocation_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
příklad:2156 - locationTyp: string
_coordinate GPS souřadnice lokality
povinné pole, pokud nezadátelocation_namenebolocation_code
pokud toto pole použijete, nemusíte zadávatlocation_namenebolocation_code
parametrlocation_coordinateje nutné zadat ve formátu "latitude,longitude,radius"
maximální počet desetinných míst pro "latitude" a "longitude": 7
minimální hodnota pro "radius": 199.9 (mm)
maximální hodnota pro "radius": 199999 (mm)pokud toto pole použijete, vrácené výsledky budou vycházet z nejbližšího města nalezeného pro vaše souřadnice. Proto nedoporučujeme toto pole používat, protože výsledky nemusí odpovídat zadaným souřadnicím
příklad:53.476225,-2.243572,200 - locationTyp: string
_name úplný název lokality vyhledávače
povinné pole, pokud nezadátelocation_codenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_codenebolocation_coordinate
seznam dostupných lokalit vyhledávače s jejichlocation_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
příklad:New York,New York,United States - maxTyp: integer | null
_crawl _pages - osTyp: string | null
operační systém zařízení
volitelné pole
pokud v polidevicezadátedesktop, vyberte z následujících hodnot:windows,macos
výchozí hodnota:windows
pokud v polidevicezadátemobile, vyberte z následujících hodnot:android,ios
výchozí hodnota:android
pokud v polidevicezadátetablet, vyberte z následujících hodnot:android,ios
výchozí hodnota:android - pingbackTyp: string | null
_url URL oznámení o dokončené úloze
volitelné pole
po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL
řetězec ‘$id’ můžete použít jako proměnnou$ida ‘$tag’ jako proměnnou$tagkódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
příklad:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Poznámka: speciální znaky vpingback_urlbudou kódovány v URL;
mj. znak#bude zakódován jako%23 - postbackTyp: string
_data datový typ postback_url
povinné pole, pokud zadátepostback_url
odpovídá datovému typu, který bude odeslán na váš server
možné hodnoty:regular,html - postbackTyp: string | null
_url URL pro odesílání výsledků úlohy
volitelné pole
po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátugzipna zadanoupostback_url
řetězec ‘$id’ můžete použít jako proměnnou$ida ‘$tag’ jako proměnnou$tagkódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
příklad:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Poznámka: speciální znaky vpostback_urlbudou kódovány v URL;
mj. znak#bude zakódován jako%23 - priorityTyp: integer | null
- stopTyp: array (object | null)[] | null
_crawl _on _match pole cílových hodnot pro zastavení procházení volitelné pole pokud je zadáno, odpověď bude obsahovat výsledky SERP až do zadané hodnoty match_value včetně; v tomto poli můžete zadat až 10 cílových hodnot příklad: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] další informace o tomto parametru najdete v našem Centru nápovědy — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Váš účet bude účtován za každý SERP procházený přes zadané cíle
- matchTyp: string | null
_type typ shody cíle povinné pole, pokud je zadáno stop_crawl_on_match; typ shody pro match_value možné hodnoty: domain, with_subdomains, wildcard
- matchTyp: string | null
_value cílová doména nebo hodnota se zástupným znakem povinné pole, pokud je zadáno stop_crawl_on_match; zadejte cílovou doménu nebo hodnotu se zástupným znakem; Poznámka: název domény je nutné zadat bez protokolu požadavku; příklad: dataforseo.com
- tagTyp: string | null
uživatelem definovaný identifikátor úlohy
volitelné pole
limit znaků je 255
tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
zadanou hodnotutagnajdete v objektudataodpovědi
- Typ: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: object | null
pole výsledků
v tomto případě bude hodnotanull - resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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
}
]
}