apple-app-store/
app-detail

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

Apple App Store App Detail API

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

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

README

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

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

  1. Подготовьте один или несколько публичных URL страниц приложений Apple App Store с хостом apps.apple.com или одним из его поддоменов.
  2. Отправьте массив urls методом POST на /v1/apple-app-store/app-detail и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
  4. Читайте записи приложений из 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.

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

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

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

Apple App Store App Detail API — FAQ

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

Передайте непустой массив urls со ссылками на страницы приложений, у которых распознанное имя хоста — apps.apple.com или один из его поддоменов. Этот эндпоинт не принимает ключевые слова, bundle ID, коды стран и поле results_limit.

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

Нет. Поставщик получает по одной входной строке на каждый отправленный URL, а задача сохраняет не более одной нормализованной записи на URL. next_cursor и has_more относятся только к чтению сохраненных результатов SocQ.

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