Google Play App Rankings
Un URL di classifica di Google Play identifica la categoria o la sezione di classifica da raccogliere, mentre results_limit controlla la profondità della scoperta, da 1 a duemila record. Ogni risultato salvato segue la specifica AppItem, così la posizione può essere analizzata accanto a identità del pacchetto, sviluppatore, categoria, valutazione, numero di recensioni, installazioni, prezzo, media, URL di origine e momento di raccolta disponibili.
Funzionalità della Google Play App Rankings API
- Batch di URL di classificheInvia un array urls non vuoto di pagine pubbliche di categorie o classifiche di play.google.com, invece di campi separati per paese o categoria.
- Convalida degli URL delle classifiche di Google PlayIl runtime accetta play.google.com e i suoi sottodomini solo quando il percorso contiene /store/apps/collection/ oppure /store/apps/category/.
- Raccolta di classifiche con limiteUsa results_limit da 1 a 2.000. Omettilo per usare 100, che è anche la stima di fatturazione e il valore predefinito di scoperta del provider.
- Posizioni delle app normalizzateLeggi rank insieme ai campi disponibili app_id, name, developer, category, rating, reviews_count, installs, price, media e ai metadati pubblici di origine, in un’unica forma AppItem.
- Flusso di dataset asincronoLe righe di URL inviate avviano un dataset asincrono del provider; SocQ salva i record normalizzati e restituisce lo stato dell’attività tramite il lettore di attività condiviso.
- Cursore dei risultati salvatiDopo il successo, pagina i record di SocQ con il next_cursor opaco del lettore di attività e un limit da 1 a 500. Questo cursore non è un token di pagina di Google Play né del provider.
- Regolazione sul risultato effettivoSocQ addebita in anticipo la stima dei risultati richiesti o predefiniti, poi salda 0,15 crediti per ogni risultato salvato e rimborsa i crediti stimati non usati; un risultato vuoto si salda alla base di zero crediti.
Parametri della Google Play App Rankings API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array obbligatorio e non vuoto di URL pubblici di classifiche di Google Play. Ogni URL deve usare play.google.com o uno dei suoi sottodomini e contenere /store/apps/collection/ oppure /store/apps/category/ nel percorso; il runtime non accetta country o category come campi indipendenti. |
results_limit | Facoltativo | Intero positivo facoltativo da 1 a 2.000. Il valore predefinito è 100, limita la scoperta e i record salvati sull’intera attività e fornisce la stima iniziale di fatturazione. Gli URL di input vengono elaborati in ordine rispetto alla quota residua dell’attività. |
Come usare la Google Play App Rankings API
Invia uno o più URL noti di classifiche di Google Play, segui l’attività asincrona e leggi i record di classifica normalizzati dopo il successo.
- Scegli URL pubblici di categorie o classifiche di play.google.com il cui contesto di classifica codifica già il mercato e la sezione di raccolta che ti servono.
- Invia con POST urls e un results_limit facoltativo a /v1/google-play/app-rankings, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché status diventa succeeded o failed; i risultati non sono disponibili mentre l’attività è ancora in coda o in esecuzione.
- Leggi data.results.items e prosegui con next_cursor solo quando has_more è 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=50Casi d’uso della Google Play App Rankings API
- Istantanee delle classifiche per categoria: Salva rank e collected_at insieme per confrontare istantanee raccolte separatamente di una classifica nota di Google Play.
- Scoperta di app in classifica: Trasforma un insieme curato di URL di categorie in record di app normalizzati per revisione, etichettatura o arricchimento a valle del catalogo.
- Controlli di posizione del portafoglio: Abbina i campi disponibili app_id e developer a un portafoglio interno, poi esamina ogni posizione restituita senza affidarti al solo confronto del nome visualizzato.
- Analisi dello store tra più esecuzioni: Carica i campi fissi AppItem in un data warehouse, così valutazioni, numeri di recensioni, installazioni, prezzi e posizioni nullable restano confrontabili tra una raccolta e l’altra.
Consigli degli esperti per la Google Play App Rankings API
- Usa un URL pubblico di categoria o classifica di Google Play, non una pagina di dettaglio di app, una frase di ricerca, un codice paese o un’etichetta di categoria; in questa richiesta vanno solo urls e results_limit.
- Usa un URL di play.google.com il cui percorso contiene /store/apps/collection/ oppure /store/apps/category/; le pagine di dettaglio delle app e i percorsi non pertinenti falliscono la convalida prima dell’inizio della raccolta.
- Con più URL di input, results_limit è condiviso dall’intera attività. Gli URL vengono elaborati in ordine e ognuno riceve solo la quota residua, quindi dividi le attività quando ogni classifica richiede una quota indipendente.
- Considera i metadati delle app come nullable. Conserva app_id, url, rank e collected_at quando disponibili, invece di dare per scontato che valutazioni, numeri di recensioni, installazioni, prezzo o media siano sempre valorizzati.
- Non inviare un cursore di origine. Attendi il successo, poi usa solo il next_cursor opaco restituito in data.results per paginare i record salvati da SocQ.
- Calcola il budget da results_limit al momento dell’invio. I crediti finali seguono il numero effettivo di risultati salvati a 0,15 crediti ciascuno, con rimborso dei crediti stimati non usati.
API correlate
Oltre alla Google Play App Rankings API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Play.
- Google Play App Detail API — Recupera i dettagli pubblici normalizzati di una scheda di Google Play da URL di app noti, tra cui identità, testi dello store, sviluppatore, categoria, metriche visibili, prezzo, media e contesto della raccolta.
- 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.