Apple App Store App Detail
Les fiches de l’Apple App Store sont des pages produit publiques qui présentent l’identité d’une application, son texte descriptif, le contexte du développeur et de la catégorie, les notes visibles, les tarifs et les médias. Ces champs servent à enrichir un catalogue, à comparer des fiches et à suivre l’évolution des métadonnées à un instant donné.
Fonctionnalités de la Apple App Store App Detail API
- Saisie par lot d’URL connuesEnvoyez une ou plusieurs URL de pages produit apps.apple.com : chaque URL nettoyée correspond à une entrée du fournisseur, et au plus un enregistrement d’application normalisé est conservé par URL envoyée.
- Identité de la fiche et métadonnées descriptivesRenvoie l’ID de l’application, son nom, le texte de description, le développeur, la catégorie, l’URL source et l’heure de collecte dans un schéma d’application homogène.
- Contexte de note et de prix visibleConserve la note, le nombre d’avis et les champs de prix structurés lorsqu’ils sont disponibles, pour comparer des fiches sans analyser le texte des pages produit.
- Médias et contexte du catalogueGarde les médias disponibles de la fiche à côté des horodatages de publication et de collecte, et omet les valeurs du schéma que la page publique n’expose pas.
Paramètres de la Apple App Store App Detail API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau obligatoire d’une ou plusieurs URL de pages produit connues. Chaque élément non vide doit pointer vers apps.apple.com ou l’un de ses sous-domaines ; les mots-clés, les identifiants de bundle et les pays ne sont pas acceptés par cet endpoint. |
Comment utiliser la Apple App Store App Detail API
Envoyez des URL de fiches connues, suivez la tâche asynchrone, puis lisez les enregistrements d’applications normalisés depuis les pages de résultats stockées.
- Préparez une ou plusieurs URL de pages produit publiques de l’Apple App Store dont le nom d’hôte est apps.apple.com ou l’un de ses sous-domaines.
- Envoyez le tableau urls en POST à /v1/apple-app-store/app-detail et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez les enregistrements d’applications dans data.results.items et suivez next_cursor uniquement lorsque has_more vaut 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 trueCas d’usage de la Apple App Store App Detail API
- Enrichissement d’un catalogue d’applications : Associez identité normalisée, métadonnées descriptives, développeur, catégorie, tarifs, médias et URL sources à des enregistrements qui contiennent déjà des liens App Store connus.
- Comparaison de fiches : Comparez le contexte du développeur et de la catégorie, les notes visibles, les nombres d’avis, les tarifs et les textes descriptifs sur un ensemble d’URL sélectionné.
- Suivi de métadonnées par instantanés : Conservez des résultats successifs avec collected_at pour repérer les changements de noms, de descriptions, de catégories, de notes visibles, de tarifs et de médias au fil du temps.
Conseils d’expert pour la Apple App Store App Detail API
- Validez chaque nom d’hôte analysé par rapport à apps.apple.com et envoyez des URL de pages produit plutôt que des termes de recherche, des identifiants de bundle ou des noms de boutiques.
- Supprimez les URL en double avant l’envoi, afin que des entrées répétées ne créent ni lignes redondantes côté fournisseur ni enregistrements d’applications en double.
- Considérez rating, reviews_count, price, media, published_at, installs et rank comme nullables, car une fiche peut n’exposer qu’une partie du schéma d’application.
- Ne traitez pas next_cursor comme un jeton de page App Store en amont : il fait seulement avancer dans les résultats déjà stockés pour la tâche SocQ terminée.
API associées
En complément de la Apple App Store App Detail API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Apple App Store.
- Apple App Store App Reviews API — Collectez les avis publics d’applications à partir d’URL apps.apple.com connues, avec texte, notes, informations sur les auteurs, horodatages et références d’application normalisés.
- Apple App Store Rankings API — Collectez les entrées publiques des classements par catégorie à partir d’URL Apple App Store prises en charge, avec rang source, identité de l’application, développeur, note, nombre d’avis, prix et médias.