Synup
Schlüssel erstellen
v1Ressourcen/Reviews/getBewertungsanalysen abrufen

Bewertungsanalysen abrufen

KPIs (mit Perioden-über-Perioden-Deltas), ein monatlicher Trend (Volumen, Bewertung, Stimmungsmix, Antwortquote), Bewertungsverteilung, Aufschlüsselung je Plattform, Timing nach Wochentag, ein Agentur-Benchmark, Themen und eine KI-Zusammenfassung — für einen Standort.

get/api/v1/reviews/analytics
reviews:read
Query-Parameter
locationIdstringerforderlich
Der abzufragende Standort.
clientIdstringerforderlich
Der Kunde des Standorts.
kpiDaysinteger (7 | 30 | 90)optional
KPI-Zeitfenster in Tagen: 7, 30 oder 90. Standard 30.
trendMonthsinteger (3 | 6 | 12)optional
Trend-Länge in Monaten: 3, 6 oder 12. Standard 6.
Antwort
dataobjectoptional
Die vollständigen Bewertungsanalyse-Daten.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
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.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/reviews/analytics
Ihr API-Schlüssel
locationId *
clientId *
kpiDays
trendMonths
{
  "data": {
    "total": 210,
    "kpis": {
      "totalReviews": {
        "value": 210,
        "delta": 14
      },
      "avgRating": {
        "value": 4.4,
        "delta": 0.1
      },
      "responseRate": {
        "value": 91,
        "delta": 3
      },
      "newReviews": {
        "value": 14,
        "delta": 3
      }
    },
    "spark": {
      "counts": [
        1,
        2,
        0,
        3,
        1,
        2
      ],
      "ratings": [
        4,
        5,
        0,
        4,
        5,
        4
      ],
      "response": [
        1,
        2,
        0,
        3,
        1,
        2
      ]
    },
    "trend": {
      "months": [
        "2026-01",
        "2026-02"
      ],
      "count": [
        96,
        114
      ],
      "avgRating": [
        4.3,
        4.4
      ],
      "positive": [
        78,
        92
      ],
      "neutral": [
        12,
        14
      ],
      "negative": [
        6,
        8
      ],
      "responseRate": [
        88,
        91
      ]
    },
    "distribution": [
      4,
      8,
      12,
      60,
      126
    ],
    "byPlatform": [
      {
        "platform": "google",
        "label": "Google",
        "count": 160,
        "avgRating": 4.5
      }
    ],
    "response": {
      "replied": 204,
      "unreplied": 6,
      "unrepliedNegative": 2,
      "rate": 97
    },
    "themes": [
      {
        "keyword": "friendly staff",
        "count": 42,
        "avgRating": 4.8,
        "sentiment": "positive"
      }
    ],
    "timing": [
      10,
      20,
      30,
      40,
      50,
      60,
      0
    ],
    "benchmark": {
      "rating": {
        "location": 4.4,
        "agency": 4.2
      },
      "responseRate": {
        "location": 91,
        "agency": 84
      }
    },
    "recentUnrepliedNegatives": [
      {
        "id": "rev_1",
        "author": "Jane D.",
        "rating": 2,
        "platform": "google",
        "platformLabel": "Google",
        "body": "Long wait time.",
        "date": "2026-02-01T12:00:00.000Z"
      }
    ],
    "aiSummary": "Ratings trended up this month, driven mostly by praise for staff friendliness."
  }
}

Anleitungen, die diesen Endpunkt verwenden