google-maps/
reviews

Öffentliche Bewertungen aus bekannten Google-Maps-URLs sammeln – mit normalisiertem Text, Verweisen auf die Bewertenden, Sternebewertungen, Quelllinks, Zeitstempeln, Ortsverweisen und verfügbaren Medien.

Google Maps Reviews API

Ortsbewertungen
Tagesfenster-Filter
Normalisierte Bewertungsdatensätze
0,15 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Google Maps Reviews

Google-Maps-Bewertungen sind öffentliche Rückmeldungen zu Orten, die geschriebenen Text, einen Verweis auf die bewertende Person, eine Sternebewertung, Quell- und Ortslinks, Veröffentlichungs- und Erfassungszeiten sowie Medien enthalten können. Sie unterstützen Feedback-Datensätze mit Quelllink und Vergleiche zwischen bekannten Orten oder Erfassungszeiträumen.

Funktionen der Google Maps Reviews API

  • Stapeleingabe bekannter URLsÜbergeben Sie eine oder mehrere unterstützte google.com- oder goo.gl-URLs in einer asynchronen Aufgabe, statt Orte über eine separate Kennungs-API aufzulösen.
  • Optionales TagesfensterWenden Sie einen positiven Wert days_limit auf jede übergebene URL-Zeile an, wenn der Workflow ein Fenster für aktuelle Bewertungen benötigt.
  • Stabile BewertungsdatensätzeLiest Bewertungsidentität, Text, Felder zur bewertenden Person, Sternebewertung, Ortsverweise, Zeitstempel, Quell-URL und verfügbare Medien über das Bewertungsschema v1.0.

Parameter der Google Maps Reviews API

ParameterErforderlichBeschreibung
urlsErforderlichEine oder mehrere nicht leere URLs auf google.com, einer beliebigen Subdomain von google.com, goo.gl oder einer Subdomain von goo.gl, getrennt durch Kommas oder Zeilenumbrüche. Verwenden Sie für die Erfassung von Bewertungen bekannte URLs von Maps-Orten.
days_limitOptionalOptionale positive ganze Zahl, die auf jede Eingabezeile des Anbieters als Fenster für die Aktualität der Bewertungen angewendet wird. Lassen Sie sie weg, um keinen Filter für das Tagesfenster zu senden.
results_limitOptionalOptionale ganze Zahl von 1 bis 2.000, die die Gesamtzahl der für die Aufgabe gespeicherten Bewertungen begrenzt. Der Standardwert ist 100, und je nach Verfügbarkeit der Quelle können weniger Zeilen entstehen.

So verwenden Sie die Google Maps Reviews API

Senden Sie bekannte Google-Maps-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie die gespeicherten Bewertungsdatensätze über den Cursor der Aufgabenergebnisse.

  1. Bereiten Sie eine oder mehrere unterstützte URLs von Google-Maps-Orten auf google.com oder goo.gl vor.
  2. Senden Sie urls und bei Bedarf days_limit und results_limit per POST an /v1/google-maps/reviews.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  4. Lesen Sie /v1/tasks/{task_id}?limit=50 und fahren Sie mit results.next_cursor fort, solange results.has_more den Wert true hat.
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}.

Anwendungsfälle der Google Maps Reviews API

  • Feedback-Datensätze zu bekannten Orten: Bereiten Sie Bewertungstext, Sternebewertungen, Veröffentlichungszeiten und Quelllinks für eine festgelegte Menge öffentlicher Orts-URLs auf.
  • Recherche zu Bewertenden mit Quellenbezug: Behalten Sie verfügbare Namen und Benutzernamen der Bewertenden, Profillinks und Bewertungs-URLs bei, damit Datensätze auf ihren öffentlichen Kontext zurückführbar bleiben.
  • Vergleiche über aktuelle Zeitfenster: Führen Sie dieselbe Ortsmenge zu verschiedenen Zeiten mit dokumentierten days_limit-Werten aus, um begrenzte Erfassungen zu vergleichen, ohne eine lückenlose Historie zu behaupten.
  • Bewertungsarchive mit Medien: Halten Sie verfügbare Bewertungsmedien zusammen mit Text, Sternebewertung, Ortsverweis und Erfassungszeit in einem normalisierten Recherchedatensatz.

Profi-Tipps zur Google Maps Reviews API

  • Übergeben Sie auflösbare Maps-URLs auf google.com oder goo.gl; ein Ortsname, ein Google-Business-Profile-Konto oder eine Place-ID allein ist kein zulässiges Element von urls.
  • Verwenden Sie days_limit nur, wenn ein Fenster in positiven ganzen Tagen sinnvoll ist; ohne diesen Wert bleibt die Zeile des Anbieters ohne diesen Filter.
  • Betrachten Sie results_limit als eine globale Obergrenze gespeicherter Ergebnisse über den gesamten URL-Stapel und nicht als Zusage pro URL.
  • Halten Sie das results_limit der Übermittlung getrennt vom limit beim Lesen der Aufgabe: Letzteres steuert die Seitengröße von 1 bis 500 und arbeitet mit einem undurchsichtigen Cursor.
  • Rechnen Sie damit, dass Text, Attribute der Bewertenden, Sternebewertung, Bezugsverweise, Zeitstempel und Medien fehlen, wenn die öffentliche Quelle sie nicht bereitstellt.

Ergänzend zur Google Maps Reviews API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Maps-Daten benötigen.

Weitere Plattformen entdecken

Kombinieren Sie Google Maps-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Google Maps Reviews API — FAQ

Google Maps Reviews API ist eine Schnittstelle zum Sammeln öffentlicher Bewertungsdatensätze aus bekannten Google-Maps-URLs in einem stabilen Bewertungsschema. Sie liefert nur Daten, die über den unterstützten öffentlichen Erfassungsweg verfügbar sind, und bietet keine Verwaltungsaktionen für Google Business Profile, die eine Anmeldung erfordern.

Die Laufzeit akzeptiert nicht leere URLs, deren Host google.com, eine Subdomain von google.com, goo.gl oder eine Subdomain von goo.gl ist. Übergeben Sie für brauchbare Bewertungsergebnisse bekannte URLs von Google-Maps-Orten statt Namen oder eigenständiger Kennungen.

days_limit ist optional und muss eine ganze Zahl von mindestens 1 sein. Ist der Wert gesetzt, kopiert der Adapter des Anbieters ihn in jede URL-Eingabezeile; fehlt er, wird kein Feld days_limit gesendet.

results_limit hat den Standardwert 100 und akzeptiert ganze Zahlen von 1 bis 2.000. Die Anfrage an den Anbieter erhält die Obergrenze, und die Laufzeit hört auf, Zeilen zu speichern, sobald die Gesamtzahl der Aufgabe sie erreicht; Zahl der URLs, Tagesfenster und Verfügbarkeit der öffentlichen Daten können also alle zu weniger Ergebnissen führen.

Das Bewertungsschema v1.0 kann id, platform, resource, type, url, published_at, collected_at, text, author, rating, subject_id, subject_url und media enthalten. author umfasst Identität, Benutzername, Name, Profil-URL, Avatar-URL und nullable Kontomerkmale.

Es gibt keine Grundgebühr pro Aufgabe. Die Anfrage reserviert anhand von results_limit (oder 100, wenn der Wert fehlt) 0,15 Credits pro geschätztem Ergebnis, rechnet dann 0,15 Credits für jedes tatsächlich gespeicherte Ergebnis ab und erstattet nicht genutzte reservierte Credits; ein leeres Ergebnis wird mit null abgerechnet.