v1Resources/Reviews/getGet reviews mentioning a topic

Get reviews mentioning a topic

Drill into the reviews that mention one topic, optionally narrowed to one month.

get/api/v1/reviews/topic-trends/reviews
reviews:read
Query parameters
locationIdstringrequired
clientIdstringrequired
topicstringrequired
The topic to look up (from GET /api/v1/reviews/topic-trends).
monthstringoptional
Narrow to one heatmap cell (YYYY-MM). Omit for the full history.
limitintegeroptional
Max reviews to return.
Response
dataobjectoptional
reviewsarray of objectoptional
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/reviews
Your API key
locationId *
clientId *
topic *
month
limit
{
  "data": {
    "reviews": [
      {
        "id": "rev_1",
        "author": "Jane D.",
        "rating": 5,
        "body": "Everyone here is so friendly!",
        "sentiment": "positive",
        "topicSentiment": "positive",
        "platform": "google",
        "platformLabel": "Google",
        "date": "2026-02-01T12:00:00.000Z"
      }
    ]
  }
}

Guides that use this resource