apple-app-store/
rankings

Собирайте публичные рейтинги категорий Apple App Store по известным URL чартов apps.apple.com и получайте позицию, данные о приложении, метаданные магазина и медиафайлы в виде нормализованных записей.

Apple App Store Rankings API

URL чартов категорий
Позиция в источнике
Нормализованные записи приложений
0,15 кредита за результат
Готово
Готово

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

README

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

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, задайте общий лимит результатов и после успешного завершения задачи читайте сохраненные нормализованные записи приложений.

  1. Укажите один или несколько публичных URL рейтингов на apps.apple.com, путь которых содержит /charts/; приведенный пример проходит проверку на бэкенде.
  2. Задайте results_limit от 1 до 2 000 или не указывайте его, чтобы использовать значение бэкенда по умолчанию — 100 результатов.
  3. Отправьте данные методом POST на /v1/apple-app-store/rankings, сохраните task_id и опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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 и не выводите пустые значения в последующих интерфейсах.

Помимо 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: нормализованный текст, оценки, данные автора, метки времени и ссылки на приложение.

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

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

Apple App Store Rankings API — FAQ

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

Отправляйте публичные URL рейтингов с хостом apps.apple.com или его поддоменом, путь которых содержит /charts/. URL отдельных приложений и посторонние пути отклоняются при проверке входных данных.

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

Это общий лимит задачи от 1 до 2 000; если он не указан, используется 100. Число сохраненных результатов может быть меньше, если в чартах меньше строк или записи удаляются как дубликаты.

Нет. next_cursor читает следующую страницу результатов, уже сохраненных SocQ; этот эндпоинт не предоставляет курсор поставщика для продолжения исходного сбора по чарту.

Каждый успешно сохраненный нормализованный результат приложения стоит 0,15 кредита SocQ. Оценка запроса строится по results_limit (или по 100, если он не указан), а неиспользованные предоплаченные кредиты возвращаются при окончательном расчете задачи.