google-play/
app-detail

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

Google Play App Detail API

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

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

README

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

Google Play App Detail

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

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

  • Пакет только из известных URLОтправляйте один или несколько URL приложений на play.google.com для прямого получения сведений, не превращая запрос в поиск по ключевым словам.
  • Идентификатор и тексты страницыНормализует идентификатор пакета, название приложения, публичное описание в магазине, разработчика, категорию, исходный URL и время сбора.
  • Видимый рыночный контекстСохраняет доступные поля оценки, числа отзывов, диапазона установок, цены и позиции как допускающие null наблюдения с публичной страницы.
  • Записи приложений с медиафайламиВозвращает медиафайлы вместе со стабильной схемой приложения, чтобы записи страниц проходили через тот же асинхронный процесс получения результатов, что и другие данные SocQ.

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

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

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

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

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

# Poll GET /v1/tasks/{task_id}
# Read normalized app records from data.results.items

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

  • Обогащение каталога известных приложений: Превращайте сохраненные ссылки Google Play в нормализованные ID пакетов, названия, описания, разработчиков, категории, исходные URL и метки времени сбора.
  • Сравнение выбранных страниц: Сопоставляйте доступные поля оценки, числа отзывов, диапазона установок, цены, категории и медиафайлов для утвержденного набора URL приложений.
  • Мониторинг снимков страниц: Повторяйте запросы по заданному расписанию и сравнивайте допускающие null поля страниц с collected_at, чтобы выявлять изменения на определенный момент.

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

  • Используйте полные URL приложений Google Play и убирайте дубли из массива перед отправкой, чтобы оценка отражала только нужные запросы.
  • Считайте, что каждый входной URL дает не больше одного результата, и сопоставляйте возвращенные записи по url или app_id: принятый URL всё равно может не дать ни одного элемента.
  • Храните оценку, число отзывов, диапазон установок, цену, позицию и медиафайлы с расчетом на пропуски: публичные поля страницы могут отсутствовать или меняться после сбора.
  • Используйте next_cursor только для дальнейшего чтения сохраненных результатов SocQ завершенной задачи; этот эндпоинт сведений не поддерживает поиск Google Play и пагинацию страниц источника.

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

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

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

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

Google Play App Detail API — FAQ

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

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

Нет. Он запрашивает сведения по каждому известному URL и может вернуть не больше одной нормализованной записи на URL. Принятый URL не гарантирует, что публичный элемент будет найден.

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

Оценка рассчитывается по числу отправленных URL — 0,15 кредита SocQ за каждый. Итоговое списание — 0,15 кредита за каждый возвращенный результат при нулевой базовой ставке, поэтому за успешную задачу без возвращенных записей итоговая плата составляет ноль кредитов.