v1Ressourcen/Reviews/getLängere Monatsreihe eines Themas abrufen

Längere Monatsreihe eines Themas abrufen

Erfordert reviews:read und Zugriff auf clientId. locationId für einen Standort angeben oder für die monatliche Kundenübersicht weglassen. tag beschränkt nur die Kundenübersicht und darf nicht mit locationId kombiniert werden. months ist standardmäßig 12; Kundenübersichten unterstützen 1–24 Monate. Nutzt gespeicherte Bewertungsdaten.

get/api/v1/reviews/topic-trends/series
reviews:read
Query-Parameter
locationIdstringoptional
clientIdstringerforderlich
monthsintegeroptional
Reihenlänge in Monaten. Standard 12.
tagstringoptional
Antwort
dataobjectoptional
Die vollständigen Themen-Monatsreihen-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/topic-trends/series
Ihr API-Schlüssel
locationId
clientId *
months
tag
{
  "data": {
    "months": [
      "2026-01",
      "2026-02"
    ],
    "topics": [
      {
        "topic": "friendly staff",
        "origin": "auto",
        "total": 70,
        "monthly": [
          {
            "count": 28,
            "positive": 25,
            "neutral": 2,
            "negative": 1
          },
          {
            "count": 42,
            "positive": 38,
            "neutral": 3,
            "negative": 1
          }
        ]
      }
    ]
  }
}

Anleitungen, die diese Ressource verwenden