Apple App Store App Detail
Страницы приложений в Apple App Store — это публичные карточки продукта с данными о приложении, текстом описания, сведениями о разработчике и категории, видимыми рейтингами, ценами и медиафайлами. Эти поля помогают обогащать каталоги, сравнивать страницы приложений и отслеживать метаданные на определенный момент времени.
Возможности Apple App Store App Detail API
- Пакетная отправка известных URLОтправляйте один или несколько URL страниц приложений на apps.apple.com: каждый очищенный URL становится одним входом для поставщика, и на каждый отправленный URL сохраняется не более одной нормализованной записи приложения.
- Идентификация и описательные метаданныеВозвращает ID приложения, название, текст описания, разработчика, категорию, URL источника и время сбора в единой схеме приложения.
- Видимые рейтинги и ценыСохраняет доступные поля рейтинга, числа отзывов и структурированной цены, чтобы сравнивать записи без разбора текста страниц.
- Медиафайлы и контекст каталогаХранит доступные медиафайлы страницы вместе с временем публикации и сбора и не заполняет значения схемы, которые публичная страница не показывает.
Параметры Apple App Store App Detail API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный массив из одного или нескольких известных URL страниц приложений. Каждый непустой элемент должен указывать на apps.apple.com или один из его поддоменов; ключевые слова, bundle ID и коды стран этот эндпоинт не принимает. |
Как использовать Apple App Store App Detail API
Отправьте известные URL страниц приложений, отслеживайте асинхронную задачу и читайте нормализованные записи приложений из сохраненных страниц результатов.
- Подготовьте один или несколько публичных URL страниц приложений Apple App Store с хостом apps.apple.com или одним из его поддоменов.
- Отправьте массив urls методом POST на /v1/apple-app-store/app-detail и сохраните возвращенный 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/app-detail" \
-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 only while has_more is trueСценарии использования Apple App Store App Detail API
- Обогащение каталога приложений: Добавляйте нормализованные данные о приложении, описательные метаданные, разработчика, категорию, цены, медиафайлы и URL источника к записям, в которых уже есть известные ссылки на App Store.
- Сравнение страниц приложений: Сравнивайте разработчиков и категории, видимые рейтинги, число отзывов, цены и тексты описаний в выбранном наборе URL.
- Мониторинг снимков метаданных: Сохраняйте повторные результаты с collected_at, чтобы отслеживать изменения названий, описаний, категорий, видимых рейтингов, цен и медиафайлов со временем.
Практические советы по Apple App Store App Detail API
- Проверяйте, что каждое распознанное имя хоста — apps.apple.com, и отправляйте URL страниц приложений, а не поисковые запросы, bundle ID или названия магазинов.
- Удаляйте дубликаты URL перед отправкой, чтобы повторные входы не создавали лишних строк у поставщика и дублирующихся записей приложений.
- Считайте rating, reviews_count, price, media, published_at, installs и rank допускающими null: страница может показывать только часть схемы приложения.
- Не считайте next_cursor токеном страницы App Store: он только перелистывает результаты, уже сохраненные для завершенной задачи SocQ.
Связанные API
Помимо Apple App Store App Detail API, используйте эти API, когда нужен другой тип публичных данных Apple App Store.
- Apple App Store App Reviews API — Собирайте публичные отзывы о приложениях по известным URL apps.apple.com: нормализованный текст, оценки, данные автора, метки времени и ссылки на приложение.
- Apple App Store Rankings API — Собирайте публичные позиции в чартах категорий по поддерживаемым URL Apple App Store: позиция в источнике, данные приложения, разработчик, рейтинг, число отзывов, цена и медиа.