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 приложений, отслеживайте асинхронную задачу и постранично читайте записи отзывов, сохраненные для завершенной задачи.
- Подготовьте хотя бы одну ссылку на приложение с распознанным именем хоста apps.apple.com и при необходимости выберите results_limit от 1 до 2 000.
- Отправьте данные методом POST на /v1/apple-app-store/app-reviews и сохраните возвращенный task_id.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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 в последующих интерфейсах.
Связанные API
Помимо 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: позиция в источнике, данные приложения, разработчик, рейтинг, число отзывов, цена и медиа.