DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Klíčová slova pro web
Klíčová slova, na která se web target umisťuje. Vrací se_type, target, total_count, offset_token a items. Stránkování přes limit, offset a offset_token; po prvních stránkách používejte token. 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. Jde o stejnou otázku, stránkovanou a za sedminu ceny.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.132.
- Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na 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)[]
- filtersTyp: array (object | null)[] | null
pole parametrů filtrování výsledků
volitelné pole
můžete přidat několik filtrů najednou (maximálně 8)
mezi podmínkami je nutné nastavit logický operátorand,or
podporované operátory:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
operátor%můžete použít slikeanot_like, stejně jako silikeanot_ilike, pro shodu s libovolným řetězcem o nule nebo více znacích
pamatujte, že výsledky nelze filtrovat podlerelevance
příklad:["keyword_info.search_volume",">",0]
další informace o filtrech naleznete v Dataforseo Labs - Filters nebo v tomto průvodci centra nápovědyPrázdný objekt - includeTyp: boolean | null
_clickstream _data zahrnutí nebo vyloučení dat z metrik založených na clickstreamu ve výsledku
volitelné pole
pokud je parametr nastaven natrue, v odpovědi obdržíte poleclickstream_keyword_info,keyword_info_normalized_with_clickstreamakeyword_info_normalized_with_bing
výchozí hodnota:false
povolením tohoto parametru se cena za požadavek zdvojnásobídalší informace o tom, jak se metriky založené na clickstreamu počítají, najdete v tomto článku centra nápovědy
- includeTyp: boolean | null
_serp _info zahrnout data ze SERP pro každé klíčové slovo
volitelné pole
pokud je nastaveno natrue, vrátíme poleserp_infoobsahující data SERP (počet výsledků vyhledávání, příslušnou URL a funkce SERP) pro každé klíčové slovo v odpovědi
výchozí hodnota:false - includeTyp: boolean | null
_subdomains určuje, zda budou subdomény zahrnuty do vyhledávání
volitelné pole
pokud je nastaveno nafalse, subdomény budou ignorovány
výchozí hodnota:true - languageTyp: string | null
_code kód jazyka
volitelné pole
pokud toto pole použijete, nemusíte zadávatlanguage_name
seznam dostupných jazyků s jejichlanguage_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
příklad:en
Poznámka: pokud pole vynecháte, výsledky se ve výchozím nastavení použijí pro jazyk s největším počtem záznamů klíčových slov v zadané lokalitě;
výchozí jazyk určíte podle poleavailable_languages.keywordsv endpointu Locations and Languages - languageTyp: string | null
_name úplný název jazyka
volitelné pole
pokud toto pole použijete, nemusíte zadávatlanguage_code
seznam dostupných jazyků s jejichlanguage_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
příklad:English
Poznámka: pokud pole vynecháte, výsledky se ve výchozím nastavení použijí pro jazyk s největším počtem záznamů klíčových slov v zadané lokalitě;
výchozí jazyk určíte podle poleavailable_languages.keywordsv endpointu Locations and Languages - limitTyp: integer | null
maximální počet klíčových slov v poli výsledků
volitelné pole
výchozí hodnota:100
maximální hodnota:1000 - locationTyp: integer
_code jedinečný identifikátor lokality
povinné pole, pokud nezadátelocation_name
Poznámka: je nutné zadat buďlocation_name, nebolocation_code
seznam dostupných lokalit s jejichlocation_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
příklad:2840 - locationTyp: string
_name úplný název lokality
povinné pole, pokud nezadátelocation_code
Poznámka: je nutné zadat buďlocation_name, nebolocation_code
seznam dostupných lokalit s jejichlocation_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
příklad:United Kingdom - offsetTyp: integer | null
posun v poli výsledků vrácených klíčových slov
volitelné pole
výchozí hodnota:0
pokud zadáte hodnotu10, prvních deset klíčových slov v poli výsledků bude vynecháno a data budou vrácena pro následující klíčová slova
Poznámka: doporučujeme tento parametr používat pouze při načítání až 10 000 výsledků
pro načtení více než 10 000 výsledků použijte místo tohooffset_token. - offsetTyp: string | null
_token token posunu pro následující požadavky
volitelné pole
uvádí se v identickém poli odpovědi na každý požadavek;
tento parametr použijte, abyste se vyhnuli vypršení časového limitu při pokusu o získání více než 10 000 výsledků v jednom požadavku;
zadáním jedinečné hodnotyoffset_tokenz pole odpovědi získáte následující výsledky původní úlohy;
hodnotyoffset_tokenjsou jedinečné pro každou následující úlohu
Poznámka: pokud je v požadavku zadánoffset_token, všechny ostatní parametry kromělimitnebudou při zpracování úlohy brány v úvahu.
další informace o tomto parametru najdete v našem Centru nápovědy - orderTyp: array string[] | null
_by pravidla řazení výsledků
volitelné pole
k řazení výsledků můžete použít stejné hodnoty jako v polifilters
možné typy řazení:asc— výsledky budou seřazeny vzestupnědesc— výsledky budou seřazeny sestupně
parametr řazení se nastavuje čárkouvýchozí pravidlo:
["relevance,desc"]
pravidlo relevance se používá jako výchozí pravidlo řazení a poskytuje nejbližší návrhy klíčových slov. Doporučujeme toto pravidlo řazení používat k získání vysoce relevantních vyhledávacích výrazů. Poznámka:relevanceje pouze náš interní systémový identifikátor, takže jej nelze použít jako filtr a toto pole v poliresultnenajdete. Skóre relevance je založeno na podobném principu jako v endpointu Keywords For Keywords.pamatujte, že v jednom požadavku lze nastavit nejvýše tři pravidla řazení
několik pravidel řazení je nutné oddělit čárkou
příklad:["relevance,desc","keyword_info.search_volume,desc"] - 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 - targetTyp: string
název domény nebo URL stránky
povinné pole
název cílové domény webu, subdoména nebo URL cílové webové stránky;
název domény je nutné zadat bezhttps://nebowww.;
subdoménu je nutné zadat bezhttps://;
URL webové stránky je nutné zadat shttps://nebowww.
Poznámka: pokud URL webové stránky zadáte bezhttps://nebowww., výsledek se vrátí pro celou doménu, nikoli pro konkrétní stránku
- Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordsForSiteLiveResponseInfo200
- 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_DataforseoLabsGoogleKeywordsForSiteLiveTaskInfo
- 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: array (object | null)[] | null
pole výsledků
- itemsTyp: array (object | null)[] | null
obsahuje návrhy klíčových slov a související data
- avgTyp: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info data o zpětných odkazech pro vrácené klíčové slovo
tento objekt poskytuje průměrný počet zpětných odkazů, odkazujících stránek a domén a také průměrné hodnoty pořadí mezi 10 nejlepšími webovými stránkami organicky se umisťujícími na klíčové slovo- backlinksTyp: number | null
průměrný počet zpětných odkazů
- dofollowTyp: number | null
průměrný počet odkazů dofollow
- lastTyp: string | null
_updated _time datum a čas aktualizace dat klíčového slova
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - mainTyp: number | null
_domain _rank - rankTyp: number | null
- referringTyp: number | null
_domains průměrný počet odkazujících domén
- referringTyp: number | null
_main _domains průměrný počet odkazujících hlavních domén
- referringTyp: number | null
_pages průměrný počet odkazujících stránek
- seTyp: string | null
_type typ vyhledávače
- clickstreamTyp: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info clickstream data pro vrácené klíčové slovo
pro získání výsledků tohoto pole musí být parametrinclude_clickstream_datanastaven natrue- ageTyp: object | null
_distribution - propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- genderTyp: object | null
_distribution - propertyTyp: integer | null Formát: int64
Name Signed 64-bit integers (long type).
- lastTyp: string | null
_updated _time datum a čas aktualizace dat klíčového slova
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - monthlyTyp: array (object | null)[] | null
_searches měsíční vyhledávání
představuje (přibližný) počet vyhledávání daného námětu klíčového slova (dostupný za posledních dvanáct měsíců) v zadaných zeměpisných lokalitách- monthTyp: integer | null
Měsíc.
- searchTyp: integer | null
_volume průměrná měsíční hledanost
- yearTyp: integer | null
Rok.
- searchTyp: integer | null Formát: int64
_volume průměrná měsíční míra objemu vyhledávání
představuje (přibližný) počet vyhledávání daného námětu klíčového slova na google.com
- keywordTyp: string | null
vrácený nápad na klíčové slovo
- keywordTyp: object | null · Response36Afe1097B20_KeywordInfo
_info data klíčového slova pro vrácený nápad na klíčové slovo
- categoriesTyp: array integer[] | null
- competitionTyp: number | null
konkurence
představuje relativní míru konkurence spojené s daným klíčovým slovem. Hodnota vychází z dat Google Ads a může být v rozmezí od 0 do 1 (včetně) - competitionTyp: string | null
_level - cpcTyp: number | null
cena za kliknutí
představuje průměrnou cenu za kliknutí (USD), která byla historicky za klíčové slovo placena - highTyp: number | null
_top _of _page _bid maximální nabídka, aby se reklama zobrazovala v horní části první stránky
udává hodnotu vyšší než přibližně 80 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty)
hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST - lastTyp: string | null
_updated _time datum a čas aktualizace dat klíčového slova
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - lowTyp: number | null
_top _of _page _bid minimální nabídka, aby se reklama zobrazovala v horní části první stránky
udává hodnotu vyšší než přibližně 20 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty)
hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST - monthlyTyp: array (object | null)[] | null
_searches měsíční vyhledávání
představuje (přibližný) počet vyhledávání daného námětu klíčového slova (dostupný za posledních dvanáct měsíců) v zadaných zeměpisných lokalitách- monthTyp: integer | null
Měsíc.
- searchTyp: integer | null
_volume průměrná měsíční hledanost
- yearTyp: integer | null
Rok.
- seTyp: string | null
_type typ vyhledávače
- searchTyp: integer | null Formát: int64
_volume průměrná měsíční míra objemu vyhledávání
představuje (přibližný) počet vyhledávání daného námětu klíčového slova na google.com - searchTyp: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend změny trendu objemu vyhledávání
představuje změnu objemu vyhledávání v procentech oproti předchozímu období- monthlyTyp: integer | null
změna objemu vyhledávání v procentech oproti předchozímu měsíci
- quarterlyTyp: integer | null
změna objemu vyhledávání v procentech oproti předchozímu čtvrtletí
- yearlyTyp: integer | null
změna objemu vyhledávání v procentech oproti předchozímu roku
- keywordTyp: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing obsahuje objem vyhledávání klíčového slova normalizovaný objemem vyhledávání Bing
- isTyp: boolean | null
_normalized informace o klíčovém slově jsou normalizované pokud je true, hodnoty jsou normalizovány daty Bing
- lastTyp: string | null
_updated _time datum a čas aktualizace datové sady ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00” příklad: 2019-11-15 12:57:46 +00:00
- monthlyTyp: array (object | null)[] | null
_searches míry měsíční hledanosti pole objektů s mírami hledanosti v určitém měsíci roku
- monthTyp: integer | null
Měsíc.
- searchTyp: integer | null
_volume průměrná měsíční hledanost
- yearTyp: integer | null
Rok.
- searchTyp: integer | null
_volume aktuální hledanost klíčového slova
- keywordTyp: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream obsahuje objem vyhledávání klíčového slova normalizovaný clickstream daty
- isTyp: boolean | null
_normalized informace o klíčovém slově jsou normalizované pokud je true, hodnoty jsou normalizovány daty Bing
- lastTyp: string | null
_updated _time datum a čas aktualizace datové sady ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00” příklad: 2019-11-15 12:57:46 +00:00
- monthlyTyp: array (object | null)[] | null
_searches míry měsíční hledanosti pole objektů s mírami hledanosti v určitém měsíci roku
- monthTyp: integer | null
Měsíc.
- searchTyp: integer | null
_volume průměrná měsíční hledanost
- yearTyp: integer | null
Rok.
- searchTyp: integer | null
_volume aktuální hledanost klíčového slova
- keywordTyp: object | null · Response36Afe1097B20_KeywordProperties
_properties doplňující informace o klíčovém slovu
- coreTyp: string | null
_keyword hlavní klíčové slovo ve skupině
obsahuje hlavní klíčové slovo ve skupině určené algoritmem shlukování synonym
pokud je hodnotanull, naše databáze neobsahuje žádná klíčová slova, která by příslušný algoritmus mohl označit za synonymní skeyword - detectedTyp: string | null
_language zjištěný jazyk klíčového slova
udává jazyk klíčového slova rozpoznaný naším systémem - isTyp: boolean | null
_another _language zjištěný jazyk klíčového slova se liší od nastaveného jazyka
pokud jetrue, jazyk nastavený v požadavku neodpovídá jazyku, který pro dané klíčové slovo určil náš systém - keywordTyp: integer | null
_difficulty obtížnost umístění v první desítce organických výsledků pro klíčové slovo
udává šanci dostat se do top 10 organických výsledků pro klíčové slovo na logaritmické škále od 0 do 100;
počítá se mimo jiné analýzou odkazových profilů prvních 10 stránek v SERP;
více o této metrice v této příručce centra nápovědy - seTyp: string | null
_type typ vyhledávače
- synonymTyp: string | null
_clustering _algorithm algoritmus použitý k identifikaci synonym
možné hodnoty:keyword_metrics- označuje algoritmus založený na parametrechkeyword_infotext_processing- označuje textový algoritmus
pokud je hodnotanull, naše databáze neobsahuje žádná klíčová slova, která by příslušný algoritmus mohl označit za synonymní skeyword - wordsTyp: integer | null Formát: int64
_count počet slov v klíčovém slově
udává, z kolika slov se klíčové slovo skládá
- languageTyp: string | null
_code kód jazyka v poli POST
- locationTyp: integer | null
_code kód lokality v poli POST
- seTyp: string | null
_type typ vyhledávače
- searchTyp: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignTyp: array (string | null)[] | null
_intent doplňkové záměry vyhledávání
možné hodnoty:informational,navigational,commercial,transactional - lastTyp: string | null
_updated _time datum a čas aktualizace dat klíčového slova
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - mainTyp: string | null
_intent hlavní záměr vyhledávání
možné hodnoty:informational,navigational,commercial,transactional - seTyp: string | null
_type typ vyhledávače
- serpTyp: object | null · Response36Afe1097B20_SerpInfo
_info data SERP
hodnota budenull, pokud jste v poli POST nenastavili poleinclude_serp_infonatruenebo pokud v naší databázi nejsou pro toto klíčové slovo data SERP- checkTyp: string | null
_url přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky - lastTyp: string | null
_updated _time datum a čas aktualizace dat klíčového slova
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - previousTyp: string | null
_updated _time předchozí, před nejnovějším, datum a čas aktualizace dat SERP
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-10-15 12:57:46 +00:00 - seTyp: integer | null Formát: int64
_results _count počet výsledků vyhledávání pro vrácené klíčové slovo
- seTyp: string | null
_type typ vyhledávače
- serpTyp: array (string | null)[] | null
_item _types typy výsledků vyhledávání v SERP
obsahuje typy výsledků vyhledávání (items) nalezených v SERP
možné typy položek:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
poznámka skutečné výsledky budou vráceny pouze pro prvkyorganic,paid,featured_snippetalocal_pack
- itemsTyp: integer | null Formát: int64
_count počet výsledků vrácených v poli
items - languageTyp: string | null
_code kód jazyka v poli POST
- locationTyp: integer | null
_code kód lokality v poli POST
- offsetTyp: integer | null
aktuální hodnota offsetu
- offsetTyp: string | null
_token token posunu pro následné požadavky
řetězec uvedený v tomto poli můžete použít k získání následných výsledků počáteční úlohy;
poznámka: hodnotyoffset_tokenjsou jedinečné pro každou následnou úlohu - seTyp: string | null
_type typ vyhledávače
- targetTyp: string | null
cílová doména v poli POST
- totalTyp: integer | null Formát: int64
_count celkový počet výsledků v naší databázi relevantních pro váš požadavek
- 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/dataforseo_labs/google/keywords_for_site/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "apple.com",
"language_code": "en",
"location_code": 2840,
"include_serp_info": true,
"include_subdomains": true,
"filters": [
"serp_info.se_results_count",
">",
0
],
"limit": 3
}
]'
{
"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": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}