Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Google Play: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите приложения в Google Play по названию или сценарию использования. | $1.39 за 1 000 запросов | Норма |
Данные приложенияprofile | Найдите Android-приложение в Google Play по имени пакета. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Получайте отзывы пользователей об Android-приложении в Google Play: оценку, текст, число лайков, версию приложения, язык и ответ разработчика, если он есть. | $1.39 за 1 000 запросов | Норма |
Позиции приложения по ключевым словамkeywords_for_app | Получайте поисковые запросы Google Play, по которым ранжируется одно Android-приложение, по имени пакета в app_id. | $11.51 за 1 000 запросов | Норма |
Пакетное получение метрикbulk_metrics | Получайте сводные данные о ранжировании по ключевым словам не более чем для 20 Android-приложений за один запрос, указав имена пакетов в app_ids, например com.spotify.music. | $11.51 за 1 000 запросов | Норма |
Конкурентыcompetitors | Получайте приложения Google Play, которые конкурируют с одним Android-приложением за те же поисковые запросы, по имени пакета в app_id. | $11.51 за 1 000 запросов | Норма |
Книгиbooks | Ищите книги в Google Play, указывая название, автора или тему в keyword. | $0.56 за 1 000 запросов | Норма |
Игрыgames | Просматривайте Android-игры в Google Play по рейтингу бесплатных, платных или самых кассовых игр, по игровой категории, например GAME_PUZZLE, либо по поисковому запросу. | $0.56 за 1 000 запросов | Норма |
Пересечение ключевых словkeyword_intersection | Сравнивайте от 2 до 10 Android-приложений по поисковым запросам Google Play, по которым ранжируются все они, передав имена пакетов в app_ids. | $11.51 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Google Play?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите приложения в Google Play по названию или сценарию использования. Получайте ID пакета, разработчика, рейтинг, диапазон установок, цену, категорию, возрастной рейтинг и дату последнего обновления. Используйте возвращённый | keyword | country, language, page_token | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. Записей на странице: до 100. | $1.39 за 1 000 запросов | app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram |
profileДанные приложения Найдите Android-приложение в Google Play по имени пакета. Получайте версию, минимальную версию Android, цену, наличие рекламы и встроенных покупок, гистограмму оценок и политику конфиденциальности. Передавайте значение после ?id= в URL Play, например com.example.app, а не полную ссылку. | app_id | country, language | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram |
reviewsОтзывы Получайте отзывы пользователей об Android-приложении в Google Play: оценку, текст, число лайков, версию приложения, язык и ответ разработчика, если он есть. Сортируйте по | app_id | country, language, page_token, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=40, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. Записей на странице: до 200. | $1.39 за 1 000 запросов | id · app_id · text · title · score · author_name · author_avatar_url · thumbs_up · reply_text · reply_at · app_version · language · url · posted_at · platform |
keywords_for_appПозиции приложения по ключевым словам Получайте поисковые запросы Google Play, по которым ранжируется одно Android-приложение, по имени пакета в | 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Пакетное получение метрик Получайте сводные данные о ранжировании по ключевым словам не более чем для 20 Android-приложений за один запрос, указав имена пакетов в | app_ids | country | Режим выдачи: Sync | — | $11.51 за 1 000 запросов | app_id · keyword_count · top1_keywords · top3_keywords · top10_keywords · keywords_search_volume · platform |
competitorsКонкуренты Получайте приложения Google Play, которые конкурируют с одним Android-приложением за те же поисковые запросы, по имени пакета в | 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 |
booksКниги Ищите книги в Google Play, указывая название, автора или тему в | keyword | country, language | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=40. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 40. | $0.56 за 1 000 запросов | book_id · title · author · url · format · category · rating · rating_scale · price · currency · cover_url · description · platform |
gamesИгры Просматривайте Android-игры в Google Play по рейтингу бесплатных, платных или самых кассовых игр, по игровой категории, например GAME_PUZZLE, либо по поисковому запросу. Укажите только один из параметров | category, chart, country, keyword, language | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 50. | $0.56 за 1 000 запросов | rank · app_id · name · url · developer · category · score · installs · price · is_free · currency · icon_url · description · platform | |
keyword_intersectionПересечение ключевых слов Сравнивайте от 2 до 10 Android-приложений по поисковым запросам Google Play, по которым ранжируются все они, передав имена пакетов в | app_ids | country | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 100. | $11.51 за 1 000 запросов | keyword · search_volume · ranked_at · rankings · total_keywords · platform |
Что означают параметры действия search в API Google Play?
Ищите приложения в Google Play по названию или сценарию использования. Получайте ID пакета, разработчика, рейтинг, диапазон установок, цену, категорию, возрастной рейтинг и дату последнего обновления. Используйте возвращённый app_id для получения деталей и отзывов. installs — нижняя граница диапазона, а не точное число.
keywordОбязательный- Запрос по названию приложения или сценарию использования в Google Play, например
note taking. Это не точный поиск по имени пакета. Для сведений о приложении и отзывов используйтеapp_id. countryНеобязательный- Страна или регион витрины Google Play, код в нижнем регистре, например us. По умолчанию us. Для search и profile меняет запрашиваемую витрину, а не регион телефона пользователя или страну разработчика. Для reviews не влияет на то, какие отзывы возвращаются: отзывы зависят только от
language, поэтому us и gb при одном языке возвращают одинаковые отзывы. Чтобы сравнить отзывы на разных рынках, меняйтеlanguage, а не толькоcountry. languageНеобязательный- Язык контента Play Store и запросов отзывов, например en или zh. По умолчанию en. Страну автоматически не меняет и не гарантирует, что все возвращённые отзывы написаны на этом языке.
page_tokenНеобязательный- Токен пагинации: чтобы получить следующую страницу, передайте next_page_token из предыдущего ответа; для первой страницы не указывайте его. Остальные параметры не меняйте. Токены действуют 24 часа, каждая страница — это один вызов.
Что означают параметры действия profile в API Google Play?
Найдите Android-приложение в Google Play по имени пакета. Получайте версию, минимальную версию Android, цену, наличие рекламы и встроенных покупок, гистограмму оценок и политику конфиденциальности. Передавайте значение после ?id= в URL Play, например com.example.app, а не полную ссылку.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеapp_idОбязательный- Имя пакета Android из значения
?id=в URL Play Store, напримерcom.example.app. Это не числовой ID Apple App Store. Передавайте имя пакета, а не полный URL Play. countryНеобязательный- Страна или регион витрины Google Play, код в нижнем регистре, например us. По умолчанию us. Для search и profile меняет запрашиваемую витрину, а не регион телефона пользователя или страну разработчика. Для reviews не влияет на то, какие отзывы возвращаются: отзывы зависят только от
language, поэтому us и gb при одном языке возвращают одинаковые отзывы. Чтобы сравнить отзывы на разных рынках, меняйтеlanguage, а не толькоcountry. languageНеобязательный- Язык контента Play Store и запросов отзывов, например en или zh. По умолчанию en. Страну автоматически не меняет и не гарантирует, что все возвращённые отзывы написаны на этом языке.
Что означают параметры действия reviews в API Google Play?
Получайте отзывы пользователей об Android-приложении в Google Play: оценку, текст, число лайков, версию приложения, язык и ответ разработчика, если он есть. Сортируйте по newest или top_rated и листайте через page_token, до 200 записей.
app_idОбязательный- Имя пакета Android из значения
?id=в URL Play Store, напримерcom.example.app. Это не числовой ID Apple App Store. Передавайте имя пакета, а не полный URL Play.Google Play: оценки приложений, отзывы пользователей и ответы разработчиков — Официальная документация поясняет, что пользователи могут обновлять оценки и отзывы, а отзывы могут быть связаны с версиями приложения, отметками «полезно» и ответами разработчиков. Публичные отзывы появляются с задержкой из-за модерации, а отзывы тестировщиков не публикуются. Возможности официальной консоли и API для ответов не совпадают с возможностями этого эндпоинта. · Проверено countryНеобязательный- Страна или регион витрины Google Play, код в нижнем регистре, например us. По умолчанию us. Для search и profile меняет запрашиваемую витрину, а не регион телефона пользователя или страну разработчика. Для reviews не влияет на то, какие отзывы возвращаются: отзывы зависят только от
language, поэтому us и gb при одном языке возвращают одинаковые отзывы. Чтобы сравнить отзывы на разных рынках, меняйтеlanguage, а не толькоcountry. languageНеобязательный- Язык контента Play Store и запросов отзывов, например en или zh. По умолчанию en. Страну автоматически не меняет и не гарантирует, что все возвращённые отзывы написаны на этом языке.
page_tokenНеобязательный- Токен пагинации: чтобы получить следующую страницу, передайте next_page_token из предыдущего ответа; для первой страницы не указывайте его. Остальные параметры не меняйте. Токены действуют 24 часа, каждая страница — это один вызов.
sortНеобязательный- Порядок отзывов о приложении:
newest(сначала новые) илиtop_rated(сначала с высокой оценкой); для отзывов по умолчаниюnewest. В каталоге этот параметр указан также у search и profile, но это не ранжирование поиска приложений и не фильтр по общему рейтингу.Допустимые значения:newesttop_rated
Что означают параметры действия keywords_for_app в API Google Play?
Получайте поисковые запросы Google Play, по которым ранжируется одно Android-приложение, по имени пакета в app_id. Для каждого ключевого слова указаны объём поиска, позиция приложения в выдаче и время последнего обновления данных, а также рейтинг и цена приложения. Только магазин США; общее число результатов по ключевому слову недоступно. По умолчанию 20 ключевых слов, максимум 100.
app_idОбязательный- Имя пакета Android, например
com.spotify.music, или ссылка на приложение на play.google.com с ?id=. Числовой ID Apple не подходит; любое другое значение, кроме имени пакета или такой ссылки, отклоняется до выполнения вызова. countryНеобязательный- Регион магазина для
keywords_for_app. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Что означают параметры действия bulk_metrics в API Google Play?
Получайте сводные данные о ранжировании по ключевым словам не более чем для 20 Android-приложений за один запрос, указав имена пакетов в app_ids, например com.spotify.music. Каждая запись показывает, по скольким поисковым запросам Google Play ранжируется приложение, сколько из них находятся на позиции 1, входят в топ-3 и топ-10, а также их суммарный объём поиска. Данные доступны только для магазина США; для приложения без данных о ключевых словах запись не возвращается.
app_idsОбязательный- Приложения для
bulk_metrics(от 1 до 20) илиkeyword_intersection(от 2 до 10): массив или строка с именами пакетов Android, разделёнными запятыми. Имя пакета — это значение после ?id= в ссылке Play Store, напримерcom.spotify.music. Поддерживается только магазин США. Вbulk_metricsкаждому приложению соответствует одна запись, а приложения без данных пропускаются; вkeyword_intersectionкаждая запись соответствует одному ключевому слову, по которому ранжируются все указанные приложения. Если количество приложений выходит за указанные пределы, запрос отклоняется до выполнения вызова. countryНеобязательный- Регион магазина для
bulk_metrics. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Что означают параметры действия competitors в API Google Play?
Получайте приложения Google Play, которые конкурируют с одним Android-приложением за те же поисковые запросы, по имени пакета в app_id. Записи показывают общие ключевые слова, среднюю позицию по ним, общие ключевые слова в топ-10 и общий объём поиска, а также собственные итоговые показатели каждого конкурента по ключевым словам. Только магазин США, вместо названий приложений — ID пакетов. По умолчанию 20 конкурентов, максимум 100.
app_idОбязательный- Имя пакета Android-приложения, конкурентов которого нужно найти, например
com.spotify.music, или ссылка на него на play.google.com с ?id=. Числовой ID Apple и любые другие значения, кроме имени пакета или такой ссылки, отклоняются до выполнения вызова. countryНеобязательный- Регион магазина для
competitors. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Что означают параметры действия books в API Google Play?
Ищите книги в Google Play, указывая название, автора или тему в keyword. Для каждой книги возвращаются ID, автор, формат, категория, рейтинг, цена с валютой, обложка и описание. Магазин выбирайте с помощью country, а язык — с помощью language. Возвращается одна страница, на ней до 40 книг; пагинации нет.
keywordОбязательный- Что искать в Google Play Книгах: название, автора или тему, например
stoicism. countryНеобязательный- Страна или регион витрины Google Play, код в нижнем регистре, например us. По умолчанию us. Для search и profile меняет запрашиваемую витрину, а не регион телефона пользователя или страну разработчика. Для reviews не влияет на то, какие отзывы возвращаются: отзывы зависят только от
language, поэтому us и gb при одном языке возвращают одинаковые отзывы. Чтобы сравнить отзывы на разных рынках, меняйтеlanguage, а не толькоcountry. languageНеобязательный- Язык контента Play Store и запросов отзывов, например en или zh. По умолчанию en. Страну автоматически не меняет и не гарантирует, что все возвращённые отзывы написаны на этом языке.
Что означают параметры действия games в API Google Play?
Просматривайте Android-игры в Google Play по рейтингу бесплатных, платных или самых кассовых игр, по игровой категории, например GAME_PUZZLE, либо по поисковому запросу. Укажите только один из параметров chart, category или keyword; если не указать ни одного, вернётся рейтинг бесплатных игр. Для каждой игры указаны позиция, ID пакета, разработчик, оценка, диапазон установок, цена и описание. По умолчанию возвращается 20 игр, максимум 50; доступна только одна страница.
categoryНеобязательный- Категория игр для
games, напримерGAME_PUZZLEилиGAME_ACTION; подходит и короткая формаpuzzleилиaction. Используйте вместоchartилиkeyword, а не вместе с ними. chartНеобязательный- Чарт игр для
games:top_free(по умолчанию, если ничего другого не указано),top_paidилиtop_grossing. Используйте вместоcategoryилиkeyword, а не вместе с ними. countryНеобязательный- Страна или регион витрины Google Play, код в нижнем регистре, например us. По умолчанию us. Для search и profile меняет запрашиваемую витрину, а не регион телефона пользователя или страну разработчика. Для reviews не влияет на то, какие отзывы возвращаются: отзывы зависят только от
language, поэтому us и gb при одном языке возвращают одинаковые отзывы. Чтобы сравнить отзывы на разных рынках, меняйтеlanguage, а не толькоcountry. keywordНеобязательный- Поисковый запрос по играм, например
chess. Используйте его вместоchartилиcategory, а не вместе с ними. languageНеобязательный- Язык контента Play Store и запросов отзывов, например en или zh. По умолчанию en. Страну автоматически не меняет и не гарантирует, что все возвращённые отзывы написаны на этом языке.
Что означают параметры действия keyword_intersection в API Google Play?
Сравнивайте от 2 до 10 Android-приложений по поисковым запросам Google Play, по которым ранжируются все они, передав имена пакетов в app_ids. Каждая запись — одно общее ключевое слово keyword с объёмом поиска и, в rankings, позицией и названием каждого приложения. Только магазин США; Google Play не сообщает число результатов по ключевому слову. По умолчанию 20 ключевых слов, максимум 100.
app_idsОбязательный- Приложения для
bulk_metrics(от 1 до 20) илиkeyword_intersection(от 2 до 10): массив или строка с именами пакетов Android, разделёнными запятыми. Имя пакета — это значение после ?id= в ссылке Play Store, напримерcom.spotify.music. Поддерживается только магазин США. Вbulk_metricsкаждому приложению соответствует одна запись, а приложения без данных пропускаются; вkeyword_intersectionкаждая запись соответствует одному ключевому слову, по которому ранжируются все указанные приложения. Если количество приложений выходит за указанные пределы, запрос отклоняется до выполнения вызова. countryНеобязательный- Регион магазина для
keyword_intersection. Поддерживается только магазин США: не передавайте параметр или укажите us. Любая другая страна отклоняется до выполнения вызова.
Как использовать API Google Play
- 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":"google_play","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API Google Play
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Как превратить данные отзывов в платный продукт: от отзывов в магазинах приложений к решениям по версиям
Как построить платный продукт на основе спарсенных отзывов? На примере анализа отзывов в магазинах приложений разбираем карточки с доказательствами, тикеты поддержки, ревью версий, границы сервиса и проверку продлений, а не только оценки тональности и облака слов.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API Google Play
Какие данные можно получить через API Google Play?
Укажите в platform значение google_play. В текущем каталоге: поиск, данные приложения, отзывы, позиции приложения по ключевым словам, пакетное получение метрик и more. Эти названия действий соответствуют разным объектам или представлениям Google Play; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Google Play?
Запрос по названию приложения или сценарию использования в Google Play, например note taking. Это не точный поиск по имени пакета. Для сведений о приложении и отзывов используйте app_id. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Google Play?
Объявленная схема включает app_id, name, summary и description. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Google Play возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.