---
title: "💎 Premium — Get Influencer Breakdown for a Track"
method: GET
path: "/api/track/{id}/tiktok-influencer-stats"
tags: ["Track"]
---

# 💎 Premium — Get Influencer Breakdown for a Track

`GET /api/track/{id}/tiktok-influencer-stats`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/track/{id}/tiktok-influencer-stats`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/track/:id/tiktok-influencer-stats/get.ts> (a function with typed inputs; its response is checked against the schema)

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

- `id` integer, required: Chartmetric track ID.

## Query parameters

- `dimension` 'country' | 'category' | 'subcategory' | 'age-gender' | 'language': Which breakdown to return. `category` is the broad creator-content layer, `subcategory` the granular one; a creator can hold several of either, so those two report counts without a share.
- `periodDays` 0 | 7 | 30 | 90, float: Rolling window, in days, over the date creators last posted with the track's sounds. `0` covers all time.

## Response `200`

Success

- object
  - `obj` object
    - `dimension` 'country' | 'category' | 'subcategory' | 'age-gender' | 'language', required: The requested dimension, echoed back.
    - `period_days` 0 | 7 | 30 | 90, float, required: The requested rolling window in days, echoed back. `0` covers all time.
    - `total` integer, nullable: Creators the distribution covers. Null on the multi-label dimensions, where counts cannot be summed into a creator total.
    - `multi_label` boolean, required: True when a creator can appear in more than one bucket — `category` and `subcategory`. Those dimensions report counts without a share.
    - `available_period_days` number[], nullable: Windows this data is held for. Populated for `age-gender` and `language`; null elsewhere.
    - `data` object[], required: Buckets, largest first.
      - `value` string, required: Bucket label — an ISO 3166-1 alpha-2 code for `country`, `age|gender` for `age-gender`, otherwise the category, tag or language name.
      - `count` integer, required: Creators in this bucket.
      - `share` number, float, nullable: Bucket's fraction of `total`, 0–1. Null on the multi-label dimensions.
      - `delta` integer, nullable: Change in `count` against the preceding window of the same length. Null where the dimension carries no comparison.
      - `age_group` string, nullable: Age bracket half of `value`. Present on `age-gender` only; null when the classifier resolved a gender but no age.
      - `gender` string, nullable: Gender half of `value`. Present on `age-gender` only; null when the classifier resolved an age but no gender.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)