Apple App Store Rankings
Les classements par catégorie de l’Apple App Store sont des listes publiques ordonnées d’applications, avec rang, identité de l’application, développeur, catégorie, note, nombre d’avis, prix et visuels. Ces enregistrements servent à surveiller les classements, à enrichir un catalogue classé et à comparer le contexte public de la boutique associé à chaque position.
Fonctionnalités de la Apple App Store Rankings API
- Découverte à partir d’URL de classements par catégorieUtilisez une ou plusieurs URL publiques apps.apple.com de catégories ou de classements comme point de départ pour obtenir les applications classées que ces pages exposent.
- Position et identité de l’applicationGardez chaque rang d’origine disponible à côté de l’ID, du nom et de l’URL publique de l’application, afin que les résultats ordonnés restent identifiables.
- Contexte du développeur et de la catégorieObtenez avec chaque enregistrement d’application normalisé le nom du développeur ou de l’éditeur et la catégorie de la boutique, lorsqu’ils sont disponibles.
- Signaux visibles de la boutiqueIncluez la note, le nombre d’avis et les valeurs de prix structurées lorsque le résultat public du classement les expose.
- Descriptions et visuelsConservez le texte et les références média disponibles de l’application dans le même schéma d’application fixe que le reste du résultat.
Paramètres de la Apple App Store Rankings API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau obligatoire d’URL publiques de classements de l’Apple App Store. Chaque nom d’hôte analysé doit être apps.apple.com ou l’un de ses sous-domaines, et chaque chemin doit contenir /charts/. |
results_limit | Facultatif | Plafond global facultatif pour la tâche, de 1 à 2 000. Le backend utilise 100 lorsque ce champ est omis. |
Comment utiliser la Apple App Store Rankings API
Partez d’une URL publique de classement par catégorie de l’Apple App Store, fixez le plafond global de résultats, puis lisez les enregistrements d’applications normalisés une fois la tâche réussie.
- Saisissez une ou plusieurs URL publiques de classements apps.apple.com dont le chemin contient /charts/ ; l’exemple fourni respecte la règle de validation du backend.
- Définissez results_limit de 1 à 2 000, ou omettez-le pour appliquer la valeur par défaut du backend, soit 100 résultats.
- Envoyez la charge utile en POST à /v1/apple-app-store/rankings, conservez task_id et interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec de la tâche.
- Lisez data.results.items et demandez la page de résultats stockés suivante avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/rankings" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/iphone/charts/6007"],"results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Apple App Store Rankings API
- Surveillance des classements par catégorie : Stockez le rang, l’identité de l’application et collected_at issus d’exécutions répétées pour distinguer des instantanés de classement à des instants différents.
- Enrichissement d’un catalogue d’applications classées : Rattachez ID d’application, noms, développeurs, catégories, URL de la boutique, descriptions et visuels aux entrées découvertes dans un classement.
- Comparaison du contexte de la boutique : Comparez les champs de rang, de note, de nombre d’avis et de prix disponibles entre les applications renvoyées par un même classement de catégorie.
Conseils d’expert pour la Apple App Store Rankings API
- Utilisez une URL de classement apps.apple.com dont le chemin contient /charts/. Les URL de détail d’une application et les chemins sans rapport échouent à la validation avant le début de la collecte.
- Envoyez des tâches séparées lorsque chaque classement a besoin de son propre quota, car results_limit plafonne le total de lignes enregistrées pour la tâche, même si urls contient plusieurs classements.
- N’utilisez next_cursor que pour parcourir les résultats SocQ stockés ; il ne demande pas une autre page de classement au fournisseur et n’étend pas le plafond de résultats initial.
- Lancez séparément les classements qui se recoupent si vous devez conserver chaque occurrence, car une tâche dédoublonne les enregistrements sauvegardés par ID d’application ou par URL source.
- Considérez description, note, nombre d’avis, prix, visuels et autres champs facultatifs comme nullables, et omettez les valeurs vides dans vos affichages en aval.
API associées
En complément de la Apple App Store Rankings API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Apple App Store.
- Apple App Store App Detail API — Récupérez l’identité publique d’une application, ses métadonnées descriptives, le contexte du développeur et de la catégorie, les notes visibles, le prix et les médias à partir d’URL de fiches App Store connues, sous forme normalisée.
- 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.