API App Store
Находите мобильные приложения и получайте сведения о текущей версии, примечания к выпуску и отзывы пользователей, чтобы отслеживать обновления.
Передайте числовой идентификатор и код страны, чтобы получить данные со страницы магазина. Метрики загрузок и исторические данные о выручке в них не входят.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия App Store: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите в App Store по названию или категории приложения. | $1.39 за 1 000 запросов | Норма |
Данные приложенияprofile | Получите страницу одного приложения в App Store по числовому app_id: разработчик, Bundle ID, версия, примечания к выпуску, цена, возрастной рейтинг и оценки текущей версии. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Читайте отзывы пользователей App Store о приложении. | $1.39 за 1 000 запросов | Норма |
Позиции приложения по ключевым словамkeywords_for_app | Получите поисковые ключевые слова App Store, по которым ранжируется одно приложение, по его числовому app_id. | $11.51 за 1 000 запросов | Норма |
Пакетное получение метрикbulk_metrics | Получите сводные показатели ранжирования по ключевым словам сразу для нескольких приложений App Store (до 20) по их числовым ID в app_ids. | $11.51 за 1 000 запросов | Норма |
Конкурентыcompetitors | Найдите приложения App Store, которые ранжируются по тем же поисковым ключевым словам, что и одно приложение, по его числовому app_id. | $11.51 за 1 000 запросов | Норма |
Пересечение ключевых словkeyword_intersection | Узнайте, по каким поисковым ключевым словам App Store ранжируются сразу от 2 до 10 приложений, по их числовым ID в app_ids. | $11.51 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API App Store?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите в App Store по названию или категории приложения. Получите ID, Bundle ID, разработчика, версию, цену, оценки и даты выпуска каждого приложения. В | keyword | country | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform · genres · languages · screenshot_urls |
profileДанные приложения Получите страницу одного приложения в App Store по числовому | app_id | country | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform · genres · languages · screenshot_urls |
reviewsОтзывы Читайте отзывы пользователей App Store о приложении. Для каждого отзыва доступны заголовок, текст, оценка в звёздах, автор, версия приложения, отметки «полезно» и дата. Сортируйте по | app_id | country, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=30, maxLimit=500. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · title · text · rating · rating_scale · author · app_version · helpful_count · posted_at · app_id · app_name · platform |
keywords_for_appПозиции приложения по ключевым словам Получите поисковые ключевые слова App Store, по которым ранжируется одно приложение, по его числовому | app_id | country | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 100. | $11.51 за 1 000 запросов | keyword · search_volume · search_rank · search_result_count · ranked_at · app_id · title · url · icon_url · developer · rating · rating_scale · rating_count · is_free · price · currency · total_keywords · platform |
bulk_metricsПакетное получение метрик Получите сводные показатели ранжирования по ключевым словам сразу для нескольких приложений App Store (до 20) по их числовым ID в | app_ids | country | Режим выдачи: Sync | — | $11.51 за 1 000 запросов | app_id · keyword_count · top1_keywords · top3_keywords · top10_keywords · keywords_search_volume · platform |
competitorsКонкуренты Найдите приложения App Store, которые ранжируются по тем же поисковым ключевым словам, что и одно приложение, по его числовому | app_id | country | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 100. | $11.51 за 1 000 запросов | app_id · shared_keywords · avg_position · shared_top10_keywords · shared_search_volume · keyword_count · top10_keywords · target_app_id · platform |
keyword_intersectionПересечение ключевых слов Узнайте, по каким поисковым ключевым словам App Store ранжируются сразу от 2 до 10 приложений, по их числовым ID в | app_ids | country | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 100. | $11.51 за 1 000 запросов | keyword · search_volume · search_result_count · ranked_at · rankings · total_keywords · platform |
Что означают параметры действия search в API App Store?
Ищите в App Store по названию или категории приложения. Получите ID, Bundle ID, разработчика, версию, цену, оценки и даты выпуска каждого приложения. В country укажите страну витрины App Store (по умолчанию США). Загрузки, выручка и история позиций по ключевым словам в результаты не входят.
keywordОбязательный- Задаёт поисковые слова App Store, например «трекер привычек» или название приложения, а не Bundle ID. Для последующих запросов сведений о приложении и отзывов используйте числовой app_id из результатов поиска.
countryНеобязательный- Выбирает витрину App Store для search, profile и reviews по двухбуквенному коду страны в нижнем регистре, например us, cn или jp. По умолчанию us. Параметр меняет запрашиваемую витрину, а не регион аккаунта или оплату в EveryInfra.
Что означают параметры действия profile в API App Store?
Получите страницу одного приложения в App Store по числовому app_id: разработчик, Bundle ID, версия, примечания к выпуску, цена, возрастной рейтинг и оценки текущей версии. Подойдёт и полная ссылка на приложение, а Bundle ID не подойдёт. Данные отражают текущую страницу в магазине, а не App Store Connect или прошлые версии.
app_idОбязательный- Задаёт числовой идентификатор приложения Apple, например цифры после id в ссылке на приложение. Можно также передать полный URL приложения в App Store, и платформа извлечёт числовой ID. Не передавайте Bundle ID в формате com.example.app.Apple: информация о приложении в App Store Connect — Apple разделяет Apple ID и Bundle ID приложения; Apple ID также используется в URL приложений в App Store. · Проверено
countryНеобязательный- Выбирает витрину App Store для search, profile и reviews по двухбуквенному коду страны в нижнем регистре, например us, cn или jp. По умолчанию us. Параметр меняет запрашиваемую витрину, а не регион аккаунта или оплату в EveryInfra.
Что означают параметры действия reviews в API App Store?
Читайте отзывы пользователей App Store о приложении. Для каждого отзыва доступны заголовок, текст, оценка в звёздах, автор, версия приложения, отметки «полезно» и дата. Сортируйте по newest (по умолчанию) или most_helpful. В country укажите страну витрины App Store.
app_idОбязательный- Задаёт числовой идентификатор приложения Apple, например цифры после id в ссылке на приложение. Можно также передать полный URL приложения в App Store, и платформа извлечёт числовой ID. Не передавайте Bundle ID в формате com.example.app.Apple: информация о приложении в App Store Connect — Apple разделяет Apple ID и Bundle ID приложения; Apple ID также используется в URL приложений в App Store. · Проверено
countryНеобязательный- Выбирает витрину App Store для search, profile и reviews по двухбуквенному коду страны в нижнем регистре, например us, cn или jp. По умолчанию us. Параметр меняет запрашиваемую витрину, а не регион аккаунта или оплату в EveryInfra.
sortНеобязательный- Задаёт порядок отображения отзывов App Store: newest для новых отзывов или most_helpful для самых полезных. Если параметр не указан, действие reviews использует newest. Параметр не фильтрует позиции приложений в поиске и оценки в звёздах, поэтому запросы search и profile не должны рассчитывать на него для изменения результатов.Допустимые значения:
most_helpfulnewest
Что означают параметры действия keywords_for_app в API App Store?
Получите поисковые ключевые слова App Store, по которым ранжируется одно приложение, по его числовому app_id. Для каждого ключевого слова указаны объём поиска, позиция приложения в выдаче, число приложений в результатах поиска и дата последнего обновления данных, а также рейтинг и цена приложения. Данные доступны только для App Store в США. По умолчанию 20 ключевых слов, максимум 100.
app_idОбязательный- Числовой ID приложения Apple, например
324684580, или ссылка на приложение на apps.apple.com, из которой берутся цифры после id. Bundle ID вида com.example.app не принимается и отклоняется до выполнения вызова. countryНеобязательный- Регион магазина для
keywords_for_app. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Что означают параметры действия bulk_metrics в API App Store?
Получите сводные показатели ранжирования по ключевым словам сразу для нескольких приложений App Store (до 20) по их числовым ID в app_ids. В каждой записи указаны keyword_count приложения, по скольким из этих ключевых слов оно занимает первое место, входит в топ-3 и в топ-10, и keywords_search_volume — суммарный объём поиска по ним. Данные доступны только для App Store в США; для приложения без данных о ключевых словах запись не возвращается.
app_idsОбязательный- Приложения для
bulk_metrics(от 1 до 20) илиkeyword_intersection(от 2 до 10): массив или строка через запятую с числовыми ID Apple, то есть цифрами после id в ссылке на приложение, например324684580. Поддерживается только магазин США. Вbulk_metricsкаждому приложению соответствует одна запись, а приложение без данных не включается; вkeyword_intersectionкаждая запись содержит одно ключевое слово, по которому ранжируются все приложения. Другое количество отклоняется до выполнения вызова. countryНеобязательный- Регион магазина для
bulk_metrics. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Что означают параметры действия competitors в API App Store?
Найдите приложения App Store, которые ранжируются по тем же поисковым ключевым словам, что и одно приложение, по его числовому app_id. Для каждого конкурента указано, сколько ключевых слов у них общих, его средняя позиция по ним, по скольким из них он входит в топ-10 и их суммарный объём поиска, а также его собственные итоги по ключевым словам. Данные доступны только для App Store в США, а записи содержат ID приложений, а не названия. По умолчанию 20 конкурентов, максимум 100.
app_idОбязательный- Задаёт числовой идентификатор приложения Apple, например цифры после id в ссылке на приложение. Можно также передать полный URL приложения в App Store, и платформа извлечёт числовой ID. Не передавайте Bundle ID в формате com.example.app.
countryНеобязательный- Регион магазина для
competitors. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Что означают параметры действия keyword_intersection в API App Store?
Узнайте, по каким поисковым ключевым словам App Store ранжируются сразу от 2 до 10 приложений, по их числовым ID в app_ids. Каждая запись содержит один общий keyword с объёмом поиска, числом приложений в выдаче по нему, а в rankings указаны позиция и название каждого приложения. Данные доступны только для App Store в США. По умолчанию 20 ключевых слов, максимум 100.
app_idsОбязательный- Приложения для
bulk_metrics(от 1 до 20) илиkeyword_intersection(от 2 до 10): массив или строка через запятую с числовыми ID Apple, то есть цифрами после id в ссылке на приложение, например324684580. Поддерживается только магазин США. Вbulk_metricsкаждому приложению соответствует одна запись, а приложение без данных не включается; вkeyword_intersectionкаждая запись содержит одно ключевое слово, по которому ранжируются все приложения. Другое количество отклоняется до выполнения вызова. countryНеобязательный- Регион магазина для
keyword_intersection. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Как использовать API App Store
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"app_store","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API App Store
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Как превратить данные отзывов в платный продукт: от отзывов в магазинах приложений к решениям по версиям
Как построить платный продукт на основе спарсенных отзывов? На примере анализа отзывов в магазинах приложений разбираем карточки с доказательствами, тикеты поддержки, ревью версий, границы сервиса и проверку продлений, а не только оценки тональности и облака слов.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API App Store
Какие данные можно получить через API App Store?
Укажите в platform значение app_store. В текущем каталоге: поиск, данные приложения, отзывы, позиции приложения по ключевым словам, пакетное получение метрик и more. Эти названия действий соответствуют разным объектам или представлениям App Store; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе App Store?
Задаёт поисковые слова App Store, например «трекер привычек» или название приложения, а не Bundle ID. Для последующих запросов сведений о приложении и отзывов используйте числовой app_id из результатов поиска. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе App Store?
Объявленная схема включает app_id, name, bundle_id и developer. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия App Store возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.