DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vytváření úloh organického SERP Yahoo
Zařadí výsledky v pořadí pro klíčové slovo v Yahoo do fronty 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á varianta odpovídá okamžitě a u jediného dotazu je jednodušší; do fronty zařaďte, když by dávka přesáhla trvání 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
výchozí hodnota:desktop - keywordTyp: string
keyword
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 tomto článku Centra nápovědy - languageTyp: string
_code kód jazyka vyhledávače
povinné pole, pokud nezadátelanguage_name
pokud toto pole použijete, nemusíte zadávatlanguage_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}}/languages
příklad:en - languageTyp: string
_name úplný název jazyka vyhledávače
povinné pole, pokud nezadátelanguage_code
pokud toto pole použijete, nemusíte zadávatlanguage_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}}/languages
příklad:English - 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:2840 - locationTyp: string
_coordinate GPS souřadnice lokality
povinné pole, pokud nezadátelocation_namenebolocation_code
pokud toto pole použijete, nemusíte zadávatlocation_nameanilocation_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 "radius": 199.9 (mm)
maximální hodnota "radius": 199999 (mm)
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:London,England,United Kingdom - 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 - 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
- seTyp: string | null
_domain doména vyhledávače
volitelné pole
relevantní doménu vyhledávače vybíráme automaticky podle zadané lokality a jazyka
v tomto poli však můžete nastavit vlastní doménu vyhledávače
příklad:au.search.yahoo.com,uk.search.yahoo.com,ca.search.yahoo.comatd. - searchTyp: string | null
_param další parametry vyhledávacího dotazu
volitelné pole
seznam dostupných parametrů a další podrobnosti najdete zde - 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 - urlTyp: string | null
přímá URL vyhledávacího dotazu
volitelné pole
můžete zadat přímou URL a my ji rozebereme do potřebných polí. Upozorňujeme, že tato metoda je pro naše API nejnáročnější na zpracování a vyžaduje zadání přesného jazyka a lokality v URL. Ve většině případů tuto metodu nedoporučujeme.
příklad:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8
- Typ: object | null · Response36Afe1097B20_SerpYahooOrganicTaskPostResponseInfo200
- 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_SerpYahooOrganicTaskPostTaskInfo
- 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/yahoo/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"
}
]'
{
"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
}
]
}