v0.2.0-beta

OpenAPI 3.1.0

Конкуренты приложений Google Play (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/google/app_competitors/live

Конкуренты приложений Google Play (live)

Приложения Google Play, конкурирующие с заданным приложением по общим ключевым словам. Страницы с limit, offset и offset_token; используйте токен после первых страниц. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Аналог для Apple — post_dataforseo_labs_apple_app_competitors_live. Для ключевых слов за пересечением используйте post_dataforseo_labs_google_app_intersection_live.

Справочные цены

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

Только справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Тело

application/json

Тип: array (object | null)[]
- app_id
  Тип: string
  
  идентификатор приложения
  обязательное поле
  идентификатор мобильного приложения в Google Play;
  идентификатор можно найти в URL каждого приложения, размещённого в Google Play;
  пример:
  в URL https://play.google.com/store/apps/details?id=org.telegram.messenger
  идентификатор — org.telegram.messenger
- filters
  Тип: array (object | null)[] | null
  
  массив параметров фильтрации результатов
  необязательное поле
  можно добавить несколько фильтров сразу (не более 8 фильтров)
  между условиями нужно задать логический оператор and или or
  поддерживаются следующие операторы:
  <, <=, >, >=, =, <>, in, not_in
  пример:
  ["intersections",">",500]
  
  [["competitor_metrics.google_play_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]
  
  [[["intersections",">=",50],"and",["competitor_metrics.google_play_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_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo
cost
Тип: number | null Формат: double

общая стоимость задач, USD

status_code
Тип: integer | null

общий код состояния. Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.

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

массив задач

Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo
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

Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

application/json

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

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "org.telegram.messenger",
    "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
            }
          ]
        }
      ]
    }
  ]
}

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

Нужна помощь?

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

Конкуренты приложений Google Play (live)

АутентификацияRequired

DataForSEO

Конкуренты приложений Google Play (live)

Справочные цены

Нужна помощь?