Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Google Play Отзывы

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Получайте отзывы пользователей об Android-приложении в Google Play: оценку, текст, число лайков, версию приложения, язык и ответ разработчика, если он есть. Сортируйте по newest или top_rated и листайте через page_token, до 200 записей.

Google Play Reviews получает отзывы пользователей об одном Android-приложении по имени пакета в app_id. Каждая запись содержит текст отзыва, оценку в звёздах, отображаемое имя и аватар автора, число людей, отметивших отзыв как полезный, номер версии приложения, время публикации, а также ответ разработчика и время ответа. Команды приложений, продакт-менеджеры и исследователи рынка используют эту возможность, чтобы отслеживать, о чём пишут пользователи после каждого релиза, сравнивать приложения в категории и видеть, как быстро отвечают разработчики.

app_id — значение после ?id= в ссылке на Play Store, например com.whatsapp. Оценка находится в score и всегда выставляется по пятибалльной шкале. language задаёт язык запроса, по умолчанию английский, и именно он влияет на то, какие отзывы вернутся, хотя не гарантирует, что каждый отзыв написан на этом языке. country по умолчанию указывает магазин США, но на отзывы не влияет: us и gb возвращают одни и те же отзывы при одинаковом language, поэтому сравнивайте рынки, меняя language. sort по умолчанию выводит сначала самые новые отзывы (newest), а со значением top_rated ставит вперёд высокие оценки.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Google Play Отзывы (google_play/reviews).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: google_play и action: reviews, а параметры передайте в params.
- Обязательные параметры:
  - app_id: Имя пакета Android из значения ?id= в URL Play Store, например com.example.app. Это не числовой ID Apple App Store. Передавайте имя пакета, а не полный URL Play.
