google-play/
app-reviews

Raccogli le recensioni pubbliche delle app di Google Play da URL di app di play.google.com, con contesto del paese facoltativo, come record normalizzati di testo delle recensioni, autori, valutazioni, timestamp e riferimenti alle app.

Google Play App Reviews API

Batch di URL di app
Testo e valutazioni delle recensioni
Contesto del paese
0,15 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Google Play App Reviews

Le recensioni delle app su Google Play sono valutazioni pubbliche dello store che abbinano feedback scritto e valutazioni a stelle all’identità di chi recensisce, all’orario di pubblicazione e al riferimento all’app recensita. Questi record supportano ricerche sul feedback, confronti tra valutazioni, monitoraggio dei rilasci e dataset di recensioni collegati alla fonte.

Funzionalità della Google Play App Reviews API

  • Input di URL di più appAccetta uno o più URL di app di play.google.com e ripartisce il numero di recensioni richiesto tra le app inviate.
  • Contenuto e valutazione della recensioneRestituisce il testo e la valutazione numerica di ogni recensione disponibile in un record di recensione coerente.
  • Contesto di autore e orarioConserva insieme al feedback l’identità disponibile di chi ha recensito, il riferimento al profilo, l’orario di pubblicazione e quello di raccolta.
  • Tracciabilità dell’app recensitaCollega le recensioni normalizzate agli identificatori disponibili delle app e ai loro URL pubblici tramite subject_id e subject_url.

Parametri della Google Play App Reviews API

ParametriObbligatorioDescrizione
urlsObbligatorioArray obbligatorio di uno o più URL di app non vuoti su play.google.com o sui suoi sottodomini.
countryFacoltativoStringa facoltativa passata alla fonte delle recensioni come contesto del paese; omettila quando non serve alcun contesto di mercato.
results_limitFacoltativoIntero positivo facoltativo da 1 a 2.000. Il valore predefinito è 100 e limita il totale dei risultati salvati su tutti gli URL inviati.

Come usare la Google Play App Reviews API

Invia gli URL delle app di Google Play, segui l’attività asincrona e scorri i record normalizzati salvati da SocQ.

  1. Prepara uno o più URL pubblici di app il cui hostname è play.google.com o uno dei suoi sottodomini.
  2. Invia con POST urls, con country e results_limit facoltativi, a /v1/google-play/app-reviews, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non termina con successo o con un errore; non inviare un’altra attività mentre interroghi.
  4. Dopo il successo leggi data.results.items e restituisci next_cursor alla route dell’attività finché has_more è 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

Casi d’uso della Google Play App Reviews API

  • Ricerca sui temi del feedback: Usa testo e valutazioni delle recensioni per preparare un corpus collegato alla fonte, da usare per la codifica qualitativa o per analisi del testo a valle.
  • Confronto tra valutazioni e testo: Confronta il feedback scritto con la relativa valutazione numerica su pagine pubbliche di app selezionate.
  • Monitoraggio della cronologia delle recensioni: Combina gli orari di pubblicazione e di raccolta per confrontare campioni di recensioni raccolti separatamente in prossimità dei rilasci di un prodotto.
  • Arricchimento di dataset collegati alle app: Associa ai record delle app i campi di autore, testo, valutazione e timestamp tramite subject_id e subject_url.

Consigli degli esperti per la Google Play App Reviews API

  • Usa URL pubblici e completi di app su play.google.com; altri host non superano la convalida dell’input prima dell’inizio della raccolta.
  • Quando invii più URL, scegli results_limit come obiettivo valido per l’intera attività, perché l’allocazione della fonte viene divisa tra gli input delle app e il salvataggio finale ha un limite globale.
  • Imposta country solo quando il contesto di mercato conta e mantieni lo stesso valore nelle raccolte ripetute che intendi confrontare.
  • Segui il next_cursor della risposta dell’attività per ottenere altri record salvati; è un cursore dei risultati di SocQ, non un cursore accettato dalla fonte delle recensioni.
  • Considera nullable i campi facoltativi di autore, link di origine e media, invece di sostituire i valori mancanti con valori predefiniti inventati.

Oltre alla Google Play App Reviews 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 Rankings API

Esplora altre piattaforme

Combina i dati di Google Play con i dati pubblici delle altre piattaforme social supportate.

Google Play App Reviews API — FAQ

Google Play App Reviews API è un’interfaccia programmatica per raccogliere le recensioni pubbliche delle app da uno o più URL inviati di app di Google Play, con contesto del paese facoltativo. Restituisce testo delle recensioni, dettagli di chi ha recensito, valutazioni, orari di pubblicazione, media e riferimenti alle app recensite, tutto normalizzato.

urls è un array obbligatorio di URL non vuoti il cui hostname è play.google.com o un sottodominio. country è una stringa facoltativa inoltrata alla richiesta alla fonte e può essere omessa.

results_limit ha come valore predefinito 100 e accetta interi da 1 a 2.000. La richiesta alla fonte distribuisce il numero richiesto tra gli URL inviati, mentre SocQ limita al valore richiesto il totale dei risultati salvati dell’attività.

Un record normalizzato può contenere ID della recensione, URL di origine, testo, identità di chi ha recensito, valutazione numerica, orari di pubblicazione e di raccolta, identificatore dell’app, URL dell’app e riferimenti ai media. I campi facoltativi restano null o vuoti quando il risultato pubblico non li fornisce.

Non viene accettato alcun cursore di origine fornito da chi chiama. Dopo il successo dell’attività asincrona, next_cursor e has_more scorrono le righe di risultato già salvate da SocQ.

L’attività è stimata a 100 risultati quando results_limit è omesso e costa 0,15 crediti SocQ per ogni risultato salvato. La fatturazione finale usa il numero effettivo di risultati e un risultato vuoto ma riuscito si salda alla tariffa di base di zero crediti.