google-play/
app-reviews

Collectez les avis publics d’applications Google Play à partir d’URL play.google.com, avec contexte de pays facultatif, et obtenez texte d’avis, auteurs, notes, horodatages et références d’application dans des enregistrements normalisés.

Google Play App Reviews API

Lots d’URL d’applications
Texte et notes des avis
Contexte de pays
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

Google Play App Reviews

Les avis Google Play sont des évaluations publiques d’applications qui associent un commentaire rédigé et une note en étoiles à l’identité de l’auteur, à la date de publication et à la référence de l’application évaluée. Ces enregistrements servent à étudier les retours des utilisateurs, à comparer des notes, à surveiller des versions et à constituer des jeux d’avis reliés à leur source.

Fonctionnalités de la Google Play App Reviews API

  • Entrée multi-applicationsAccepte une ou plusieurs URL d’applications play.google.com et répartit le nombre d’avis demandé entre les applications envoyées.
  • Contenu et note de l’avisRenvoie le texte et la note numérique de chaque avis disponible dans un enregistrement d’avis cohérent.
  • Auteur et contexte temporelConserve avec le retour l’identité de l’auteur, la référence de son profil, la date de publication et la date de collecte lorsqu’elles sont disponibles.
  • Traçabilité vers l’application évaluéeRelie les avis normalisés aux identifiants d’application et aux URL publiques disponibles via subject_id et subject_url.

Paramètres de la Google Play App Reviews API

ParamètresObligatoireDescription
urlsObligatoireTableau obligatoire d’une ou plusieurs URL d’applications non vides sur play.google.com ou ses sous-domaines.
countryFacultatifChaîne facultative transmise à la source des avis comme contexte de pays ; omettez-la si aucun contexte de marché n’est nécessaire.
results_limitFacultatifEntier positif facultatif de 1 à 2 000. Il vaut 100 par défaut et plafonne le total des résultats stockés pour toutes les URL envoyées.

Comment utiliser la Google Play App Reviews API

Envoyez des URL d’applications Google Play, suivez la tâche asynchrone et parcourez les enregistrements normalisés stockés par SocQ.

  1. Préparez une ou plusieurs URL publiques d’applications dont le nom d’hôte est play.google.com ou l’un de ses sous-domaines.
  2. Envoyez urls, avec country et results_limit facultatifs, en POST à /v1/google-play/app-reviews, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue ; n’envoyez pas d’autre tâche pendant l’interrogation.
  4. Après le succès, lisez data.results.items et renvoyez next_cursor à la route de la tâche tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Google Play App Reviews API

  • Étude des thèmes de retours : Servez-vous du texte et des notes des avis pour préparer un corpus relié à sa source, destiné au codage qualitatif ou à une analyse de texte en aval.
  • Comparaison des notes et des textes : Comparez les commentaires rédigés avec la note numérique associée sur une sélection de pages publiques d’applications.
  • Suivi chronologique des avis : Combinez dates de publication et de collecte pour comparer des échantillons d’avis collectés séparément autour des sorties de versions.
  • Enrichissement de données liées aux applications : Rattachez les champs d’auteur, de texte, de note et d’horodatage aux fiches d’applications grâce à subject_id et subject_url.

Conseils d’expert pour la Google Play App Reviews API

  • Utilisez des URL publiques complètes d’applications sur play.google.com ; les autres hôtes échouent à la validation avant le début de la collecte.
  • Avec plusieurs URL, choisissez results_limit comme objectif pour toute la tâche : l’allocation côté source est répartie entre les applications envoyées et le stockage final est plafonné globalement.
  • Ne renseignez country que si le contexte de marché compte, et gardez la même valeur d’une collecte à l’autre pour celles que vous comptez comparer.
  • Suivez le next_cursor de la réponse de la tâche pour obtenir les enregistrements stockés supplémentaires ; c’est un curseur de résultats SocQ, non un curseur accepté par la source des avis.
  • Traitez les champs facultatifs d’auteur, de lien source et de médias comme nullables, au lieu de remplacer les valeurs manquantes par des valeurs par défaut inventées.

En complément de la Google Play App Reviews API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Play.

  • Google Play App Detail API — Récupérez les informations normalisées d’une fiche publique Google Play à partir d’URL d’applications connues, dont identité, textes de la fiche, développeur, catégorie, indicateurs visibles, prix, médias et contexte de collecte.
  • Google Play App Rankings API

Explorer d’autres plateformes

Combinez les données Google Play avec les données publiques d’autres plateformes sociales prises en charge.

Google Play App Reviews API — FAQ

Google Play App Reviews API est une interface programmatique qui collecte les avis publics d’une ou plusieurs URL d’applications Google Play envoyées, avec un contexte de pays facultatif. Elle renvoie le texte normalisé des avis, les informations sur l’auteur, les notes, les dates de publication, les médias et les références de l’application évaluée.

urls est un tableau obligatoire d’URL non vides dont le nom d’hôte est play.google.com ou un sous-domaine. country est une chaîne facultative transmise à la requête source, qui peut être omise.

results_limit vaut 100 par défaut et accepte les entiers de 1 à 2 000. La requête source répartit le nombre demandé entre les URL envoyées, tandis que SocQ plafonne le total des résultats stockés de la tâche à la limite demandée.

Un enregistrement normalisé peut contenir l’ID de l’avis, l’URL source, le texte, l’identité de l’auteur, la note numérique, les dates de publication et de collecte, l’identifiant de l’application, l’URL de l’application et des références de médias. Les champs facultatifs restent nuls ou vides lorsque le résultat public ne les fournit pas.

Aucun curseur source fourni par l’appelant n’est accepté. Une fois la tâche asynchrone réussie, next_cursor et has_more paginent des lignes de résultats déjà stockées par SocQ.

La tâche est estimée à 100 résultats lorsque results_limit est omis et coûte 0,15 crédit SocQ par résultat stocké. La facturation finale repose sur le nombre réel de résultats, et un résultat vide obtenu avec succès se règle à la base de zéro crédit.