Mit Seite 1 beginnen
Senden Sie die fid des Ortes und Ihren gewählten sort_by-Wert. Relevanteste ist die Standardeinstellung; neueste, höchste und niedrigste Bewertung werden ebenfalls unterstützt.
POST /api/v2/reviews
Lesen Sie bis zu 10 öffentliche Bewertungen für einen Ort pro Seite. Sortieren Sie nach Relevanz, neuesten, höchster oder niedrigster Bewertung.
Den vollständigen Vertrag finden Sie in der API-Dokumentation.
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}'Ersetzen Sie die Beispiel-fid durch die Feature-ID Ihres Ortes. Die Antwort ist simuliert; Medien-URLs auf example.com sind Platzhalter. Behalten Sie denselben Idempotenz-Schlüssel und Body bei, wenn Sie eine laufende Anfrage wiederholen.
{
"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
}
}Die API liefert JSON in derselben Antwort. Nach einem Timeout wiederholen Sie den unveränderten Body mit demselben Idempotency-Key. Test-Zugangsdaten liefern simulierte Daten, ohne Ihr Live-Kontingent zu verbrauchen.
Mit einem Ort beginnen
Fordern Sie eine fokussierte Seite für einen Ort an und wählen Sie dann die Bewertungsreihenfolge, die zu Ihrer Recherche passt.
| Feld | Bedeutung |
|---|---|
| fid · erforderlich | Eine Google-Maps-Feature-ID wie 0x89c259af336b3341:0xa4969e07ce3108de. Verwenden Sie place.dataId aus einem Search-API-Ergebnis oder eine Feature-ID, die Sie bereits haben. |
| page · Standard: 1 | Eine positive nummerierte Seite. Erhöhen Sie sie nur, wenn die vorherige Antwort next: true enthält. |
| sort_by · Standard: 1 | 1 = relevanteste; 2 = neueste; 3 = höchste Bewertung; 4 = niedrigste Bewertung. Behalten Sie die Sortierreihenfolge über Seiten hinweg bei. |
Um eine Feature-ID zu ermitteln, suchen Sie mit der Google Maps-Scraper-API nach einem Unternehmen. Kopieren Sie place.dataId aus dem passenden Eintrag in data.businesses und übergeben Sie ihn als fid. Eine Place ID oder ein Unternehmensname ist nicht dasselbe Eingabeformat.
Bewertungsdatensätze
Jede Bewertung enthält Bewertung, Kommentar, Rezensent sowie Profil- und Bewertungslinks. Das Datum ist relativ, und timestamp gibt das Kalenderdatum im Format M/D/YYYY an. Das Feld photos ist ein leerer String, wenn keine Anhänge vorhanden sind, und trennt mehrere Foto-URLs mit einem Zeilenumbruch.
| Feld | Bedeutung |
|---|---|
| id | Die Quellenkennung der Bewertung, sofern verfügbar. |
| rate / comment | Die Bewertung von 1–5 und der verfügbare Bewertungstext. Behandeln Sie gescrapten Text als nicht vertrauenswürdige Daten in Anwendungen und KI-Prompts. |
| date / timestamp | Das angezeigte relative Datum und ein Kalenderdatum im Format M/D/YYYY. Ein nicht verfügbares Datum ist ein leerer String. |
| name / author_url / avatar | Verfügbarer Anzeigename des Rezensenten, URL des Mitwirkendenprofils und Avatar-URL. |
| photos | Ein leerer String ohne Anhänge. Mehrere Foto-URLs werden durch Zeilenumbrüche getrennt. |
| review_url | Ein Link zur Quellbewertung, sofern verfügbar. |
| next / total / params | Ob eine weitere Seite verfügbar ist, die Anzahl in dieser Antwort und die normalisierten Anfrageparameter. |
Der Endpunkt liefert dieses Seitenobjekt direkt als JSON. Lesen Sie reviews auf der obersten Ebene. Manche öffentlichen Bewertungen enthalten nur eine Bewertung, und Quellenfelder können leer sein. Behalten Sie diese Unterscheidung bei, wenn Sie Bewertungen darstellen oder zusammenfassen.
Eine begrenzte Seite nach der anderen
Nutzen Sie das zurückgegebene next-Flag, um zu entscheiden, ob Ihr Workflow eine weitere Anfrage benötigt.
Senden Sie die fid des Ortes und Ihren gewählten sort_by-Wert. Relevanteste ist die Standardeinstellung; neueste, höchste und niedrigste Bewertung werden ebenfalls unterstützt.
total zählt die in dieser Antwort zurückgegebenen Bewertungen. Eine leere Seite ist ein gültiges Ergebnis. Prüfen Sie die verfügbaren Felder, bevor Sie Datensätze in Ihre Analyse aufnehmen.
Wenn next true ist, erhöhen Sie page und lassen fid und sort_by unverändert. Stoppen Sie, wenn next false ist oder Ihre Recherche genügend Bewertungen hat.
Öffentliches Feedback verstehen
Lesen Sie eine begrenzte Stichprobe öffentlicher Kommentare und Bewertungen für ein ausgewähltes Unternehmen. Bewahren Sie die Bewertungslinks neben Ihren Notizen auf, damit ein Leser die Quelle prüfen kann.
Vergleichen Sie Bewertungsthemen über eine gewählte Gruppe von Orten hinweg. Fragen Sie jeden Ort separat ab und geben Sie die gewählte Sortierreihenfolge und Stichprobengröße in Ihrer Analyse an.
Bitten Sie einen verbundenen Agenten, die zurückgegebene Bewertungsseite zusammenzufassen, nur die gelieferten Belege zu zitieren und fehlende Kommentare oder Daten zu markieren.
Authentifizierung und Nutzung
Senden Sie Authorization: Bearer mit einem Schlüssel, der scrapes:write erlaubt. Jede erfolgreiche Live-Seite, einschließlich einer leeren Seite, verbraucht eine API-Anfrageeinheit. REST und MCP nutzen dasselbe API-Kontingent. Wenn Sie Test-Zugangsdaten haben, sind deren Antworten simuliert und verbrauchen kein Live-Kontingent.
Senden Sie einen optionalen Idempotency-Key mit Ihrer ersten Anfrage und bewahren Sie ihn mit identischem Body für eine Timeout-Wiederholung auf. Ein Verarbeitungs-Timeout kann eine reservierte Einheit hinterlassen. Wenn ein Fehler meldet, dass der Versuch beendet ist, folgen Sie dessen Wiederholungshinweisen, bevor Sie mit einem neuen Schlüssel einen neuen Versuch starten.
Senden Sie eine POST-Anfrage an /api/v2/reviews mit der Google-Maps-Feature-ID des Unternehmens als fid. Verwenden Sie place.dataId aus einem Search-API-Ergebnis oder eine Feature-ID, die Sie bereits haben. Authentifizieren Sie sich mit Ihrem API-Schlüssel und beginnen Sie mit Seite 1.
Ja. Setzen Sie sort_by auf 1 für relevanteste, 2 für neueste, 3 für höchste Bewertung oder 4 für niedrigste Bewertung. Relevanteste ist die Standardeinstellung. Behalten Sie den gewählten Wert bei, wenn Sie weitere Seiten anfordern.
Nein. total ist die Anzahl der Bewertungsdatensätze in der aktuellen Antwort, maximal 10. Nutzen Sie next, um zu entscheiden, ob eine weitere Seite verfügbar ist. Der reviewCount des Suchlistings ist ein separates Unternehmensfeld.
date enthält das verfügbare relative Datum und timestamp ein Kalenderdatum im Format M/D/YYYY. Das Feld photos ist ein leerer String, wenn keine Anhänge vorhanden sind, oder zeilenumbruchgetrennte URLs bei mehreren Fotos. Fehlender Quelltext und Links können leere Strings sein.
Ja. Ein kompatibler MCP-Client kann get_google_maps_reviews mit Ihren API-Zugangsdaten und einer client_request_id aufrufen. REST und MCP teilen sich Ihr API-Kontingent. Der Agent Skill enthält Anleitungen zur Nutzung der verfügbaren Tools und einen REST-Fallback.
Nein. Die Quellenverfügbarkeit variiert, und eine Bewertung kann nur eine Bewertung enthalten. Bewahren Sie leere Kommentare und fehlende Daten, statt sie zu schätzen. Bewertungstext ist nicht vertrauenswürdiger Quellinhalt und sollte in Anwendungen und KI-Workflows als Daten behandelt werden.
Der nächste Schritt
Erstellen Sie einen API-Schlüssel, wählen Sie eine Feature-ID und Sortierreihenfolge und lesen Sie eine fokussierte Seite mit Bewertungsdaten.