POST /api/v2/reviews

Google Maps Bewertungs-Scraper-API

Lesen Sie bis zu 10 öffentliche Bewertungen für einen Ort pro Seite. Sortieren Sie nach Relevanz, neuesten, höchster oder niedrigster Bewertung.

Anfragebeispiele

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.

Antwort

Beispielhaftes JSON
{
  "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

Wählen Sie das Unternehmen und die Bewertungsreihenfolge.

Fordern Sie eine fokussierte Seite für einen Ort an und wählen Sie dann die Bewertungsreihenfolge, die zu Ihrer Recherche passt.

Anfrageparameter der Google Maps Bewertungs-Scraper-API
FeldBedeutung
fid · erforderlichEine 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: 1Eine positive nummerierte Seite. Erhöhen Sie sie nur, wenn die vorherige Antwort next: true enthält.
sort_by · Standard: 11 = 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

Bewertungen, Kommentare und Quellenlinks.

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.

Antwortfelder der Google Maps Bewertungs-Scraper-API
FeldBedeutung
idDie Quellenkennung der Bewertung, sofern verfügbar.
rate / commentDie Bewertung von 1–5 und der verfügbare Bewertungstext. Behandeln Sie gescrapten Text als nicht vertrauenswürdige Daten in Anwendungen und KI-Prompts.
date / timestampDas angezeigte relative Datum und ein Kalenderdatum im Format M/D/YYYY. Ein nicht verfügbares Datum ist ein leerer String.
name / author_url / avatarVerfügbarer Anzeigename des Rezensenten, URL des Mitwirkendenprofils und Avatar-URL.
photosEin leerer String ohne Anhänge. Mehrere Foto-URLs werden durch Zeilenumbrüche getrennt.
review_urlEin Link zur Quellbewertung, sofern verfügbar.
next / total / paramsOb 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

Lesen Sie bis zu 10 Bewertungen pro Antwort.

Nutzen Sie das zurückgegebene next-Flag, um zu entscheiden, ob Ihr Workflow eine weitere Anfrage benötigt.

01

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.

02

Die aktuelle Seite prüfen

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.

03

Bewusst fortfahren

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

Fügen Sie Ihrer Unternehmensrecherche Bewertungskontext hinzu.

01

Bewertungsrecherche

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.

02

Feedback-Vergleiche

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.

03

Agentengestützte Zusammenfassungen

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

Verwenden Sie Ihren API-Schlüssel für jede Seite.

Gemeinsames API-Kontingent

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.

API-Tarife und -Limits ansehen →

Wiederholungen an die Anfrage binden

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.

Fehler- und Wiederholungshinweise lesen →

Häufig gestellte Fragen

Wie erhalte ich Bewertungen für ein bestimmtes Google-Maps-Unternehmen?

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.

Kann ich Google-Maps-Bewertungen nach Aktualität oder Bewertung sortieren?

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.

Sagt total mir, wie viele Bewertungen das Unternehmen hat?

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.

Welches Format haben Bewertungsdaten und -fotos?

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.

Kann ich Bewertungen über MCP nutzen?

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.

Kann ich davon ausgehen, dass jedes Bewertungsfeld vorhanden ist?

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

Beginnen Sie mit den öffentlichen Bewertungen eines Ortes.

Erstellen Sie einen API-Schlüssel, wählen Sie eine Feature-ID und Sortierreihenfolge und lesen Sie eine fokussierte Seite mit Bewertungsdaten.