Synup
Schlüssel erstellen
v1Ressourcen/Reviews/getThemen-Trends abrufen

Themen-Trends abrufen

Eine gebündelte Zeitreihe je Bewertungsthema, eine Bestenliste, steigende/fallende Bewegungen sowie aufkommende/verblassende Themen — für einen Standort.

get/api/v1/reviews/topic-trends
reviews:read
Query-Parameter
locationIdstringerforderlich
clientIdstringerforderlich
windowDaysinteger (30 | 90 | 180)optional
Trend-Zeitfenster in Tagen: 30, 90 oder 180. Standard 90.
Antwort
dataobjectoptional
Die vollständigen Themen-Trends-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
Ihr API-Schlüssel
locationId *
clientId *
windowDays
{
  "data": {
    "window": 90,
    "total": 210,
    "tagged": 180,
    "topics": [
      {
        "topic": "friendly staff",
        "origin": "auto",
        "mentions": 42,
        "positive": 38,
        "neutral": 3,
        "negative": 1,
        "avgRating": 4.8,
        "monthly": [
          {
            "count": 14,
            "positive": 12,
            "neutral": 1,
            "negative": 1
          },
          {
            "count": 28,
            "positive": 26,
            "neutral": 2,
            "negative": 0
          }
        ],
        "deltaMentions": 14,
        "deltaNetSentiment": 0.08
      }
    ],
    "rising": [
      {
        "topic": "friendly staff",
        "deltaMentions": 14,
        "thisMentions": 42,
        "netSentiment": 0.92,
        "deltaNetSentiment": 0.08
      }
    ],
    "declining": [
      {
        "topic": "wait time",
        "deltaMentions": -5,
        "thisMentions": 12,
        "netSentiment": -0.4,
        "deltaNetSentiment": -0.15
      }
    ],
    "emerging": [
      "online booking"
    ],
    "faded": [],
    "narrative": "Mentions of friendly staff are up sharply this month."
  }
}

Anleitungen, die diesen Endpunkt verwenden