# Массовые метрики приложений App Store (live)
**API:** Data API
**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/apple/bulk_app_metrics/live`
**Tags:** DataForSEO
Рейтинги, отзывы и оценки установок для многих приложений App Store за один вызов. Здесь нет параметра limit, но оплата идёт за вызов, а не за элемент, поэтому отправляйте весь список сразу. Ответ обёрнут в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. Аналог для Google Play: `post_dataforseo_labs_google_bulk_app_metrics_live`.
### Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.1356.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Только справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
## Base URL
- `https://openapi.felo.ai`
## Authentication
- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)
## Request body
Required: **no**
### application/json
Schema:
```json
{
"type": "array",
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"type": "object",
"properties": {
"app_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "идентификаторы приложений
обязательное поле
идентификаторы мобильных приложений в App Store;
идентификатор можно найти в URL каждого приложения, размещённого в App Store;
пример:
в URL https://apps.apple.com/us/app/id835599320
идентификатор — 835599320;
максимальное количество идентификаторов, которое можно указать в этом поле, — 1000"
},
"location_name": {
"type": "string",
"description": "полное название местоположения
обязательное поле, если не указан location_code
Примечание: необходимо указать location_name или location_code
список доступных местоположений с location_name можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примечание: этот эндпоинт сейчас поддерживает только местоположение США;
пример:
United States"
},
"location_code": {
"type": "integer",
"description": "код местоположения
обязательное поле, если не указан location_name
Примечание: необходимо указать location_name или location_code
список доступных местоположений с location_code можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примечание: этот эндпоинт сейчас поддерживает только местоположение США;
пример:
2840"
},
"language_name": {
"type": "string",
"description": "полное название языка
обязательное поле, если не указан language_code
Примечание: необходимо указать language_name или language_code
список доступных языков с language_name можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примечание: этот эндпоинт сейчас поддерживает только английский язык;
пример:
English"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "код языка
обязательное поле, если не указан language_name
Примечание: необходимо указать language_name или language_code
список доступных языков с language_code можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примечание: этот эндпоинт сейчас поддерживает только английский язык
пример:
en"
},
"tag": {
"type": [
"string",
"null"
],
"description": "пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значение tag вы найдёте в объекте data ответа"
}
},
"example": [
{
"app_ids": [
"686449807",
"382617920"
],
"language_name": "English",
"location_code": 2840
}
]
}
]
},
"example": [
{
"app_ids": [
"686449807",
"382617920"
],
"language_name": "English",
"location_code": 2840
}
]
}
```
## Responses
### 200 — Успешная операция
Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveResponseInfo"
}
]
}
```
### 400 — Запрос не удалось обработать. Проверьте параметры запроса.
### 401 — Требуется действительный API-ключ Felo.
### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.
### 403 — Аккаунту не разрешено выполнять эту операцию.
### 429 — Достигнут лимит запросов или расходов.
### 502 — Сервис не смог выполнить запрос.
### 503 — API или сервис биллинга временно недоступны.
### 504 — Истекло время ожидания обработки запроса.
### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_AppMetricsInfo
`#/components/schemas/Response36Afe1097B20_AppMetricsInfo`
```json
{
"type": "object",
"properties": {
"pos_1": {
"type": [
"integer",
"null"
],
"description": "количество органических SERP, где товар занимает позицию №1"
},
"pos_2_3": {
"type": [
"integer",
"null"
],
"description": "количество органических SERP, где товар занимает позиции №2-3"
},
"pos_4_10": {
"type": [
"integer",
"null"
],
"description": "количество органических SERP, где товар занимает позиции №4-10"
},
"pos_11_100": {
"type": [
"integer",
"null"
],
"description": "количество органических SERP, где товар занимает позиции №11-100"
},
"count": {
"type": [
"integer",
"null"
],
"description": "общее количество органических SERP Amazon, содержащих товар",
"format": "int64"
},
"search_volume": {
"type": [
"integer",
"null"
],
"description": "общий объем поиска ключевых слов, по которым товар ранжируется в органическом SERP",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "текущая версия API"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "общий код состояния.\nПолный список кодов ответа можно найти здесь."
},
"status_message": {
"type": [
"string",
"null"
],
"description": "общее информационное сообщение.\nПолный список общих информационных сообщений можно найти здесь."
},
"time": {
"type": [
"string",
"null"
],
"description": "общее время выполнения, секунды"
},
"cost": {
"type": [
"number",
"null"
],
"description": "общая стоимость задач, USD",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "число задач в массиве tasks",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "число задач в массиве tasks, возвращённых с ошибкой",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "идентификатор задачи\nуникальный идентификатор задачи в нашей системе в формате UUID"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "код состояния задачи\nформируется DataForSEO, может находиться в диапазоне 10000-60000\nПолный список кодов ответа можно найти здесь."
},
"status_message": {
"type": [
"string",
"null"
],
"description": "информационное сообщение задачи\nПолный список общих информационных сообщений можно найти здесь."
},
"time": {
"type": [
"string",
"null"
],
"description": "время выполнения, секунды"
},
"cost": {
"type": [
"number",
"null"
],
"description": "общая стоимость задач, USD",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "число элементов в массиве result",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "путь URL"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "содержит те же параметры, что вы указали в POST-запросе"
}
}
}
```
### Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveResponseInfo
`#/components/schemas/Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveTaskInfo"
}
]
},
"description": "массив задач"
}
}
}
]
}
```
### Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveResultInfo
`#/components/schemas/Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveResultInfo`
```json
{
"type": "object",
"properties": {
"se_type": {
"type": [
"string",
"null"
],
"description": "тип поисковой системы"
},
"location_code": {
"type": [
"integer",
"null"
],
"description": "код местоположения в массиве POST"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "код языка в массиве POST"
},
"total_count": {
"type": [
"integer",
"null"
],
"description": "общее количество результатов в нашей базе данных, соответствующих вашему запросу",
"format": "int64"
},
"items_count": {
"type": [
"integer",
"null"
],
"description": "количество результатов, возвращённых в массиве items",
"format": "int64"
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem"
}
]
},
"description": "содержит данные о метриках ранжирования указанного приложения"
}
}
}
```
### Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveTaskInfo
`#/components/schemas/Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsAppleBulkAppMetricsLiveResultInfo"
}
]
},
"description": "массив результатов"
}
}
}
]
}
```
### Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem
`#/components/schemas/Response36Afe1097B20_DataforseoLabsleBulkAppMetricsLiveItem`
```json
{
"type": "object",
"properties": {
"se_type": {
"type": [
"string",
"null"
],
"description": "тип поисковой системы"
},
"app_id": {
"type": [
"string",
"null"
],
"description": "id приложения в массиве POST"
},
"metrics": {
"type": [
"object",
"null"
],
"additionalProperties": {
"$ref": "#/components/schemas/Response36Afe1097B20_AppMetricsInfo"
},
"description": "метрики по ключевым словам ранжирования приложения
данные ранжирования по ключевым словам, для которых указанное приложение ранжируется в Google Play"
}
}
}
```