Bewertungsanalysen nach Website 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	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	optional	End of the comparison period (`YYYY-MM-DD`).	—

Antworten

200One entry per review source configured for the location. Response key `interactionsSitesStats`.

Response

{  "data": {    "interactionsSitesStats": {      "stats": [        {          "key": "google",          "siteUrl": "maps.google.com",          "averageRating": { "value": 4.6, "delta": 2.2 },          "totalInteractions": { "value": 412, "delta": 6.1 },          "newInteractions": { "value": 24, "delta": 33.3 },          "recency": "2026-09-06T14:12:00Z",          "baseRating": 4.5,          "baseInteractions": 388,          "humanizedRecency": "3 days ago"        },        {          "key": "facebook",          "siteUrl": "facebook.com",          "averageRating": { "value": 4.1, "delta": -1.4 },          "totalInteractions": { "value": 57, "delta": 0 },          "newInteractions": { "value": 0, "delta": -100 },          "recency": null,          "baseRating": 4.16,          "baseInteractions": 57,          "humanizedRecency": null        }      ]    }  }}

401Unauthenticated, missing or invalid API key.

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

Schlüsselt die Bewertungskennzahlen eines Standorts nach Quelle auf, sodass Sie erkennen können, welche Plattform eine Veränderung verursacht. Dies ist das Gegenstück auf Website-Ebene zu Interaktionsanalysen abrufen (Gesamtkennzahlen) und Zeitverlauf der Bewertungsanalysen abrufen (tägliche Zeitreihen).

Jeder Eintrag in stats beschreibt eine Bewertungsquelle:

key / siteUrl: der Kurzschlüssel der Quelle und ihre Website-URL. siteUrl entspricht siteSettings[].name aus Bewertungsquellen für einen Standort auflisten.
averageRating, totalInteractions, newInteractions: jeweils ein Objekt mit einem value für den angeforderten Zeitraum und einem delta, der prozentualen Veränderung gegenüber dem vorherigen gleich langen Zeitraum.
baseRating / baseInteractions: die entsprechenden Werte zu Beginn des Zeitraums, die als Ausgangspunkt für die Messung von delta dienen.
recency: Zeitstempel der neuesten Bewertung aus dieser Quelle; null, wenn die Quelle noch nie eine Bewertung zurückgegeben hat.
humanizedRecency: derselbe Zeitpunkt, für die Anzeige aufbereitet („vor 3 Tagen“).

Anwendungsfall: Ermitteln, welche Plattform den Durchschnitt verändert hat

Wenn die Gesamtbewertung eines Standorts sinkt, zeigt diese Route, wo der Rückgang auftritt. Lesen Sie averageRating.delta für jede Quelle: Ein einzelner negativer Ausreißer bei ansonsten unveränderten Werten deutet auf eine einzelne Plattform hin, während überwiegend negative Werte auf das Geschäft hindeuten. Ein newInteractions.value von 0 bei einer Quelle, deren recency Monate zurückliegt, bedeutet in der Regel, dass die Verbindung nicht mehr aktuell ist, und nicht, dass Kunden keine Bewertungen mehr abgeben. Prüfen Sie dies daher anhand von Bewertungsquellen für einen Standort auflisten.

Die obige Antwort ist ein Beispiel.