v1Resources/Reviews/getGet competitive review analysis
Get competitive review analysis
Benchmark a location's reviews against its tracked competitors: scorecard, strengths/gaps, and review velocity + share-of-voice.
get
reviews:read/api/v1/reviews/competitors/analysisQuery parameters
locationIdstringrequired
clientIdstringrequired
Response
dataobjectoptional
The full competitive analysis payload (scorecard, strengths/gaps, velocity).
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/competitors/analysis
Your API key
locationId *
clientId *
{
"data": {
"asOf": "2026-02-01T06:00:00.000Z",
"self": {
"profileId": "self",
"kind": "self",
"deep": true,
"name": "Acme Dental — Downtown",
"avgRating": 4.4,
"reviewCount": 210,
"newThisMonth": 14,
"distribution": [
4,
8,
12,
60,
126
],
"sentiment": {
"positive": 172,
"neutral": 24,
"negative": 14
},
"netSentiment": 0.75,
"themes": [
{
"keyword": "friendly staff",
"count": 42,
"sentiment": "positive"
}
]
},
"competitors": [
{
"profileId": "cm_comp_1",
"kind": "competitor",
"deep": true,
"name": "Smile Bright Dental",
"avgRating": 4.6,
"reviewCount": 340,
"newThisMonth": 18,
"distribution": [
3,
5,
10,
80,
242
],
"sentiment": {
"positive": 290,
"neutral": 30,
"negative": 20
},
"netSentiment": 0.79,
"themes": [
{
"keyword": "wait time",
"count": 20,
"sentiment": "negative"
}
]
}
],
"velocity": {
"months": [
"2026-01",
"2026-02"
],
"series": [
{
"profileId": "self",
"name": "Acme Dental — Downtown",
"kind": "self",
"counts": [
96,
114
]
},
{
"profileId": "cm_comp_1",
"name": "Smile Bright Dental",
"kind": "competitor",
"counts": [
110,
128
]
}
],
"shareOfVoice": 0.42
},
"themeGap": {
"rivalsWin": [
"online booking"
],
"youLead": [
"friendly staff"
]
},
"aiSummary": "You're competitive on rating but trail on review velocity this month.",
"recommendations": [
"Ask satisfied patients to mention specific services by name."
]
}
}