google-play/
app-reviews

Собирайте публичные отзывы о приложениях Google Play по URL приложений на play.google.com с необязательным контекстом страны: текст отзыва, авторы, оценки, метки времени и ссылки на приложение в виде нормализованных записей.

Google Play App Reviews API

Пакеты URL приложений
Текст отзывов и оценки
Контекст страны
0,15 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Google Play App Reviews

Отзывы о приложениях Google Play — это публичные оценки в магазине приложений, в которых письменный отзыв и оценка в звездах связаны с данными автора, временем публикации и ссылкой на оцениваемое приложение. Такие записи помогают исследовать обратную связь, сравнивать оценки, отслеживать реакцию на релизы и строить датасеты отзывов с привязкой к источнику.

Возможности Google Play App Reviews API

  • URL нескольких приложений на входеПринимает один или несколько URL приложений на play.google.com и распределяет запрошенное число отзывов между отправленными приложениями.
  • Содержание отзыва и оценкаВозвращает текст и числовую оценку каждого доступного отзыва в единообразной записи отзыва.
  • Контекст автора и времениСохраняет вместе с отзывом доступные данные автора, ссылку на профиль, время публикации и время сбора.
  • Привязка к оцениваемому приложениюСвязывает нормализованные отзывы с доступными идентификаторами приложений и публичными URL приложений через subject_id и subject_url.

Параметры Google Play App Reviews API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный массив из одного или нескольких непустых URL приложений на play.google.com или его поддоменах.
countryНеобязательныйНеобязательная строка, передаваемая источнику отзывов как контекст страны; не указывайте ее, если контекст рынка не нужен.
results_limitНеобязательныйНеобязательное положительное целое число от 1 до 2 000. По умолчанию 100; ограничивает общее число сохраненных результатов по всем отправленным URL.

Как использовать Google Play App Reviews API

Отправьте URL приложений Google Play, отслеживайте асинхронную задачу и постранично читайте нормализованные записи, сохраненные SocQ.

  1. Подготовьте один или несколько публичных URL приложений, у которых имя хоста — play.google.com или один из его поддоменов.
  2. Отправьте urls с необязательными country и results_limit методом POST на /v1/google-play/app-reviews и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой; не отправляйте новую задачу во время опроса.
  4. После успешного завершения читайте data.results.items и передавайте next_cursor обратно в маршрут задачи, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Google Play App Reviews API

  • Исследование тем отзывов: Используйте тексты отзывов и оценки, чтобы подготовить корпус с привязкой к источнику для качественного кодирования или последующего анализа текста.
  • Сравнение оценки и текста: Сопоставляйте письменные отзывы с соответствующей числовой оценкой на выбранных публичных страницах приложений.
  • Мониторинг хронологии отзывов: Сочетайте время публикации и время сбора, чтобы сравнивать отдельно собранные выборки отзывов вокруг релизов продукта.
  • Обогащение датасетов приложений: Добавляйте к записям приложений поля автора, текста, оценки и меток времени с помощью subject_id и subject_url.

Практические советы по Google Play App Reviews API

  • Используйте полные публичные URL приложений на play.google.com; другие хосты не проходят проверку входных данных еще до начала сбора.
  • При отправке нескольких URL выбирайте results_limit как цель для всей задачи: запросы к источнику делятся между приложениями, а итоговое сохранение ограничено глобально.
  • Указывайте country, только если важен контекст рынка, и сохраняйте одно и то же значение в повторных сборах, которые собираетесь сравнивать.
  • Для получения следующих сохраненных записей используйте next_cursor из ответа задачи; это курсор результатов SocQ, а не курсор, который принимает источник отзывов.
  • Считайте необязательные поля автора, ссылки на источник и медиафайлов допускающими null и не заменяйте отсутствующие значения выдуманными.

Помимо Google Play App Reviews API, используйте эти API, когда нужен другой тип публичных данных Google Play.

  • Google Play App Detail API — Получайте нормализованные публичные данные карточки Google Play по известным URL приложений: название, описание в магазине, разработчик, категория, видимые метрики, цена, медиа и контекст сбора.
  • Google Play App Rankings API

Другие платформы

Объединяйте данные Google Play с публичными данными других поддерживаемых соцсетей.

Google Play App Reviews API — FAQ

Google Play App Reviews API — это программный интерфейс для сбора публичных отзывов по одному или нескольким отправленным URL приложений Google Play с необязательным контекстом страны. Он возвращает нормализованные тексты отзывов, данные авторов, оценки, время публикации, медиафайлы и ссылки на оцениваемое приложение.

urls — обязательный массив непустых URL, у которых имя хоста — play.google.com или его поддомен. country — необязательная строка, которая передается в запрос к источнику, ее можно не указывать.

По умолчанию results_limit равен 100 и принимает целые числа от 1 до 2 000. Запрос к источнику распределяет запрошенное число между отправленными URL, а SocQ ограничивает общее число сохраненных результатов задачи запрошенным лимитом.

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

Курсор источника от вызывающей стороны не принимается. После успешного завершения асинхронной задачи next_cursor и has_more листают строки результатов, уже сохраненные SocQ.

Если results_limit не указан, задача оценивается в 100 результатов, а каждый сохраненный результат стоит 0,15 кредита SocQ. Итоговое списание считается по фактическому числу результатов, а успешный пустой результат стоит по нулевой базовой ставке.