curl --request GET \
--url https://app.usertick.com/api/public/v1/metrics/breakdown \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.usertick.com/api/public/v1/metrics/breakdown', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/metrics/breakdown"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"by": "type",
"surveyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"total": 123,
"buckets": [
{
"key": "<string>",
"label": "<string>",
"count": 123
}
]
}Get a breakdown
The analysis (type, urgency, theme, category, sentiment, with people’s corrections) or where responses came from (country, device). Largest first. The analysis dimensions answer every value; country and device answer the top largest and fold the rest into other. A response with no value on the dimension (not analyzed yet, or no theme matched) has no bucket, and a response with several themes counts in each, so the buckets may add up to less or more than total.
Scopes: analytics:read.
curl --request GET \
--url https://app.usertick.com/api/public/v1/metrics/breakdown \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.usertick.com/api/public/v1/metrics/breakdown', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/metrics/breakdown"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"by": "type",
"surveyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"total": 123,
"buckets": [
{
"key": "<string>",
"label": "<string>",
"count": 123
}
]
}Authorizations
An API key (utk_live_...) or an app's OAuth access token (uto_...).
Query Parameters
The dimension.
type, urgency, theme, category, sentiment, country, device country and device: how many values come back before the rest fold into other, 1 to 250, default 12.
1 <= x <= 250One survey.
From this time (RFC 3339; UTC when no offset).
Up to this time (RFC 3339; UTC when no offset). A date alone (2026-10-14) includes that whole UTC day.