Google Play App Detail
Le schede di app di Google Play sono record pubblici dello store con identità dell’applicazione, descrizioni, contesto di sviluppatore e categoria, valutazioni e numero di recensioni visibili, fasce di installazioni, prezzo e contenuti multimediali. Questi campi supportano l’arricchimento di cataloghi, il confronto di app selezionate e il monitoraggio puntuale nel tempo.
Funzionalità della Google Play App Detail API
- Confine del batch di URL notiInvia uno o più URL di app di play.google.com per una ricerca diretta dei dettagli, senza trasformare la richiesta in una scoperta per parola chiave.
- Identità e testi della schedaNormalizza l’identificatore del pacchetto, il nome dell’app, la descrizione pubblica dello store, lo sviluppatore, la categoria, l’URL di origine e il momento di raccolta.
- Contesto di mercato visibileMantiene come osservazioni nullable, tratte dalla scheda pubblica, i campi disponibili di valutazione, numero di recensioni, fascia di installazioni, prezzo e posizione in classifica.
- Record di app pronti per i mediaRestituisce i contenuti multimediali insieme a uno schema stabile delle app, così i record delle schede seguono lo stesso flusso asincrono dei risultati degli altri dati SocQ.
Parametri della Google Play App Detail API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array di stringhe obbligatorio e non vuoto con URL di app noti il cui hostname analizzato è play.google.com o un sottodominio. Ogni URL accettato corrisponde a una ricerca di dettagli. |
Come usare la Google Play App Detail API
Invia URL noti di Google Play, segui l’attività asincrona e leggi i record delle app normalizzati al termine.
- Prepara un array urls non vuoto con link di app il cui hostname analizzato è play.google.com o un sottodominio supportato.
- Invia con POST l’array a /v1/google-play/app-detail e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non termina con successo o con un errore.
- Dopo il successo leggi data.results.items. Segui next_cursor solo quando has_more è true: pagina i record già salvati da SocQ e non scopre un’altra pagina di origine di 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.itemsCasi d’uso della Google Play App Detail API
- Arricchire un catalogo di app noto: Trasforma i link di Google Play già salvati in ID dei pacchetti, titoli, descrizioni, sviluppatori, categorie, URL di origine e timestamp di raccolta normalizzati.
- Confrontare schede selezionate: Allinea i campi disponibili di valutazione, numero di recensioni, fascia di installazioni, prezzo, categoria e media su un insieme approvato di URL di app.
- Monitorare le istantanee delle schede: Ripeti le ricerche con una pianificazione definita e confronta i campi nullable delle schede con collected_at per individuare i cambiamenti nel tempo.
Consigli degli esperti per la Google Play App Detail API
- Usa URL completi delle app di Google Play e deduplica l’array prima dell’invio, così la stima riflette solo le ricerche volute.
- Considera ogni URL di input idoneo a produrre al massimo un risultato, poi allinea i record restituiti per url o app_id, perché un URL accettato può comunque non restituire alcun elemento.
- Salva in modo difensivo valutazione, numero di recensioni, fascia di installazioni, prezzo, posizione e media, perché i campi pubblici della scheda possono mancare o cambiare dopo la raccolta.
- Usa next_cursor solo per continuare a leggere i risultati SocQ salvati di un’attività completata: questo endpoint di dettaglio non espone la ricerca di Google Play né la paginazione della pagina di origine.
API correlate
Oltre alla Google Play App Detail API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Play.
- Google Play App Rankings API
- Google Play App Reviews API — Raccoglie le recensioni pubbliche delle app dagli URL play.google.com con contesto del paese facoltativo e campi normalizzati di testo, autore, valutazione, data e riferimento all’app.