Перетин застосунків Google Play (live)
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Перетин застосунків Google Play (live)
Ключові слова, за якими ранжуються два або більше застосунків Google Play. Сторінки з limit, offset і offset_token; використовуйте токен після перших сторінок. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Там, де post_dataforseo_labs_google_app_competitors_live називає конкурентів, цей ендпоінт називає територію, за яку вони змагаються. Аналог для Apple: post_dataforseo_labs_apple_app_intersection_live.
Довідкові ціни
- Тарифікація: вартість відповіді за даними постачальника.
- Довідкова оцінка запиту: USD 0.1356.
- Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.
Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.
- Тип: array (object | null)[]
- appТип: object | null
_ids ідентифікатори цільових застосунків
обов'язкове поле
ідентифікатори цільових мобільних застосунків у Google Play;
ідентифікатор можна знайти в URL кожного застосунку, розміщеного в Google Play;
приклад:
в URLhttps://play.google.com/store/apps/details?id=org.telegram.messenger
ідентифікатор —org.telegram.messenger;
ідентифікатори вказуються таким чином:"app_ids": {
"1": "org.telegram.messenger",
"2": "com.zhiliaoapp.musically"
}
якщо вказати тут один ідентифікатор, API поверне результати лише для одного застосунку;
максимальна кількість ідентифікаторів застосунків, яку можна вказати в цьому об'єкті, —20- propertyТип: string | null
Name
- filtersТип: array (object | null)[] | null
масив параметрів фільтрації результатів
необов'язкове поле
можна додати кілька фільтрів одразу (не більше 8 фільтрів)
між умовами потрібно задати логічний операторandабоor
підтримуються такі оператори:<,<=,>,>=,=,<>,in,not_in
приклад:["keyword_data.keyword_info.search_volume",">",500][["keyword_data.keyword_info.search_volume","<>",500],"and",[intersection_result.382617920.rank_group",">=","10"]]докладніше про фільтри — в Dataforseo Labs - Filters або в цьому посібнику довідкового центру
Порожній об'єкт - languageТип: string | null
_code код мови
обов'язкове поле, якщо не вказаноlanguage_name
Примітка: потрібно вказатиlanguage_nameабоlanguage_code
список доступних мов ізlanguage_codeможна отримати окремим запитом доhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примітка: цей ендпоінт наразі підтримує лише англійську мову
приклад:en - languageТип: string
_name повна назва мови
обов'язкове поле, якщо не вказаноlanguage_code
Примітка: потрібно вказатиlanguage_nameабоlanguage_code
список доступних мов ізlanguage_nameможна отримати окремим запитом доhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примітка: цей ендпоінт наразі підтримує лише англійську мову;
приклад:English - limitТип: integer | null
максимальна кількість ключових слів, що повертаються
необов'язкове поле
значення за замовчуванням:100
максимальне значення:1000 - locationТип: integer
_code код місцезнаходження
обов'язкове поле, якщо не вказаноlocation_name
Примітка: потрібно вказатиlocation_nameабоlocation_code
список доступних місцезнаходжень ізlocation_codeможна отримати окремим запитом доhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примітка: цей ендпоінт наразі підтримує лише місцезнаходження США;
приклад:2840 - locationТип: string
_name повна назва місцезнаходження
обов'язкове поле, якщо не вказаноlocation_code
Примітка: потрібно вказатиlocation_nameабоlocation_code
список доступних місцезнаходжень ізlocation_nameможна отримати окремим запитом доhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примітка: цей ендпоінт наразі підтримує лише місцезнаходження США;
приклад:United States - offsetТип: integer | null
зміщення в масиві результатів повернутих ключових слів
необов'язкове поле
значення за замовчуванням:0
якщо вказати значення10, перші десять ключових слів у масиві результатів буде пропущено, а дані буде надано для наступних ключових слів - orderТип: array string[] | null
_by правила сортування результатів
необов'язкове поле
можна використовувати ті самі значення, що й у масивіfilters, для сортування результатів;
можливі типи сортування:asc- результати сортуються за зростанням;desc- результати сортуються за спаданням;
для задання типу сортування використовуйте кому;
приклад:["intersection_result.382617920.rank_absolute,asc"]
Примітка: в одному запиті можна задати не більше трьох правил сортування;
кілька правил сортування потрібно розділяти комою;
приклад:["intersection_result.382617920.rank_absolute,desc","keyword_data.keyword_info.search_volume,asc"]
правило за замовчуванням:["keyword_data.keyword_info.search_volume,desc"]
Примітка: якщо масивitem_typesмістить типи елементів, відмінні відorganic, результати впорядковуються за першим типом елемента в масиві - tagТип: string | null
визначений користувачем ідентифікатор завдання
необов'язкове поле
обмеження — 255 символів
цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
вказане значенняtagви знайдете в об'єктіdataвідповіді
- Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppIntersectionLiveResponseInfo200
- Тип: number | null Формат: doublecost
загальна вартість завдань, USD
- Тип: integer | nullstatus
_code загальний код стану. Повний список кодів відповіді можна знайти тут.
- Тип: string | nullstatus
_message загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.
- Тип: array (object | null)[] | nulltasks
масив завдань
- Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppIntersectionLiveTaskInfo
- costТип: number | null Формат: double
загальна вартість завдань, USD
- dataТип: object | null
містить ті самі параметри, які ви вказали в POST-запиті
- propertyТип: object | null
Name
- idТип: string | null
ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID
- pathТип: array (string | null)[] | null
шлях URL
- resultТип: array (object | null)[] | null
масив результатів
- appТип: object | null
_ids id застосунків у масиві POST
- propertyТип: string | null
Name
- itemsТип: array (object | null)[] | null
містить дані про ключові слова ранжування для застосунку, вказаного в полі
app_id- intersectionТип: object | null
_result містить дані SERP за повернутим
keyword
дані надаються окремими масивами для кожного ID застосунку, вказаного в об'єктіapp_idsпід час постановки завдання;
залежно від кількості вказаних ID застосунків він може містити від 1 до 20 відповідно названих масивів- propertyТип: object | null · Response36Afe1097B20_GooglePlaySearchOrganic
Name - appТип: string | null
_id id застосунку в масиві POST
- developerТип: string | null
ім'я розробника застосунку
- developerТип: string | null
_url URL сторінки розробника в Google Play
- iconТип: string | null
URL значка застосунку
- isТип: boolean | null
_free - positionТип: string | null
вирівнювання елемента в SERP
може набувати таких значень:left,right - priceТип: object | null · Response36Afe1097B20_PriceInfo
- currencyТип: string | null
валюта зазначеної ціни ISO-код валюти, застосованої до ціни
- currentТип: number | null Формат: double
поточна ціна указує поточну ціну товару або послуги, представлених у результаті
- displayedТип: string | null
_price рядок ціни в результаті вихідний рядок ціни, як надано в результаті
- isТип: boolean | null
_price _range ціна надана як діапазон указує, чи надається ціна як діапазон
- maxТип: number | null Формат: double
_value максимальна ціна максимальна ціна товару або послуги, зазначена в результаті
- regularТип: number | null Формат: double
звичайна ціна указує звичайну ціну товару або послуги без знижок
- rankТип: integer | null
_absolute абсолютний ранг у SERP
абсолютна позиція серед усіх елементів у SERP - rankТип: integer | null
_group позиція в групі елементів з однаковими значеннями
type
позиції елементів з іншими значеннямиtypeвиключаються зrank_group - ratingТип: object | null · Response36Afe1097B20_RatingInfo
середній рейтинг застосунку
- ratingТип: integer | null
_max максимальне значення для rating_type
- ratingТип: string | null
_type тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax
- valueТип: number | null Формат: double
значення рейтингу
- votesТип: integer | null Формат: int64
_count кількість відгуків
- reviewsТип: integer | null Формат: int64
_count загальна кількість відгуків про застосунок
- titleТип: string | null
назва застосунку
- typeТип: string | null
тип елемента
- urlТип: string | null
URL сторінки застосунку в Google Play
- keywordТип: object | null · Response36Afe1097B20_KeywordDataInfo
_data дані ключового слова для повернутого ключового слова
- avgТип: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info дані про зворотні посилання для повернутого ключового слова
цей об'єкт містить середню кількість зворотних посилань, сторінок і доменів, що посилаються, а також середні значення рейтингу серед 10 веб-сторінок, що органічно ранжуються за ключовим словом- backlinksТип: number | null
середня кількість зворотних посилань
- dofollowТип: number | null
середня кількість dofollow-посилань
- lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - mainТип: number | null
_domain _rank - rankТип: number | null
- referringТип: number | null
_domains середня кількість доменів, що посилаються
- referringТип: number | null
_main _domains середня кількість основних доменів, що посилаються
- referringТип: number | null
_pages середня кількість сторінок, що посилаються
- seТип: string | null
_type тип пошукової системи
- clickstreamТип: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info дані clickstream для повернутого ключового слова
щоб отримати результати для цього поля, параметрinclude_clickstream_dataмає бути встановлено вtrue- ageТип: object | null
_distribution - propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- genderТип: object | null
_distribution - propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - monthlyТип: array (object | null)[] | null
_searches щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- searchТип: integer | null Формат: int64
_volume середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com
- keywordТип: string | null
повернута ідея ключового слова
- keywordТип: object | null · Response36Afe1097B20_KeywordInfo
_info дані за ключовим словом для повернутої ідеї ключового слова
- categoriesТип: array integer[] | null
- competitionТип: number | null
конкуренція
відносний рівень конкуренції за зазначеним ключовим словом. Значення базується на даних Google Ads і може перебувати в діапазоні від 0 до 1 включно - competitionТип: string | null
_level - cpcТип: number | null
ціна за клік
середня ціна за клік (USD), історично сплачена за ключове слово - highТип: number | null
_top _of _page _bid максимальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 80% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті - lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - lowТип: number | null
_top _of _page _bid мінімальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 20% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті - monthlyТип: array (object | null)[] | null
_searches щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- seТип: string | null
_type тип пошукової системи
- searchТип: integer | null Формат: int64
_volume середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com - searchТип: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend зміни тренду пошукового обсягу
зміна пошукового обсягу у відсотках порівняно з попереднім періодом- monthlyТип: integer | null
зміна обсягу пошуку у відсотках порівняно з попереднім місяцем
- quarterlyТип: integer | null
зміна обсягу пошуку у відсотках порівняно з попереднім кварталом
- yearlyТип: integer | null
зміна обсягу пошуку у відсотках порівняно з попереднім роком
- keywordТип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing містить обсяг пошуку за ключовим словом, нормалізований за обсягом пошуку Bing
- isТип: boolean | null
_normalized дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing
- lastТип: string | null
_updated _time дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00
- monthlyТип: array (object | null)[] | null
_searches помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року
- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- searchТип: integer | null
_volume поточний показник пошукового обсягу ключового слова
- keywordТип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream містить обсяг пошуку за ключовим словом, нормалізований за даними clickstream
- isТип: boolean | null
_normalized дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing
- lastТип: string | null
_updated _time дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00
- monthlyТип: array (object | null)[] | null
_searches помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року
- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- searchТип: integer | null
_volume поточний показник пошукового обсягу ключового слова
- keywordТип: object | null · Response36Afe1097B20_KeywordProperties
_properties додаткова інформація про ключове слово
- coreТип: string | null
_keyword основне ключове слово в групі
містить основне ключове слово в групі, визначеній алгоритмом кластеризації синонімів
якщо значення —null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні доkeyword - detectedТип: string | null
_language визначена мова ключового слова
указує мову ключового слова, визначену нашою системою - isТип: boolean | null
_another _language визначена мова ключового слова відрізняється від заданої
якщоtrue, мова, задана в запиті, не збігається з мовою, визначеною нашою системою для цього ключового слова - keywordТип: integer | null
_difficulty складність потрапляння до першої десятки органічних результатів за ключовим словом
показує ймовірність потрапляння до топ-10 органічних результатів за ключовим словом за логарифмічною шкалою від 0 до 100;
розраховується на основі аналізу, серед інших параметрів, посилальних профілів перших 10 сторінок у SERP;
докладніше про метрику — у цьому посібнику довідкового центру - seТип: string | null
_type тип пошукової системи
- synonymТип: string | null
_clustering _algorithm алгоритм, який використовується для визначення синонімів
можливі значення:keyword_metrics— алгоритм на основі параметрівkeyword_infotext_processing— текстовий алгоритм
якщо значення —null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні доkeyword - wordsТип: integer | null Формат: int64
_count кількість слів у ключовому слові
указує, зі скількох слів складається ключове слово
- languageТип: string | null
_code код мови в масиві POST
- locationТип: integer | null
_code код місцеположення в масиві POST
- seТип: string | null
_type тип пошукової системи
- searchТип: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignТип: array (string | null)[] | null
_intent додаткові пошукові інтенти
можливі значення:informational,navigational,commercial,transactional - lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - mainТип: string | null
_intent основний пошуковий інтент
можливі значення:informational,navigational,commercial,transactional - seТип: string | null
_type тип пошукової системи
- serpТип: object | null · Response36Afe1097B20_SerpInfo
_info дані SERP
значення будеnull, якщо ви не встановили полеinclude_serp_infoуtrueв масиві POST або якщо в нашій базі даних немає даних SERP для цього ключового слова- checkТип: string | null
_url прямий URL до результатів пошукової системи
за його допомогою можна переконатися, що ми надали точні результати - lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - previousТип: string | null
_updated _time дата й час, що передують останньому оновленню даних SERP
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-10-15 12:57:46 +00:00 - seТип: integer | null Формат: int64
_results _count кількість результатів пошуку за поверненим ключовим словом
- seТип: string | null
_type тип пошукової системи
- serpТип: array (string | null)[] | null
_item _types типи результатів пошуку в SERP
містить типи результатів пошуку (items), знайдених у SERP
можливі типи елементів: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;
примітка фактичні результати буде повернено лише для елементівorganic,paid,featured_snippetіlocal_pack
- seТип: string | null
_type тип пошукової системи
- itemsТип: integer | null Формат: int64
_count кількість результатів, повернутих у масиві
items - languageТип: string | null
_code код мови в масиві POST
- locationТип: integer | null
_code код місцеположення в масиві POST
- seТип: string | null
_type тип пошукової системи
- totalТип: integer | null Формат: int64
_count загальна кількість результатів у нашій базі даних, що відповідають вашому запиту
- resultТип: integer | null Формат: int64
_count кількість елементів у масиві result
- statusТип: integer | null
_code код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.
- statusТип: string | null
_message інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.
- timeТип: string | null
час виконання, секунди
- Тип: integer | null Формат: int64tasks
_count кількість завдань у масиві tasks
- Тип: integer | null Формат: int64tasks
_error кількість завдань у масиві tasks, повернутих з помилкою
- Тип: string | nulltime
загальний час виконання, секунди
- Тип: string | nullversion
поточна версія API
application/json - 400
Не вдалося обробити запит. Перевірте параметри запиту.
- 401
Потрібен дійсний API-ключ Felo.
- 402
Запит неможливо виконати: умови білінгу не виконано.
- 403
Обліковий запис не має дозволу на цю операцію.
- 429
Досягнуто ліміту запитів або витрат.
- 502
Служба не змогла виконати запит.
- 503
API або служба білінгу тимчасово недоступні.
- 504
Час очікування обробки запиту вичерпано.
- default
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/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
}
]
}
]
}
]
}