Zeitreihe der Bewertungsanalysen abrufen

Parameter

Pfad

Name	Typ	Erforderlich	Beschreibung
locationId	string	erforderlich	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Query

Name	Typ	Erforderlich	Beschreibung	Standard
startDate	string	optional	First day of the series (`YYYY-MM-DD`). Omitting it lets the service pick its default window, so pass it whenever the chart's range matters.	—
endDate	string	optional	Last day of the series (`YYYY-MM-DD`).	—
site	string	optional	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

Antworten

200One entry per day in the requested range. Response key `interactionsChartData`.

Response

{  "data": {    "interactionsChartData": {      "data": [        { "date": "2026-08-01", "interactionCount": 4, "averageRating": 4.5 },        { "date": "2026-08-02", "interactionCount": 0, "averageRating": null },        { "date": "2026-08-03", "interactionCount": 7, "averageRating": 4.285714285714286 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

403The key is valid but not permitted to read this location (`SY90003`).

Gibt die tägliche Bewertungsreihe zurück, die einem Trenddiagramm zugrunde liegt: wie viele Bewertungen an jedem Datum eingegangen sind und welche durchschnittliche Sternebewertung diese Bewertungen haben. Sie ist das Zeitreihen-Pendant zu Interaktionsanalysen abrufen (Gesamt-KPIs) und Bewertungsanalysen nach Website abrufen (Aufschlüsselung nach Quelle).

Jeder Eintrag enthält drei Felder:

date: der Kalendertag im Format YYYY-MM-DD.
interactionCount: die an diesem Tag eingegangenen Bewertungen.
averageRating: die durchschnittliche Sternebewertung der Bewertungen dieses Tages; an einem Tag ohne Bewertungen ist der Wert null. Es handelt sich um den täglichen Durchschnitt, nicht um einen laufenden Durchschnitt. Daher wird eine einzelne 1-Stern-Bewertung an einem ruhigen Tag selbst bei einem gut bewerteten Geschäft als 1.0 angezeigt.

Anwendungsfall: eine 30-Tage-Sparkline

Um einen 30-Tage-Trend unter der durchschnittlichen Sternebewertung eines Standorts darzustellen, rufen Sie diese Route mit startDate und endDate für den entsprechenden Zeitraum auf und stellen Sie interactionCount als Balken sowie averageRating als Linie dar. Kombinieren Sie sie mit der Übersichtsroute für die wichtigsten Kennzahlen; die delta-Felder der Übersicht enthalten bereits Vergleiche mit dem vorherigen gleich langen Zeitraum, sodass Sie nicht selbst zwei Zeiträume abrufen müssen.

Übergeben Sie site, um die Reihe nach Quelle aufzuteilen, beispielsweise um zu zeigen, dass ein Rückgang der Sternebewertung auf eine einzelne Plattform zurückgeht und nicht alle Plattformen betrifft. Der Wert ist die Website-URL, wie sie in siteSettings[].name aus Bewertungsquellen für einen Standort auflisten erscheint.

Die obige Antwort ist ein Beispiel.