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, отслеживайте асинхронную задачу и после завершения читайте нормализованные записи приложений.
- Подготовьте непустой массив urls со ссылками на приложения, у которых разобранное имя хоста — play.google.com или поддерживаемый поддомен.
- Отправьте массив методом POST на /v1/google-play/app-detail и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- После успешного завершения читайте 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 и пагинацию страниц источника.
Связанные API
Помимо Google Play App Detail API, используйте эти API, когда нужен другой тип публичных данных Google Play.
- Google Play App Rankings API
- Google Play App Reviews API — Собирайте публичные отзывы о приложениях по URL play.google.com с необязательным указанием страны: нормализованные поля текста, автора, оценки, времени и ссылки на приложение.