apple-app-store/
app-reviews

Collectez les avis publics de l’Apple App Store à partir d’une ou plusieurs URL apps.apple.com et obtenez texte, notes, détails sur les auteurs, horodatages et contexte de l’application sous forme d’enregistrements normalisés.

Apple App Store App Reviews API

URL d’applications connues
Texte et notes des avis publics
Contexte de l’auteur et de l’application
0,15 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlsObligatoireListe 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_limitFacultatifEntier 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.

  1. 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.
  2. Envoyez la charge utile en POST à /v1/apple-app-store/app-reviews et conservez le task_id renvoyé.
  3. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que le statut vaille succeeded ou failed.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Apple App Store avec les données publiques d’autres plateformes sociales prises en charge.

Apple App Store App Reviews API — FAQ

Apple App Store App Reviews API est une interface programmatique qui collecte les avis clients publics à partir d’URL d’applications de l’Apple App Store connues. Elle renvoie le texte des avis, les notes, les détails sur les auteurs, les horodatages, les médias et les références d’application, lorsqu’ils sont disponibles, sous forme normalisée.

urls est obligatoire et doit contenir une ou plusieurs références non vides dont le nom d’hôte analysé est apps.apple.com ou un sous-domaine ; les formes absolues et relatives au protocole sont acceptées. results_limit est facultatif, vaut 100 par défaut et accepte les entiers de 1 à 2 000.

Non. results_limit plafonne le total des enregistrements stockés pour la tâche, sur l’ensemble de la liste d’URL envoyée ; répartissez donc vos objectifs de collecte en plusieurs tâches si des plafonds indépendants comptent.

Non. next_cursor parcourt les enregistrements déjà stockés par SocQ une fois la tâche réussie ; la requête publique n’expose aucun curseur du fournisseur pour obtenir d’autres pages en amont.

Chaque avis enregistré avec succès coûte 0,15 crédit SocQ, avec une estimation de 100 résultats lorsque results_limit est omis. Une tâche sans avis enregistré n’entraîne aucun frais de résultat, car la base configurée est de zéro.