DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Průnik aplikací App Store naživo
Klíčová slova, na která se umisťují dvě nebo více aplikací App Store. 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. Dvojče v Google Play: post_dataforseo_labs_google_app_intersection_live.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.1356.
- 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)[]
- appTyp: object | null
_ids ID cílových aplikací
povinné pole
ID cílových mobilních aplikací v App Store;
ID najdete v adrese URL každé aplikace uvedené v App Store;
příklad:
v adrese URLhttps://apps.apple.com/us/app/id835599320
je ID835599320;
ID je nutné zadat následujícím způsobem:"app_ids": {<br>"1": "686449807",<br>"2": "382617920"<br>}
pokud zde zadáte jediné ID, API vrátí výsledky pouze pro jednu aplikaci;
maximální počet ID aplikací, které můžete v tomto objektu zadat, je20- propertyTyp: string | null
Name
- filtersTyp: array (object | null)[] | null
pole parametrů filtrování výsledků
volitelné pole
můžete přidat několik filtrů najednou (maximálně 8 filtrů)
mezi podmínkami je nutné nastavit logický operátorand,or
podporované operátory:<,<=,>,>=,=,<>,in,not_in
příklad:["keyword_data.keyword_info.search_volume",">",500][["keyword_data.keyword_info.search_volume","<>",500],"and",[intersection_result.382617920.rank_group",">=","10"]]další informace o filtrech najdete v Dataforseo Labs - Filters nebo v tomto průvodci Centra nápovědy
Prázdný objekt - languageTyp: string | null
_code kód jazyka
povinné pole, pokud nezadátelanguage_name
Poznámka: je nutné zadat buďlanguage_name, nebolanguage_code
seznam dostupných jazyků a jejichlanguage_codezískáte odesláním samostatného požadavku nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Poznámka: tento endpoint aktuálně podporuje pouze anglický jazyk
příklad:en - languageTyp: string
_name úplný název jazyka
povinné pole, pokud nezadátelanguage_code
Poznámka: je nutné zadat buďlanguage_name, nebolanguage_code
seznam dostupných jazyků a jejichlanguage_namezískáte odesláním samostatného požadavku nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Poznámka: tento endpoint aktuálně podporuje pouze anglický jazyk;
příklad:English - 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
_code kód lokality
povinné pole, pokud nezadátelocation_name
Poznámka: je nutné zadat buďlocation_name, nebolocation_code
seznam dostupných lokalit a jejichlocation_codezískáte odesláním samostatného požadavku nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Poznámka: tento endpoint aktuálně podporuje pouze lokalitu USA;
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 a jejichlocation_namezískáte odesláním samostatného požadavku nahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Poznámka: tento endpoint aktuálně podporuje pouze lokalitu USA;
příklad:United States - 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 poskytnuta pro následující klíčová slova - 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ě;
typ řazení se nastavuje čárkou;
příklad:["intersection_result.382617920.rank_absolute,asc"]
Poznámka: v jednom požadavku lze nastavit nejvýše tři pravidla řazení;
několik pravidel řazení je nutné oddělit čárkou;
příklad:["intersection_result.382617920.rank_absolute,desc","keyword_data.keyword_info.search_volume,asc"]
výchozí pravidlo:["keyword_data.keyword_info.search_volume,desc"]
Poznámka: pokud poleitem_typesobsahuje typy položek odlišné odorganic, budou výsledky seřazeny podle prvního typu položky v poli - 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_DataforseoLabsAppleAppIntersectionLiveResponseInfo200
- 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_DataforseoLabsAppleAppIntersectionLiveTaskInfo
- 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ů
- appTyp: object | null
_ids ID aplikací v poli POST
- propertyTyp: string | null
Name
- itemsTyp: array (object | null)[] | null
obsahuje data týkající se rankingových klíčových slov aplikace zadané v poli
app_id- intersectionTyp: object | null
_result obsahuje data SERP pro vrácené
keyword
data budou poskytnuta v samostatných polích pro každé ID aplikace, které jste zadali v objektuapp_idspři nastavování úlohy;
v závislosti na počtu zadaných ID aplikací může obsahovat 1 až 20 odpovídajícím způsobem pojmenovaných polí- propertyTyp: object | null · Response36Afe1097B20_GooglePlaySearchOrganic
Name - appTyp: string | null
_id id aplikace v poli POST
- developerTyp: string | null
název vývojáře aplikace
- developerTyp: string | null
_url URL stránky vývojáře v Google Play
- iconTyp: string | null
URL ikony aplikace
- isTyp: boolean | null
_free - positionTyp: string | null
zarovnání prvku v SERP
může nabývat následujících hodnot:left,right - priceTyp: object | null · Response36Afe1097B20_PriceInfo
- currencyTyp: string | null
měna uvedené ceny kód ISO měny použité na cenu
- currentTyp: number | null Formát: double
aktuální cena udává aktuální cenu produktu nebo služby uvedené ve výsledku
- displayedTyp: string | null
_price řetězec ceny ve výsledku surový řetězec ceny tak, jak je uveden ve výsledku
- isTyp: boolean | null
_price _range cena je uvedena jako rozsah udává, zda je cena uvedena jako rozsah
- maxTyp: number | null Formát: double
_value maximální cena maximální cena produktu nebo služby uvedená ve výsledku
- regularTyp: number | null Formát: double
běžná cena udává běžnou cenu produktu nebo služby bez uplatněných slev
- rankTyp: integer | null
_absolute absolutní pořadí v SERP
absolutní pozice mezi všemi prvky v SERP - rankTyp: integer | null
_group pozice ve skupině prvků se shodnými hodnotami
type
pozice prvků s odlišnými hodnotamitypese vrank_groupvynechávají - ratingTyp: object | null · Response36Afe1097B20_RatingInfo
průměrné hodnocení aplikace
- ratingTyp: integer | null
_max maximální hodnota pro rating_type
- ratingTyp: string | null
_type typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax
- valueTyp: number | null Formát: double
hodnota hodnocení
- votesTyp: integer | null Formát: int64
_count množství zpětné vazby
- reviewsTyp: integer | null Formát: int64
_count celkový počet recenzí aplikace
- titleTyp: string | null
název aplikace
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL stránky aplikace v Google Play
- keywordTyp: object | null · Response36Afe1097B20_KeywordDataInfo
_data data klíčového slova pro vrácené klíčové slovo
- 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
- seTyp: string | null
_type typ vyhledávače
- 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
- seTyp: string | null
_type typ vyhledávače
- 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/apple/app_intersection/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_ids": {
"1": "686449807",
"2": "382617920"
},
"language_name": "English",
"location_code": 2840,
"limit": 10
}
]'
{
"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,
"app_ids": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword_data": "[Max Depth Exceeded]",
"intersection_result": null
}
]
}
]
}
]
}