Apple App Store App Reviews
Les avis sur les applications de l’Apple App Store sont des retours clients publics, avec un texte rédigé, une note, l’identité de leur auteur, une date de publication et des liens vers l’application évaluée. Ces enregistrements servent à analyser les retours, à comparer des notes, à enrichir un catalogue d’applications et à suivre leur évolution dans le temps.
Fonctionnalités de la Apple App Store App Reviews API
- Lots d’URL d’applications connuesEnvoyez une ou plusieurs URL de produits apps.apple.com dans une même tâche et fixez un seul results_limit pour le total des avis enregistrés à partir de cette requête.
- Avis publics normalisésLisez le texte de l’avis, la note chiffrée, l’identité de l’auteur, les médias éventuels et les champs d’enregistrement stables grâce au schéma d’avis commun.
- Contexte de l’application et de la collecteRattachez chaque avis disponible à l’identifiant de son sujet ou à l’URL de l’application, avec les horodatages de publication et de collecte pour des instantanés traçables.
Paramètres de la Apple App Store App Reviews API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire de références d’applications non vides dont le nom d’hôte analysé est apps.apple.com ou l’un de ses sous-domaines ; les valeurs absolues et relatives au protocole sont acceptées, séparées par des virgules ou des retours à la ligne dans le Playground. |
results_limit | Facultatif | Entier positif facultatif de 1 à 2 000 qui plafonne le total des avis enregistrés pour la tâche ; la valeur par défaut du backend est 100. |
Comment utiliser la Apple App Store App Reviews API
Envoyez des URL d’applications connues, suivez la tâche asynchrone, puis parcourez page par page les avis stockés pour la tâche terminée.
- Préparez au moins une référence d’application dont le nom d’hôte analysé est apps.apple.com et choisissez éventuellement un results_limit de 1 à 2 000.
- Envoyez la charge utile en POST à /v1/apple-app-store/app-reviews et conservez le task_id renvoyé.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que le statut vaille succeeded ou failed.
- Lisez data.results.items et poursuivez avec next_cursor tant que has_more vaut 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 trueCas d’usage de la Apple App Store App Reviews API
- Analyse des retours sur une application : Appuyez-vous sur le texte rédigé, les valeurs de note et le contexte de l’auteur pour examiner les retours publics renvoyés pour des pages d’applications connues.
- Comparaison des notes entre applications : Regroupez les enregistrements normalisés par identifiant de sujet ou par URL d’application, puis comparez la répartition des notes entre les produits envoyés.
- Instantanés chronologiques des avis : Gardez les horodatages de publication et de collecte avec les ID d’avis pour distinguer les enregistrements récemment collectés des instantanés précédents.
Conseils d’expert pour la Apple App Store App Reviews API
- Vérifiez que chaque entrée a pour hôte apps.apple.com avant l’envoi ; les sous-domaines et les références relatives au protocole sont acceptés, tandis que les autres hôtes sont rejetés.
- Choisissez results_limit pour la tâche dans son ensemble et non par application ; sans valeur, la requête utilise 100, et la plage acceptée va jusqu’à 2 000.
- Utilisez next_cursor uniquement pour lire d’autres résultats SocQ stockés ; il ne demande pas une autre page au fournisseur et ne prolonge pas la collecte en amont.
- Considérez un texte, des détails d’auteur, une note, des références d’application ou des médias manquants comme inconnus, et omettez les champs null dans vos affichages en aval.
API associées
En complément de la Apple App Store App Reviews 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 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.