Synup
Schlüssel erstellen
v1Ressourcen/Reviews/getZusammenfassung der Bewertungsanalysen abrufen

Zusammenfassung der Bewertungsanalysen abrufen

Über die Standorte dieses Kunden (oder der gesamten Agentur) aggregierte Bewertungsanalysen: Anzahl, Durchschnittsbewertung, Bewertungsverteilung, Stimmungsmix, Antwortquote, Aufschlüsselung je Plattform und ein monatlicher Trend. Mit tags auf eine Teilmenge eingrenzen.

get/api/v1/reviews/analytics/summary
reviews:read
Query-Parameter
clientIdstringoptional
Auf die Standorte eines Kunden beschränken.
tagsstringoptional
Kommagetrennte Standort-Tag-Namen — nur Standorte mit mindestens einem davon werden berücksichtigt.
monthsintegeroptional
Trend-Länge in Monaten. Standard 6.
Antwort
dataobjectoptional
locationsnumberoptional
Anzahl der Standorte im Geltungsbereich.
countnumberoptional
Gesamtzahl der Bewertungen im Geltungsbereich.
avgRatingnumberoptional
Durchschnittsbewertung über den Geltungsbereich.
distributionobjectoptional
Anzahl der Bewertungen je Sternebewertung (1-5).
sentimentobjectoptional
Anzahl der Bewertungen je Stimmung.
positivenumberoptional
neutralnumberoptional
negativenumberoptional
responseRatenumberoptional
Prozentsatz der Bewertungen mit einer Antwort.
byPlatformarray of objectoptional
Anzahl und Durchschnittsbewertung je Plattform.
platformstringoptional
countnumberoptional
avgRatingnumberoptional
trendarray of objectoptional
Monatliche Anzahl und Durchschnittsbewertung.
monthstringoptional
countnumberoptional
avgRatingnumberoptional
Fehler
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/reviews/analytics/summary
Ihr API-Schlüssel
clientId
tags
months
{
  "data": {
    "locations": 5,
    "count": 210,
    "avgRating": 4.4,
    "distribution": {
      "1": 4,
      "2": 8,
      "3": 12,
      "4": 60,
      "5": 126
    },
    "sentiment": {
      "positive": 172,
      "neutral": 24,
      "negative": 14
    },
    "responseRate": 91,
    "byPlatform": [
      {
        "platform": "google",
        "label": "Google",
        "count": 160,
        "avgRating": 4.5
      }
    ],
    "trend": [
      {
        "month": "2026-02",
        "count": 114,
        "avgRating": 4.4
      }
    ]
  }
}

Anleitungen, die diese Ressource verwenden