Synup
Schlüssel erstellen
v1Ressourcen/Reviews/getBewertungszusammenfassung abrufen

Bewertungszusammenfassung abrufen

Liefert eine zusammengefasste Bewertungsübersicht für Ihre gesamte Agentur (oder einen Kunden) — Bewertungsverteilung, Volumen und Trend über den ausgewählten Zeitraum.

get/api/v1/reviews/summary
reviews:read
Query-Parameter
clientIdstringoptional
Auf die Bewertungen eines Kunden beschränken. Weggelassen, werden alle Bewertungen zusammengefasst, die Ihr Schlüssel sehen kann.
tagsstringoptional
Auf Standorte mit einem dieser durch Komma getrennten internen Tags beschränken.
fromstringoptional
Beginn des Zeitraums (einschließlich), als JJJJ-MM-TT. Standardmäßig ein rollierendes Zeitfenster der letzten Zeit.
tostringoptional
Ende des Zeitraums (einschließlich), als JJJJ-MM-TT. Standardmäßig heute.
Antwort
dataobjectoptional
Die zusammengefasste Übersicht — Bewertungsverteilung, Bewertungsvolumen und Trenddaten für den ausgewählten Zeitraum.
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/summary
Ihr API-Schlüssel
clientId
tags
from
to
{
  "data": {
    "period": 30,
    "summary": {
      "locations": 5,
      "totalReviews": 210,
      "avgRating": 4.4,
      "totalUnreplied": 6,
      "positivePct": 82,
      "newInPeriod": 14,
      "newDelta": 3,
      "staleCount": 2,
      "deltas": {
        "totalReviews": 14,
        "avgRating": 0.1,
        "unreplied": -2,
        "positivePct": 4
      },
      "spark": {
        "counts": [
          1,
          2,
          0,
          3,
          1,
          2
        ],
        "ratings": [
          4,
          5,
          0,
          4,
          5,
          4
        ]
      }
    },
    "best": {
      "locationId": "cm_loc_1",
      "name": "Acme Dental — Downtown",
      "city": "Austin",
      "total": 90,
      "avgRating": 4.8,
      "positive": 78,
      "neutral": 8,
      "negative": 4,
      "replied": 88,
      "unreplied": 2,
      "unrepliedNegative": 0,
      "responseRate": 98,
      "benchmark": "good",
      "healthScore": 91,
      "ratingTrendDelta": 0.2,
      "velocityDelta": 6,
      "newInPeriod": 8,
      "daily": [
        1,
        2,
        0,
        3,
        1,
        2
      ],
      "lastReviewDate": "2026-02-05T09:00:00.000Z",
      "staleDays": null,
      "topPositiveTheme": "friendly staff",
      "topNegativeTheme": null,
      "tags": [
        "priority"
      ],
      "pct5": 70,
      "pctLte2": 4,
      "distribution": [
        1,
        3,
        8,
        22,
        56
      ],
      "netSentiment": 82,
      "oldestUnrepliedDays": 2,
      "daysSinceNegative": 9,
      "reviewsPerWeek": 1.9,
      "healthDelta": 3,
      "pctOfBook": 43
    },
    "worst": {
      "locationId": "cm_loc_2",
      "name": "Acme Dental — Eastside",
      "city": "Austin",
      "total": 60,
      "avgRating": 3.9,
      "positive": 38,
      "neutral": 12,
      "negative": 10,
      "replied": 40,
      "unreplied": 4,
      "unrepliedNegative": 2,
      "responseRate": 67,
      "benchmark": "improve",
      "healthScore": 58,
      "ratingTrendDelta": -0.1,
      "velocityDelta": 1,
      "newInPeriod": 6,
      "daily": [
        0,
        1,
        1,
        0,
        2,
        1
      ],
      "lastReviewDate": "2026-02-04T09:00:00.000Z",
      "staleDays": null,
      "topPositiveTheme": "clean office",
      "topNegativeTheme": "wait time",
      "tags": [],
      "pct5": 45,
      "pctLte2": 12,
      "distribution": [
        3,
        4,
        12,
        15,
        26
      ],
      "netSentiment": 47,
      "oldestUnrepliedDays": 6,
      "daysSinceNegative": 1,
      "reviewsPerWeek": 1.4,
      "healthDelta": -2,
      "pctOfBook": 29
    },
    "rows": [],
    "trend": {
      "months": [
        "2026-01",
        "2026-02"
      ],
      "locations": [
        {
          "locationId": "cm_loc_1",
          "name": "Acme Dental — Downtown",
          "healthScore": 91,
          "count": [
            42,
            48
          ],
          "avgRating": [
            4.6,
            4.8
          ]
        }
      ]
    }
  }
}

Anleitungen, die diesen Endpunkt verwenden