CHchartmetric
Track

💎 Premium — List Top TikTok Influencers for a Track

The TikTok creators who used the track's sound, one row each -- the table the app shows on its TikTok page. Where the breakdown endpoint reports how the group splits by country or language, this reports who the creators are. Paged and filterable on every column the app's own filters use; total counts what matches the current filters rather than the whole set.

get/api/track/{id}/tiktok-top-influencers

Request

Path parameters

idinteger required

Chartmetric track ID.

Query parameters

limitinteger

Influencers per page. Defaults to 25, max 100.

offsetinteger

Influencers to skip, for paging past the first limit rows. Defaults to 0, max 10,000.

sortBy'rank' | 'totalFollowers' | 'totalViews' | 'totalLikes' | 'totalComments' | 'engagementRate' | 'totalSaves' | 'totalShares' | 'dateAdded' | 'avgViews' | 'avgLikes' | 'avgComments' | 'avgSaves' | 'avgShares' | 'avgEngagementRate' | 'videoCount' | 'lastDatePosted'

Column to sort by. Defaults to rank, the order the app lists them in.

sortDirection'asc' | 'desc'

Sort direction. Defaults to asc.

isVerifiedboolean

Restrict to verified accounts when true, unverified when false. Omit for both.

country[]string[]

ISO 3166-1 alpha-2 country codes to include. Repeat the param or pass a comma-free list.

categories[]string[]

Broad content categories to include. Repeat the param or pass a comma-free list.

ageGroup[]string[]

Age brackets, e.g. 18-24 to include. Repeat the param or pass a comma-free list.

gender[]string[]

Genders to include. Repeat the param or pass a comma-free list.

ethnicity[]string[]

Ethnicities to include. Repeat the param or pass a comma-free list.

language[]string[]

Primary languages to include. Repeat the param or pass a comma-free list.

type[]string[]

Creator types, e.g. Brand to include. Repeat the param or pass a comma-free list.

minFollowersnumber float

Only influencers with at least this followers.

maxFollowersnumber float

Only influencers with at most this followers.

minAvgViewsnumber float

Only influencers with at least this average views.

maxAvgViewsnumber float

Only influencers with at most this average views.

minAvgLikesnumber float

Only influencers with at least this average likes.

maxAvgLikesnumber float

Only influencers with at most this average likes.

minAvgCommentsnumber float

Only influencers with at least this average comments.

maxAvgCommentsnumber float

Only influencers with at most this average comments.

minAvgSavesnumber float

Only influencers with at least this average saves.

maxAvgSavesnumber float

Only influencers with at most this average saves.

minAvgSharesnumber float

Only influencers with at least this average shares.

maxAvgSharesnumber float

Only influencers with at most this average shares.

minAvgEngagementRatenumber float

Only influencers with at least this average engagement rate.

maxAvgEngagementRatenumber float

Only influencers with at most this average engagement rate.

minVideoCountnumber float

Only influencers with at least this video count.

maxVideoCountnumber float

Only influencers with at most this video count.

lastDatePostedFromstring

Only influencers who last posted on or after this date (YYYY-MM-DD).

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.