Apple App Store Rankings
Рейтинги категорий Apple App Store — это упорядоченные публичные списки приложений с полями позиции, данных о приложении, разработчика, категории, рейтинга, числа отзывов, цены и графики. Такие записи помогают отслеживать чарты, обогащать каталоги с учетом позиций и сравнивать публичный контекст магазина для каждой позиции.
Возможности Apple App Store Rankings API
- Сбор по URL чартов категорийИспользуйте один или несколько публичных URL категорий или рейтингов на apps.apple.com как входные данные для поиска приложений с позициями, которые показывают эти страницы.
- Позиция и данные о приложенииКаждая доступная позиция из источника хранится рядом с ID приложения, названием и публичным URL в магазине, поэтому упорядоченные результаты легко идентифицировать.
- Разработчик и категорияВозвращает доступное имя разработчика или издателя и категорию магазина в каждой нормализованной записи приложения.
- Видимые показатели магазинаВключает рейтинг, число отзывов и структурированную цену, если публичный результат чарта их показывает.
- Описания и графикаСохраняет доступный текст приложения и ссылки на медиафайлы в той же фиксированной схеме приложения, что и остальной результат.
Параметры Apple App Store Rankings API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный массив публичных URL рейтингов Apple App Store. Каждое распознанное имя хоста должно быть apps.apple.com или одним из его поддоменов, а каждый путь должен содержать /charts/. |
results_limit | Необязательный | Необязательный общий лимит задачи от 1 до 2 000. Если поле не указано, бэкенд использует 100. |
Как использовать Apple App Store Rankings API
Начните с публичного URL чарта категории Apple App Store, задайте общий лимит результатов и после успешного завершения задачи читайте сохраненные нормализованные записи приложений.
- Укажите один или несколько публичных URL рейтингов на apps.apple.com, путь которых содержит /charts/; приведенный пример проходит проверку на бэкенде.
- Задайте results_limit от 1 до 2 000 или не указывайте его, чтобы использовать значение бэкенда по умолчанию — 100 результатов.
- Отправьте данные методом POST на /v1/apple-app-store/rankings, сохраните task_id и опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и запрашивайте следующую сохраненную страницу результатов с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/rankings" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/iphone/charts/6007"],"results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Apple App Store Rankings API
- Мониторинг чартов категорий: Сохраняйте позицию, данные о приложении и collected_at из повторных запусков, чтобы различать снимки чарта на разные моменты времени.
- Обогащение каталога приложений с позициями: Добавляйте ID приложений, названия, разработчиков, категории, URL в магазине, описания и графику к записям, найденным в чарте.
- Сравнение контекста магазина: Сравнивайте доступные поля позиции, рейтинга, числа отзывов и цены у приложений из одного и того же чарта категории.
Практические советы по Apple App Store Rankings API
- Используйте URL рейтинга на apps.apple.com, путь которого содержит /charts/. URL отдельных приложений и посторонние пути не проходят проверку еще до начала сбора.
- Если каждому чарту нужна своя квота, отправляйте отдельные задачи: results_limit ограничивает общее число строк, сохраняемых для задачи, даже если в urls несколько чартов.
- Используйте next_cursor только для перелистывания сохраненных результатов SocQ; он не запрашивает у поставщика новую страницу чарта и не расширяет исходный лимит результатов.
- Если важно сохранить каждое появление приложения в каждом чарте, запускайте пересекающиеся чарты отдельно: задача удаляет дубликаты сохраненных записей по ID приложения или URL источника.
- Считайте описание, рейтинг, число отзывов, цену, графику и другие необязательные поля допускающими null и не выводите пустые значения в последующих интерфейсах.
Связанные API
Помимо Apple App Store Rankings API, используйте эти API, когда нужен другой тип публичных данных Apple App Store.
- Apple App Store App Detail API — Получайте по известным URL карточек App Store нормализованные публичные данные приложения, описательные метаданные, контекст разработчика и категории, видимые оценки, цены и медиа.
- Apple App Store App Reviews API — Собирайте публичные отзывы о приложениях по известным URL apps.apple.com: нормализованный текст, оценки, данные автора, метки времени и ссылки на приложение.