DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Návrhy klíčových slov
Varianty dlouhého ocasu obsahující jedno keyword – pohled na shodu fráze, zatímco post_dataforseo_labs_google_keyword_ideas_live je sémantický. Vrací seed_keyword, seed_keyword_data, total_count, offset_token a items. Stránkování pomocí 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.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.132.
- 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 ani 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)[]
- exactTyp: boolean | null
_match vyhledávání přesné fráze
volitelné pole
pokud je nastaveno natrue, vrácená klíčová slova budou obsahovat přesně zadanou frázi, případně s dalšími slovy před ní nebo po ní
výchozí hodnota:false - 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
příklad:["keyword_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["keyword_info.cpc","<",0.5],
"or",
["keyword_info.high_top_of_page_bid","<=",0.5]]]
další informace o filtrech naleznete v Dataforseo Labs - Filters nebo v tomto průvodci centra nápovědyPrázdný objekt - ignoreTyp: boolean | null
_synonyms ignorovat velmi podobná klíčová slova
volitelné pole
pokud je nastaveno natrue, vrátí se pouze základní klíčová slova a všechna velmi podobná klíčová slova budou vyloučena;
výchozí hodnota:false - includeTyp: boolean | null
_clickstream _data zahrnout nebo vyloučit data z metrik založených na clickstreamu ve výsledku
volitelné pole
pokud je parametr nastaven natrue, obdržíte poleclickstream_keyword_info,keyword_info_normalized_with_clickstreamakeyword_info_normalized_with_bingv odpovědi
výchozí hodnota:false
při zapnutí tohoto parametru bude požadavek účtován dvojnásobnou cenoudalší informace o tom, jak se metriky založené na clickstreamu počítají, najdete v tomto článku Centra nápovědy
- includeTyp: boolean | null
_seed _keyword zahrnout data pro výchozí klíčové slovo
volitelné pole
pokud je nastaveno natrue, data pro výchozí klíčové slovo zadané v polikeywordbudou poskytnuta v poliseed_keyword_dataodpovědi
výchozí hodnota:false - 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 - keywordTyp: string
- 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 vrácených klíčových slov
volitelné pole
výchozí hodnota:100
maximální hodnota:1000 - locationTyp: integer | null
_code kód lokality
volitelné pole
pokud toto pole použijete, nemusíte zadávatlocation_name
seznam dostupných lokalit s jejichlocation_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
toto pole vynechte, chcete-li získat výsledky pro všechny dostupné lokality
příklad:2840 - locationTyp: string | null
_name úplný název lokality
volitelné pole
pokud toto pole použijete, nemusíte zadávatlocation_code
seznam dostupných lokalit s jejichlocation_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
toto pole vynechte, chcete-li získat výsledky pro všechny dostupné lokality
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ě
jako oddělovač se používá čárka
příklad:["keyword_info.competition,desc"]
výchozí pravidlo:["keyword_info.search_volume,desc"]
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:["keyword_info.search_volume,desc","keyword_info.cpc,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
- Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResponseInfo200
- 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_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo
- 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 klíčová slova 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
pokud nejsou k dispozici žádná data, hodnota jenull - locationTyp: integer | null
_code kód lokality v poli POST
pokud nejsou k dispozici žádná data, hodnota jenull - 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
- seedTyp: string | null
_keyword klíčové slovo v poli POST
- seedTyp: object | null · Response36Afe1097B20_KeywordDataInfo
_keyword _data data klíčového slova pro základní klíčové slovo
pole v tomto objektu jsou shodná s těmi v poliitems- 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
- 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/keyword_suggestions/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "phone",
"location_code": 2840,
"language_code": "en",
"include_serp_info": true,
"include_seed_keyword": true,
"limit": 1
}
]'
{
"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,
"seed_keyword": null,
"seed_keyword_data": {
"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]"
},
"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]"
}
]
}
]
}
]
}