- Необязательные параметры:
  - country: Страна или регион витрины Google Play, код в нижнем регистре, например us. По умолчанию us. Для search и profile меняет запрашиваемую витрину, а не регион телефона пользователя или страну разработчика.
  - language: Язык контента Play Store и запросов отзывов, например en или zh. По умолчанию en. Страну автоматически не меняет и не гарантирует, что все возвращённые отзывы написаны на этом языке.
  - page_token: Токен пагинации: чтобы получить следующую страницу, передайте next_page_token из предыдущего ответа; для первой страницы не указывайте его. Остальные параметры не меняйте.
  - sort: Порядок отзывов о приложении: newest (сначала новые) или top_rated (сначала с высокой оценкой); для отзывов по умолчанию newest. (допустимые значения: newest / top_rated)
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 200. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 40)
- Возвращает список записей. Основные поля каждой записи: id, app_id, text, title, score, author_name, author_avatar_url, thumbs_up, reply_text, reply_at, app_version, language; всего полей: 14, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=google_play.
- Пример тела запроса:
{
  "platform": "google_play",
  "action": "reviews",
  "params": {
    "app_id": "com.whatsapp"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаgoogle_playИдентификатор платформы, фиксированное значение.
actionbodystringДаreviewsИдентификатор возможности, фиксированное значение.
app_idbody.paramsstringДа-Имя пакета Android из значения ?id= в URL Play Store, например com.example.app. Это не числовой ID Apple App Store. Передавайте имя пакета, а не полный URL Play.
countrybody.paramsstringНет-Страна или регион витрины Google Play, код в нижнем регистре, например us. По умолчанию us. Для search и profile меняет запрашиваемую витрину, а не регион телефона пользователя или страну разработчика. Для reviews не влияет на то, какие отзывы возвращаются: отзывы зависят только от language, поэтому us и gb при одном языке возвращают одинаковые отзывы. Чтобы сравнить отзывы на разных рынках, меняйте language, а не только country.
languagebody.paramsstringНет-Язык контента Play Store и запросов отзывов, например en или zh. По умолчанию en. Страну автоматически не меняет и не гарантирует, что все возвращённые отзывы написаны на этом языке.
page_tokenbody.paramsstringНет-Токен пагинации: чтобы получить следующую страницу, передайте next_page_token из предыдущего ответа; для первой страницы не указывайте его. Остальные параметры не меняйте. Токены действуют 24 часа, каждая страница — это один вызов.
sortbody.paramsstring (enum)Нет-Порядок отзывов о приложении: newest (сначала новые) или top_rated (сначала с высокой оценкой); для отзывов по умолчанию newest. В каталоге этот параметр указан также у search и profile, но это не ранжирование поиска приложений и не фильтр по общему рейтингу.Допустимые значенияnewesttop_rated
limitbody.paramsinteger (1–200)Нет40Максимальное число записей в этом вызове, целое число от 1 до 200. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "google_play",
  "action": "reviews",
  "params": {
    "app_id": "com.whatsapp"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "google_play",
  "action": "reviews",
  "results": [
    {
      "id": "65d39096-b59c-4d75-9f8f-00e98b8a49df",
      "app_id": "com.whatsapp",
      "text": "77u7uuiuuu u 7k788",
      "score": 3,
      "author_name": "•••",
      "author_avatar_url": "https://play-lh.googleusercontent.com/•••",
      "thumbs_up": 0,
      "app_version": "2.26.36.74",
      "url": "https://play.google.com/store/apps/details?id=com.whatsapp&reviewId=65d39096-b59c-4d75-9f8f-00e98b8a49df",
      "posted_at": "2026-09-25T09:37:51.158000+00:00",
      "platform": "google_play"
    },
    {
      "id": "b03244e4-a5e0-4db2-88ca-ef1e148ec30c",
      "app_id": "com.whatsapp",
      "text": "good",
      "score": 5,
      "author_name": "•••",
      "author_avatar_url": "https://play-lh.googleusercontent.com/•••",
      "thumbs_up": 0,
      "app_version": "2.23.11.77",
      "url": "https://play.google.com/store/apps/details?id=com.whatsapp&reviewId=b03244e4-a5e0-4db2-88ca-ef1e148ec30c",
      "posted_at": "2026-09-25T09:37:33.540000+00:00",
      "platform": "google_play"
    }
  ],
  "next_page_token": …,
  "pagination": { … },
  "count": 40,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
app_idТрактуется так же, как на самой платформе
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
scoreТрактуется так же, как на самой платформе
author_nameОтображаемое имя автора.
author_avatar_urlТрактуется так же, как на самой платформе
thumbs_upТрактуется так же, как на самой платформе
reply_textТрактуется так же, как на самой платформе
reply_atТрактуется так же, как на самой платформе
app_versionТрактуется так же, как на самой платформе
languageКод языка контента (например, zh, en) по определению платформы; может быть неточным.
urlСсылка на запись на платформе.
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Что передавать в app_id?

Имя пакета Android: значение после ?id= в ссылке на приложение в Play Store, например com.whatsapp. Не передавайте ссылку целиком: значение используется как имя пакета ровно в том виде, в каком отправлено, и URL не совпадёт ни с одним приложением. Числовые ID приложений из Apple App Store тоже не подойдут.

Как получить больше отзывов, чем помещается на одной странице?

Чтобы получить следующую страницу, передайте next_page_token из ответа обратно в page_token, не меняя app_id, country, language и sort; чтобы начать с первой страницы, не указывайте page_token. Токен действует 24 часа. Каждая страница — отдельный вызов, и страница без записей не оплачивается.

Как оценить, как разработчик отвечает на отзывы?

Отзывы, на которые ответил разработчик, содержат reply_text и reply_at. Посчитайте записи с ответом, чтобы получить долю ответов, и вычтите posted_at из reply_at, чтобы получить время ответа. Если разделить отзывы с низким score на отзывы с ответом и без ответа, станет видно, каким жалобам уделяют внимание.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Google Play: оценки приложений, отзывы пользователей и ответы разработчиков ↗

    Официальная документация поясняет, что пользователи могут обновлять оценки и отзывы, а отзывы могут быть связаны с версиями приложения, отметками «полезно» и ответами разработчиков. Публичные отзывы появляются с задержкой из-за модерации, а отзывы тестировщиков не публикуются. Возможности официальной консоли и API для ответов не совпадают с возможностями этого эндпоинта.

    Проверено 2026-09-04