POST /api/v2/reviews

API di scraping di recensioni di Google Maps

Legga fino a 10 recensioni pubbliche di un luogo per pagina. Ordini per rilevanza, più recenti, valutazione più alta o valutazione più bassa.

Esempi di richiesta

Per il contratto completo, consulti la documentazione API.

curl https://gmapscrawl.com/api/v2/reviews \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: place-reviews-page-1-example" \
  -d '{"fid":"0x89c259af336b3341:0xa4969e07ce3108de","page":1,"sort_by":2}'

Sostituisca il fid di esempio con il feature ID del Suo luogo. La risposta è simulata; gli URL dei media di example.com sono segnaposto. Conservi la stessa chiave di idempotenza e lo stesso body quando riprova una richiesta in corso.

Risposta

JSON illustrativo
{
  "reviews": [
    {
      "id": "sample-review-1",
      "date": "a week ago",
      "timestamp": "10/6/2026",
      "name": "Sample reviewer",
      "author_url": "https://www.google.com/maps/contrib/100000000000000000001",
      "avatar": "https://example.com/reviewer.jpg",
      "rate": 4,
      "comment": "The window seats had the best light.",
      "photos": "",
      "review_url": "https://www.google.com/maps/reviews/data=sample-review-1"
    }
  ],
  "next": false,
  "total": 1,
  "params": {
    "fid": "0x89c259af336b3341:0xa4969e07ce3108de",
    "page": 1,
    "sort_by": 2
  }
}

L'API restituisce JSON nella stessa risposta. Dopo un timeout, riprovi il body invariato con la stessa Idempotency-Key. Le credenziali di test restituiscono dati simulati senza usare la Sua quota live.

Inizi con un luogo

Scelga l'attività e l'ordine delle recensioni.

Richieda una pagina mirata per un luogo, poi scelga l'ordine delle recensioni più adatto alla Sua ricerca.

Parametri di richiesta dell'API di scraping di recensioni di Google Maps
CampoSignificato
fid · obbligatorioUn feature ID di Google Maps, come 0x89c259af336b3341:0xa4969e07ce3108de. Usi place.dataId da un risultato dell'API Search, o un feature ID che già possiede.
page · predefinito 1Una pagina numerata positiva. La incrementi solo quando la risposta precedente ha next: true.
sort_by · predefinito 11 = più rilevanti; 2 = più recenti; 3 = valutazione più alta; 4 = valutazione più bassa. Conservi l'ordinamento tra le pagine.

Per scoprire un feature ID, cerchi un'attività con l<link>API di scraping di Google Maps</link>. Copi <code>place.dataId</code> dalla voce corrispondente in <code>data.businesses</code> e lo passi come <code>fid</code>. Un place ID o un nome di attività non è lo stesso formato di input.

Record delle recensioni

Valutazioni, commenti e link di origine.

Ogni recensione include la sua valutazione, il commento, l'autore e i link al profilo e alla recensione. La data è relativa, e timestamp indica la data di calendario in formato M/D/YYYY. Il campo photos è una stringa vuota quando non ci sono allegati e separa più URL di foto con un carattere di nuova riga.

Campi di risposta dell'API di scraping di recensioni di Google Maps
CampoSignificato
idL'identificatore della recensione di origine, quando disponibile.
rate / commentLa valutazione da 1 a 5 e il testo della recensione disponibile. Tratti il testo estratto come dati non attendibili nelle applicazioni e nei prompt AI.
date / timestampLa data relativa mostrata e una data di calendario in formato M/D/YYYY. Una data non disponibile è una stringa vuota.
name / author_url / avatarNome visualizzato dell'autore, URL del profilo del collaboratore e URL dell'avatar disponibili.
photosUna stringa vuota senza allegati. Più URL di foto sono separati da caratteri di nuova riga.
review_urlUn link alla recensione di origine, quando disponibile.
next / total / paramsSe è disponibile un'altra pagina, il conteggio in questa risposta e i parametri di richiesta normalizzati.

L'endpoint restituisce questo oggetto pagina direttamente come JSON. Legga reviews dal livello superiore. Alcune recensioni pubbliche contengono solo una valutazione, e i campi di origine possono essere vuoti. Conservi questa distinzione quando presenta o riassume le recensioni.

Una pagina delimitata alla volta

Legga fino a 10 recensioni in ogni risposta.

