v0.2.0-beta

OpenAPI 3.1.0

Конкуренти застосунків App Store (live)

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клієнтські бібліотеки

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

post/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live

Конкуренти застосунків App Store (live)

Застосунки App Store, що конкурують із заданим застосунком за спільними ключовими словами. Сторінки з limit, offset і offset_token; використовуйте токен після перших сторінок. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Аналог для Google Play: post_dataforseo_labs_google_app_competitors_live.

Довідкові ціни

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.1356.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло

application/json

Тип: array (object | null)[]
- app_id
  Тип: string
  
  ідентифікатор застосунку
  обов'язкове поле
  ідентифікатор мобільного застосунку в App Store;
  ідентифікатор можна знайти в URL кожного застосунку, розміщеного в App Store;
  приклад:
  в URL https://apps.apple.com/us/app/id835599320
  ідентифікатор — 835599320
- filters
  Тип: array (object | null)[] | null
  
  масив параметрів фільтрації результатів
  необов'язкове поле
  можна додати кілька фільтрів одразу (не більше 8 фільтрів)
  між умовами потрібно задати логічний оператор and або or
  підтримуються такі оператори:
  <, <=, >, >=, =, <>, in, not_in
  приклад:
  ["intersections",">",500]
  
  [["competitor_metrics.app_store_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]
  
  [[["intersections",">=",50],"and",["competitor_metrics.app_store_search_organic.pos_1","in",[1,5]]], "or", ["sum_position",">=","10000"]]
  
  докладніше про фільтри — в Dataforseo Labs - Filters або в цьому посібнику довідкового центру
  
  Порожній об'єкт
- language_code
  Тип: string | null
  
  код мови
  обов'язкове поле, якщо не вказано language_name
  Примітка: потрібно вказати language_name або language_code
  список доступних мов із language_code можна отримати окремим запитом до
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Примітка: цей ендпоінт наразі підтримує лише англійську мову
  приклад:
  en
- language_name
  Тип: string
  
  повна назва мови
  обов'язкове поле, якщо не вказано 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_code
  Тип: integer
  
  код місцезнаходження
  обов'язкове поле, якщо не вказано location_name
  Примітка: потрібно вказати location_name або location_code
  список доступних місцезнаходжень із location_code можна отримати окремим запитом до
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Примітка: цей ендпоінт наразі підтримує лише місцезнаходження США;
  приклад:
  2840
- location_name
  Тип: string
  
  повна назва місцезнаходження
  обов'язкове поле, якщо не вказано 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_by
  Тип: array string[] | null
  
  правила сортування результатів
  необов'язкове поле
  можна використовувати ті самі значення, що й у масиві filters, для сортування результатів;
  можливі типи сортування:
  asc - результати сортуються за зростанням;
  desc - результати сортуються за спаданням;
  для задання типу сортування використовуйте кому;
  приклад:
  ["intersections,asc"]
  Примітка: в одному запиті можна задати не більше трьох правил сортування;
  кілька правил сортування потрібно розділяти комою;
  приклад:
  ["intersections,desc","sum_position,asc"]
  
  правило за замовчуванням:
  ["intersections,desc"]
  Примітка: якщо масив item_types містить типи елементів, відмінні від organic, результати впорядковуються за першим типом елемента в масиві
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді

Відповіді

200
Тип: object | null · Response36Afe1097B20_DataforseoLabsAppleAppCompetitorsLiveResponseInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array (object | null)[] | null

масив завдань

Тип: object | null · Response36Afe1097B20_DataforseoLabsAppleAppCompetitorsLiveTaskInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

data
Тип: object | null

містить ті самі параметри, які ви вказали в POST-запиті

propertyName
Тип: object | null
id
Тип: string | null

ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

path
Тип: array (string | null)[] | null

шлях URL

result
Тип: array (object | null)[] | null

масив результатів

app_id
Тип: string | null

id застосунку в масиві POST

items
Тип: array (object | null)[] | null

містить дані, пов'язані з app_id і застосунками-конкурентами

app_id
Тип: string | null

id застосунку в масиві POST

avg_position
Тип: number | null Формат: float

середня позиція застосунку в SERP Google Play
Примітка: середня позиція розраховується лише за перетинними ключовими словами;
значення для конкретного застосунку може відрізнятися в поєднанні з іншими цільовими застосунками

competitor_metrics
Тип: object | null

метрики за перетинними ключовими словами
дані ранжування за ключовими словами, які вказаний застосунок-конкурент поділяє із застосунком у запиті POST;
примітка: у цьому масиві дані ранжування наведено для app_id повернутого конкурента

propertyName
Тип: object · Response36Afe1097B20_AppMetricsInfo
count
Тип: integer | null Формат: int64

загальна кількість органічних SERP Amazon, що містять товар

pos_1
Тип: integer | null

кількість органічних SERP, де товар посідає позицію №1

pos_11_100
Тип: integer | null

кількість органічних SERP, де товар посідає позиції №11-100

pos_2_3
Тип: integer | null

кількість органічних SERP, де товар посідає позиції №2-3

pos_4_10
Тип: integer | null

кількість органічних SERP, де товар посідає позиції №4-10

search_volume
Тип: integer | null Формат: int64

загальний обсяг пошуку ключових слів, за якими товар ранжується в органічному SERP

full_metrics
Тип: object | null

метрики за всіма ключовими словами застосунку
повний огляд даних ранжування за всіма ключовими словами, за якими ранжується вказаний app_id

propertyName
Тип: object · Response36Afe1097B20_AppMetricsInfo
count
Тип: integer | null Формат: int64

загальна кількість органічних SERP Amazon, що містять товар

pos_1
Тип: integer | null

кількість органічних SERP, де товар посідає позицію №1

pos_11_100
Тип: integer | null

кількість органічних SERP, де товар посідає позиції №11-100

pos_2_3
Тип: integer | null

кількість органічних SERP, де товар посідає позиції №2-3

pos_4_10
Тип: integer | null

кількість органічних SERP, де товар посідає позиції №4-10

search_volume
Тип: integer | null Формат: int64

загальний обсяг пошуку ключових слів, за якими товар ранжується в органічному SERP

intersections
Тип: integer | null

кількість перетинних ключових слів

se_type
Тип: string | null

тип пошукової системи

sum_position
Тип: integer | null

сума всіх позицій застосунку в SERP Google Play
Примітка: сума позицій розраховується лише за перетинними ключовими словами;
значення для конкретного застосунку може відрізнятися в поєднанні з іншими цільовими застосунками

items_count
Тип: integer | null Формат: int64

кількість результатів, повернутих у масиві items

language_code
Тип: string | null

код мови в масиві POST

location_code
Тип: integer | null

код місцеположення в масиві POST

se_type
Тип: string | null

тип пошукової системи

total_count
Тип: integer | null Формат: int64

загальна кількість результатів у нашій базі даних, що відповідають вашому запиту

result_count
Тип: integer | null Формат: int64

кількість елементів у масиві result

status_code
Тип: integer | null

код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

time
Тип: string | null

час виконання, секунди

tasks_count
Тип: integer | null Формат: int64

кількість завдань у масиві tasks

tasks_error
Тип: integer | null Формат: int64

кількість завдань у масиві tasks, повернутих з помилкою

time
Тип: string | null

загальний час виконання, секунди

version
Тип: string | null

поточна версія API
application/json
400

Не вдалося обробити запит. Перевірте параметри запиту.
401

Потрібен дійсний API-ключ Felo.
402

Запит неможливо виконати: умови білінгу не виконано.
403

Обліковий запис не має дозволу на цю операцію.
429

Досягнуто ліміту запитів або витрат.
502

Служба не змогла виконати запит.
503

API або служба білінгу тимчасово недоступні.
504

Час очікування обробки запиту вичерпано.
default

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

post/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "686449807",
    "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_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Успішна операція

Конкуренти застосунків App Store (live)

АвтентифікаціяRequired

DataForSEO

Конкуренти застосунків App Store (live)

Довідкові ціни