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.
POST /api/v2/reviews
Legga fino a 10 recensioni pubbliche di un luogo per pagina. Ordini per rilevanza, più recenti, valutazione più alta o valutazione più bassa.
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.
{
"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
Richieda una pagina mirata per un luogo, poi scelga l'ordine delle recensioni più adatto alla Sua ricerca.
| Campo | Significato |
|---|---|
| fid · obbligatorio | Un 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 1 | Una pagina numerata positiva. La incrementi solo quando la risposta precedente ha next: true. |
| sort_by · predefinito 1 | 1 = 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
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.
| Campo | Significato |
|---|---|
| id | L'identificatore della recensione di origine, quando disponibile. |
| rate / comment | La 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 / timestamp | La data relativa mostrata e una data di calendario in formato M/D/YYYY. Una data non disponibile è una stringa vuota. |
| name / author_url / avatar | Nome visualizzato dell'autore, URL del profilo del collaboratore e URL dell'avatar disponibili. |
| photos | Una stringa vuota senza allegati. Più URL di foto sono separati da caratteri di nuova riga. |
| review_url | Un link alla recensione di origine, quando disponibile. |
| next / total / params | Se è 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
Usi il flag next restituito per decidere se il Suo workflow ha bisogno di un'altra richiesta.
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.
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.
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
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
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
Crei una chiave API, scelga un feature ID e un ordinamento, e legga una pagina mirata di dati delle recensioni.