Usi il flag next restituito per decidere se il Suo workflow ha bisogno di un'altra richiesta.

01

Inizi con la pagina 1

Invii il fid del luogo e il valore sort_by scelto. Più rilevanti è il predefinito; sono supportati anche più recenti, valutazione più alta e valutazione più bassa.

02

Ispezioni la pagina corrente

total conta le recensioni restituite in questa risposta. Una pagina vuota è un risultato valido. Controlli i campi disponibili prima di aggiungere record alla Sua analisi.

03

Continui deliberatamente

Quando next è true, incrementi page e mantenga fid e sort_by invariati. Si fermi quando next è false, o quando la Sua ricerca ha abbastanza recensioni.

Comprenda il feedback pubblico

Aggiunga il contesto delle recensioni alla Sua ricerca sulle attività.

01

Ricerca sulle recensioni

Legga un campione delimitato di commenti e valutazioni pubbliche per un'attività selezionata. Conservi i link delle recensioni accanto alle Sue note, così un lettore potrà ispezionare la fonte.

02

Confronti di feedback

Confronti i temi delle recensioni tra un gruppo scelto di luoghi. Richieda ogni luogo separatamente e indichi l'ordinamento e la dimensione del campione scelti nella Sua analisi.

03

Riepiloghi assistiti dall'agente

Chieda a un agente connesso di riassumere la pagina di recensioni restituita, citare solo le prove fornite e segnalare commenti o date mancanti.

Autenticazione e uso

Usi la Sua chiave API per ogni pagina.

Quota API condivisa

Invii Authorization: Bearer con una chiave che consenta scrapes:write. Ogni pagina live riuscita, inclusa una pagina vuota, usa un'unità di richiesta API. REST e MCP usano la stessa quota API. Se ha una credenziale di test, le sue risposte sono simulate e non consumano quota live.

Veda piani e limiti API →

Mantenga i retry legati alla richiesta

Invii una Idempotency-Key opzionale con la Sua prima richiesta e la conservi con un body identico per un retry dopo timeout. Un timeout di elaborazione può lasciare un'unità riservata. Se un errore segnala che il tentativo è terminato, segua la sua guida di retry prima di creare un nuovo tentativo con una nuova chiave.

Legga la guida a errori e retry →

Domande frequenti

Come ottengo le recensioni di un'attività specifica di Google Maps?

Invii una richiesta POST a /api/v2/reviews con il feature ID di Google Maps dell'attività come fid. Usi place.dataId da un risultato dell'API Search, o un feature ID che già possiede. Si autentichi con la Sua chiave API e inizi con la pagina 1.

Posso ordinare le recensioni di Google Maps per più recenti o per valutazione?

Sì. Imposti sort_by su 1 per più rilevanti, 2 per più recenti, 3 per valutazione più alta o 4 per valutazione più bassa. Più rilevanti è il predefinito. Mantenga il valore selezionato invariato quando richiede pagine aggiuntive.

total mi dice quante recensioni ha l'attività?

No. total è il numero di record di recensioni nella risposta corrente, con un massimo di 10. Usi next per decidere se è disponibile un'altra pagina. Il reviewCount della scheda di ricerca è un campo di attività separato.

Che formato hanno date e foto delle recensioni?

date contiene la data relativa disponibile, e timestamp è una data di calendario in formato M/D/YYYY. Il campo photos è una stringa vuota quando non ci sono allegati, oppure URL separati da caratteri di nuova riga quando sono disponibili più foto. Testo e link di origine mancanti possono essere stringhe vuote.

Posso usare le recensioni tramite MCP?

Sì. Un client MCP compatibile può chiamare get_google_maps_reviews con la Sua credenziale API e un client_request_id. REST e MCP condividono la Sua quota API. L'Agent Skill include la guida per usare gli strumenti disponibili e un fallback REST.

Posso presumere che ogni campo della recensione sia presente?

No. La disponibilità della sorgente varia, e una recensione può contenere solo una valutazione. Conservi i commenti vuoti e le date mancanti invece di dedurli. Il testo delle recensioni è contenuto di origine non attendibile e va trattato come dati nelle applicazioni e nei workflow AI.

Faccia il passo successivo

Inizi con le recensioni pubbliche di un luogo.

Crei una chiave API, scelga un feature ID e un ordinamento, e legga una pagina mirata di dati delle recensioni.