Google Play App Rankings
Une URL de classement Google Play désigne la catégorie ou la page de classement à collecter, tandis que results_limit règle la profondeur de découverte, de 1 à 2 000 enregistrements. Chaque résultat enregistré respecte le contrat AppItem : le rang peut ainsi être analysé à côté de l’identité du package, du développeur, de la catégorie, de la note, du nombre d’avis, des installations, du prix, des médias, de l’URL source et de la date de collecte, lorsqu’ils sont disponibles.
Fonctionnalités de la Google Play App Rankings API
- Lots d’URL de classementsEnvoyez un tableau urls non vide de pages publiques de catégorie ou de classement play.google.com, au lieu de champs distincts pour le pays ou la catégorie.
- Validation des URL de classement Google PlayL’exécution n’accepte play.google.com et ses sous-domaines que si le chemin contient /store/apps/collection/ ou /store/apps/category/.
- Collecte de classement bornéeUtilisez results_limit de 1 à 2 000. Omis, il prend la valeur 100, qui sert aussi d’estimation de facturation et de valeur de découverte par défaut du fournisseur.
- Positions d’applications normaliséesLisez rank avec app_id, name, developer, category, rating, reviews_count, installs, price, media et les métadonnées sources publiques disponibles, dans une seule structure AppItem.
- Workflow asynchrone sur jeu de donnéesLes lignes d’URL envoyées déclenchent un jeu de données asynchrone chez le fournisseur ; SocQ stocke les enregistrements normalisés et renvoie l’état de la tâche via le lecteur de tâches commun.
- Curseur sur les résultats stockésAprès le succès, paginez les enregistrements SocQ avec le next_cursor opaque du lecteur de tâches et un limit de 1 à 500. Ce curseur n’est pas un jeton de page de Google Play ni du fournisseur.
- Règlement sur les résultats réelsSocQ prélève d’abord l’estimation demandée ou par défaut, puis règle 0,15 crédit par résultat stocké et rembourse les crédits estimés non utilisés ; un résultat vide se règle à la base de zéro crédit.
Paramètres de la Google Play App Rankings API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau obligatoire et non vide d’URL de classement Google Play publiques. Chaque URL doit utiliser play.google.com ou l’un de ses sous-domaines et contenir /store/apps/collection/ ou /store/apps/category/ dans son chemin ; l’exécution n’accepte pas country ni category comme champs indépendants. |
results_limit | Facultatif | Entier positif facultatif de 1 à 2 000. Il vaut 100 par défaut, plafonne la découverte et les enregistrements stockés sur l’ensemble de la tâche, et fournit l’estimation de facturation initiale. Les URL d’entrée sont traitées dans l’ordre sur le quota restant de la tâche. |
Comment utiliser la Google Play App Rankings API
Envoyez une ou plusieurs URL de classements Google Play connues, suivez la tâche asynchrone et lisez les enregistrements de classement normalisés après le succès.
- Choisissez des URL publiques de catégorie ou de classement play.google.com dont le contexte de classement encode déjà le marché et la surface de collecte voulus.
- Envoyez urls et, facultativement, results_limit en POST à /v1/google-play/app-rankings, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed ; les résultats sont indisponibles tant que la tâche est en file d’attente ou en cours d’exécution.
- Lisez data.results.items et continuez avec next_cursor uniquement lorsque has_more vaut true.
curl -X POST "https://api.socq.ai/v1/google-play/app-rankings" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/collection/topselling_free"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Continue with GET /v1/tasks/{task_id}?cursor={next_cursor}&limit=50Cas d’usage de la Google Play App Rankings API
- Instantanés de classements par catégorie : Stockez rank et collected_at ensemble pour comparer des instantanés collectés séparément d’un classement Google Play connu.
- Découverte d’applications classées : Transformez un ensemble choisi d’URL de catégorie en fiches d’applications normalisées, destinées à la revue, à l’étiquetage ou à l’enrichissement d’un catalogue en aval.
- Contrôle de position d’un portefeuille : Rapprochez app_id et developer disponibles d’un portefeuille interne, puis examinez chaque position renvoyée sans vous fier au seul nom affiché.
- Analyse de la boutique d’une collecte à l’autre : Chargez les champs fixes AppItem dans un entrepôt de données pour que notes, nombres d’avis, installations, prix et rangs nullables restent comparables entre plusieurs collectes.
Conseils d’expert pour la Google Play App Rankings API
- Utilisez une URL publique de catégorie ou de classement Google Play, et non une page de détails d’application, une expression de recherche, un code pays ou un libellé de catégorie ; seuls urls et results_limit ont leur place dans cette requête.
- Utilisez une URL play.google.com dont le chemin contient /store/apps/collection/ ou /store/apps/category/ ; les pages de détails d’application et les chemins sans rapport échouent à la validation avant le début de la collecte.
- Avec plusieurs URL d’entrée, results_limit est partagé par toute la tâche. Les URL sont traitées dans l’ordre et chacune ne reçoit que le quota restant ; scindez donc les tâches si chaque classement exige un quota indépendant.
- Considérez les métadonnées d’application comme nullables. Conservez app_id, url, rank et collected_at lorsqu’ils sont disponibles, au lieu de supposer que notes, nombres d’avis, installations, prix ou médias seront toujours renseignés.
- N’envoyez aucun curseur source. Attendez le succès, puis utilisez uniquement le next_cursor opaque renvoyé dans data.results pour paginer les enregistrements stockés par SocQ.
- Budgétez à partir de results_limit au moment de l’envoi. Les crédits finaux suivent le nombre réel de résultats stockés, à 0,15 crédit chacun, les crédits estimés non utilisés étant remboursés.
API associées
En complément de la Google Play App Rankings 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 Reviews API — Collectez les avis publics d’applications à partir d’URL play.google.com, avec pays facultatif et texte, auteur, note, date et références d’application normalisés.