Synup
Create a key
v1Resources/Reviews/getGet topic trends

Get topic trends

A bucketed time series per review topic, a leaderboard, rising/declining movers, and emerging/faded topics — for one location.

get/api/v1/reviews/topic-trends
reviews:read
Query parameters
locationIdstringrequired
clientIdstringrequired
windowDaysinteger (30 | 90 | 180)optional
Trend window in days: 30, 90, or 180. Defaults to 90.
Response
dataobjectoptional
The full Topic Trends payload.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/reviews/topic-trends
Your API key
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."
  }
}

Guides that use this endpoint