apple-app-store/
app-reviews

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

Apple App Store App Reviews API

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

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

README

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

Apple App Store App Reviews

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

Возможности Apple App Store App Reviews API

  • Пакеты известных URL приложенийОтправляйте один или несколько URL страниц приложений на apps.apple.com в одной задаче и задавайте один results_limit на общее число записей отзывов, сохраняемых по этому запросу.
  • Нормализованные публичные отзывыЧитайте текст отзыва, числовой рейтинг, данные об авторе, необязательные медиафайлы и стабильные поля записи в общей схеме отзывов.
  • Приложение и контекст сбораСвязывайте каждый доступный отзыв с идентификатором объекта или URL приложения, сохраняя время публикации и время сбора для отслеживаемых снимков.

Параметры Apple App Store App Reviews API

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

Как использовать Apple App Store App Reviews API

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

  1. Подготовьте хотя бы одну ссылку на приложение с распознанным именем хоста apps.apple.com и при необходимости выберите results_limit от 1 до 2 000.
  2. Отправьте данные методом POST на /v1/apple-app-store/app-reviews и сохраните возвращенный task_id.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items и продолжайте с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'

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

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

  • Анализ отзывов о приложениях: Используйте текст отзывов, значения рейтинга и данные об авторах, чтобы изучать публичную обратную связь, возвращенную для известных страниц приложений.
  • Сравнение рейтингов разных приложений: Группируйте нормализованные записи по идентификатору объекта или URL приложения, затем сравнивайте распределение рейтингов между отправленными приложениями.
  • Снимки хронологии отзывов: Сохраняйте время публикации и время сбора вместе с ID отзывов, чтобы отличать новые записи от более ранних снимков.

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

  • Перед отправкой проверяйте, что у каждого входа хост apps.apple.com; поддомены и ссылки относительно протокола принимаются, другие хосты отклоняются.
  • Выбирайте results_limit на всю задачу, а не на каждое приложение; если параметр не указан, используется 100, а допустимый диапазон заканчивается на 2 000.
  • Используйте next_cursor только для чтения дополнительных сохраненных результатов SocQ; он не запрашивает новую страницу у поставщика и не продолжает сбор в источнике.
  • Считайте отсутствующие текст, данные об авторе, рейтинг, ссылки на приложение или медиафайлы неизвестными и не выводите поля со значением null в последующих интерфейсах.

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

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

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

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

Apple App Store App Reviews API — FAQ

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

urls обязателен и должен содержать одну или несколько непустых ссылок с распознанным именем хоста apps.apple.com или его поддоменом; принимаются абсолютные ссылки и ссылки относительно протокола. results_limit необязателен, по умолчанию равен 100 и принимает целые числа от 1 до 2 000.

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

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

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