💎 Premium — Get Influencer Breakdown for a Track
Distribution of the TikTok creators who used the track's sounds, one axis per call. dimension selects the axis: country, category (broad content categories), subcategory (the granular creator tags beneath them), age-gender, or language. Aggregates only — the endpoint reports how many creators fall in each bucket, not who they are. A creator holds exactly one country, age/gender bucket and language, so those shares sum to 1 and total is the creator count; a creator can hold several categories, so category and subcategory return counts with share and total null and multi_label true.
Path Parameters
- Type: integeridmin:0max:2147483647required
Chartmetric track ID.
Query Parameters
- Type: stringenumdimension
Which breakdown to return.
categoryis the broad creator-content layer,subcategorythe granular one; a creator can hold several of either, so those two report counts without a share.valuescountrycategorysubcategoryage-genderlanguage - Type: numberFormat: floatenumperiod
Days Rolling window, in days, over the date creators last posted with the track's sounds.
0covers all time.values073090
Responses
- application/json
curl 'https://api.chartmetric.com/api/track/1/tiktok-influencer-stats?dimension=country&periodDays=0' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"obj": {
"dimension": "age-gender",
"period_days": 30,
"total": 91,
"multi_label": false,
"available_period_days": [
0,
7,
30,
90
],
"data": [
{
"value": "25-34|female",
"age_group": "25-34",
"gender": "female",
"count": 31,
"share": 0.340659,
"delta": 6
},
{
"value": "18-24|female",
"age_group": "18-24",
"gender": "female",
"count": 30,
"share": 0.32967,
"delta": -6
}
]
}
}