google-maps/
reviews

Raccogli le recensioni pubbliche da URL noti di Google Maps, con testo normalizzato, riferimenti al recensore, valutazioni, link di origine, timestamp, riferimenti al luogo e contenuti multimediali disponibili.

Google Maps Reviews API

Recensioni dei luoghi
Filtro per finestra di giorni
Record di recensioni normalizzati
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 Maps Reviews

Le recensioni di Google Maps sono record pubblici di feedback sui luoghi che possono includere testo scritto, un riferimento al recensore, una valutazione, link di origine e dell’oggetto recensito, orari di pubblicazione e di raccolta, oltre ai contenuti multimediali. Supportano dataset di feedback collegati alla fonte e confronti tra luoghi noti o finestre di raccolta.

Funzionalità della Google Maps Reviews API

  • Input di più URL notiInvia uno o più URL supportati di google.com o goo.gl in un’unica attività asincrona, senza risolvere i luoghi con un’API separata di identificatori.
  • Finestra di giorni facoltativaApplica un unico valore positivo di days_limit a ogni riga di URL inviata, quando il flusso di lavoro richiede una finestra di recensioni recenti.
  • Record di recensioni stabiliLeggi identità della recensione, testo, campi del recensore, valutazione, riferimenti al luogo, timestamp, URL di origine e contenuti multimediali disponibili tramite lo schema review v1.0.

Parametri della Google Maps Reviews API

ParametriObbligatorioDescrizione
urlsObbligatorioUno o più URL non vuoti su google.com, su qualsiasi sottodominio di google.com, su goo.gl o su un sottodominio di goo.gl, separati da virgole o da a capo. Per raccogliere le recensioni usa URL noti di luoghi di Maps.
days_limitFacoltativoIntero positivo facoltativo, applicato a ogni riga di input del provider come finestra di recenza delle recensioni. Omettilo per non inviare alcun filtro per giorni.
results_limitFacoltativoIntero facoltativo da 1 a 2.000 che limita il totale delle recensioni salvate per l’attività. Il valore predefinito è 100 e la disponibilità della fonte può produrre meno righe.

Come usare la Google Maps Reviews API

Invia URL noti di Google Maps, segui l’attività asincrona e leggi i record delle recensioni salvati tramite il cursore dei risultati dell’attività.

  1. Prepara uno o più URL di luoghi di Google Maps supportati su google.com o goo.gl.
  2. Invia con POST urls e, se serve, days_limit e results_limit a /v1/google-maps/reviews.
  3. Interroga /v1/tasks/{task_id} finché status diventa succeeded o failed.
  4. Leggi /v1/tasks/{task_id}?limit=50 e prosegui con results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Casi d’uso della Google Maps Reviews API

  • Dataset di feedback su luoghi noti: Prepara testo delle recensioni, valutazioni, orari di pubblicazione e link di origine per un insieme definito di URL pubblici di luoghi.
  • Ricerca sui recensori con tracciabilità della fonte: Conserva nomi, nomi utente, link ai profili e URL delle recensioni disponibili, così i record restano riconducibili al loro contesto pubblico.
  • Confronti su finestre recenti: Esegui lo stesso insieme di luoghi con valori di days_limit documentati in momenti diversi, per confrontare raccolte circoscritte senza pretendere uno storico completo.
  • Archivi di recensioni con media collegati: Tieni i contenuti multimediali disponibili accanto a testo, valutazione, riferimento al luogo e momento di raccolta in un record di ricerca normalizzato.

Consigli degli esperti per la Google Maps Reviews API

  • Invia URL di Maps risolvibili su google.com o goo.gl: il nome di un luogo, un account Google Business Profile o un Place ID da soli non sono un elemento accettato di urls.
  • Usa days_limit solo quando ha senso una finestra espressa in numeri interi positivi; se lo ometti, la riga inviata al provider resta senza quel filtro.
  • Considera results_limit come un unico tetto globale di risultati salvati per l’intero gruppo di URL, non come una promessa per ogni singolo URL.
  • Tieni separato results_limit dell’invio dal limit di lettura dell’attività: quest’ultimo controlla la dimensione della pagina da 1 a 500 e usa un cursore opaco.
  • Metti in conto che testo, attributi del recensore, valutazione, riferimenti all’oggetto, timestamp e media possano mancare quando la fonte pubblica non li espone.

Oltre alla Google Maps Reviews API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Maps.

Esplora altre piattaforme

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

Google Maps Reviews API — FAQ

Google Maps Reviews API è un’interfaccia programmatica per raccogliere in uno schema stabile i record delle recensioni pubbliche da URL noti di Google Maps. Restituisce solo i dati disponibili tramite il percorso di raccolta pubblico supportato e non offre azioni di gestione di Google Business Profile che richiedono l’accesso.

Il runtime accetta URL non vuoti il cui host è google.com, un sottodominio di google.com, goo.gl o un sottodominio di goo.gl. Per ottenere recensioni utili, invia URL noti di luoghi di Google Maps invece di nomi o identificatori isolati.

days_limit è facoltativo e deve essere un intero pari ad almeno 1. Se presente, l’adattatore del provider copia lo stesso valore su ogni riga di input degli URL; se omesso, non viene inviato alcun campo days_limit.

results_limit ha come valore predefinito 100 e accetta interi da 1 a 2.000. La richiesta al provider riceve il limite e anche il runtime smette di salvare righe quando il totale dell’attività lo raggiunge, quindi numero di URL, finestra di giorni e disponibilità del dataset pubblico possono produrre meno risultati.

Lo schema review v1.0 può contenere id, platform, resource, type, url, published_at, collected_at, text, author, rating, subject_id, subject_url e media. Author si espande in identità, nome utente, nome, URL del profilo, URL dell’avatar e flag dell’account che possono essere nulli.

Non c’è alcun costo base per l’attività. La richiesta riserva 0,15 crediti per ogni risultato stimato in base a results_limit, o a 100 se omesso, poi salda 0,15 crediti per ogni risultato effettivamente salvato e rimborsa i crediti riservati non usati; un risultato vuoto si salda a zero.