Google Play App Detail
Les détails d’une application Google Play sont des fiches publiques de la boutique, avec l’identité de l’application, ses descriptions, le contexte du développeur et de la catégorie, les notes et nombres d’avis visibles, les tranches d’installations, le prix et les médias. Ces champs servent à enrichir un catalogue, à comparer des applications choisies et à suivre leur évolution à un instant donné.
Fonctionnalités de la Google Play App Detail API
- Lot d’URL connues, sans découverteEnvoyez une ou plusieurs URL d’applications play.google.com pour une recherche directe de détails, sans transformer la requête en découverte par mot-clé.
- Identité et textes de la ficheNormalise l’identifiant du package, le nom de l’application, la description publique de la boutique, le développeur, la catégorie, l’URL source et la date de collecte.
- Contexte de marché visibleConserve la note, le nombre d’avis, la tranche d’installations, le prix et le classement disponibles comme observations nullables issues de la fiche publique.
- Fiches d’applications avec médiasRenvoie les médias avec un schéma d’application stable, pour que les fiches suivent le même workflow de résultats asynchrone que les autres données SocQ.
Paramètres de la Google Play App Detail API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau de chaînes obligatoire et non vide d’URL d’applications connues dont le nom d’hôte analysé est play.google.com ou un sous-domaine. Chaque URL acceptée correspond à une recherche de détails. |
Comment utiliser la Google Play App Detail API
Envoyez des URL Google Play connues, suivez la tâche asynchrone et lisez les fiches d’applications normalisées une fois la tâche terminée.
- Préparez un tableau urls non vide de liens d’applications dont le nom d’hôte analysé est play.google.com ou un sous-domaine pris en charge.
- Envoyez le tableau en POST à /v1/google-play/app-detail et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- Après le succès, lisez data.results.items. Ne suivez next_cursor que si has_more vaut true : il pagine des enregistrements déjà stockés par SocQ et ne sert pas à découvrir une autre page source de Google Play.
curl -X POST "https://api.socq.ai/v1/google-play/app-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/details?id=com.openai.chatgpt"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized app records from data.results.itemsCas d’usage de la Google Play App Detail API
- Enrichir un catalogue d’applications connu : Transformez des liens Google Play déjà stockés en identifiants de package, titres, descriptions, développeurs, catégories, URL sources et horodatages de collecte normalisés.
- Comparer des fiches sélectionnées : Alignez la note, le nombre d’avis, la tranche d’installations, le prix, la catégorie et les médias disponibles sur un ensemble approuvé d’URL d’applications.
- Suivre des instantanés de fiches : Répétez les recherches selon un calendrier défini et comparez les champs de fiche nullables avec collected_at pour repérer les changements d’un instant à l’autre.
Conseils d’expert pour la Google Play App Detail API
- Utilisez des URL complètes d’applications Google Play et dédoublonnez le tableau avant l’envoi, afin que l’estimation reflète uniquement les recherches voulues.
- Considérez que chaque URL d’entrée donne au plus un résultat, puis alignez les enregistrements renvoyés par url ou app_id : une URL acceptée peut tout de même ne correspondre à aucun élément.
- Stockez avec prudence la note, le nombre d’avis, la tranche d’installations, le prix, le classement et les médias, car les champs publics d’une fiche peuvent être absents ou changer après la collecte.
- N’utilisez next_cursor que pour poursuivre la lecture des résultats SocQ stockés d’une tâche terminée ; cet endpoint de détails n’expose ni recherche Google Play ni pagination de page source.
API associées
En complément de la Google Play App Detail API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Play.
- Google Play App Rankings API
- 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.