--- title: "💎 Premium — List Top TikTok Influencers for a Track" method: GET path: "/api/track/{id}/tiktok-top-influencers" tags: ["Track"] --- # 💎 Premium — List Top TikTok Influencers for a Track `GET /api/track/{id}/tiktok-top-influencers` ## Request - Base URL: `https://api.chartmetric.com` - URL: `https://api.chartmetric.com/api/track/{id}/tiktok-top-influencers` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Path parameters - `id` integer, required: Chartmetric track ID. ## Query parameters - `limit` integer: Influencers per page. Defaults to 25, max 100. - `offset` integer: 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`. - `isVerified` boolean: 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. - `minFollowers` number, float: Only influencers with at least this followers. - `maxFollowers` number, float: Only influencers with at most this followers. - `minAvgViews` number, float: Only influencers with at least this average views. - `maxAvgViews` number, float: Only influencers with at most this average views. - `minAvgLikes` number, float: Only influencers with at least this average likes. - `maxAvgLikes` number, float: Only influencers with at most this average likes. - `minAvgComments` number, float: Only influencers with at least this average comments. - `maxAvgComments` number, float: Only influencers with at most this average comments. - `minAvgSaves` number, float: Only influencers with at least this average saves. - `maxAvgSaves` number, float: Only influencers with at most this average saves. - `minAvgShares` number, float: Only influencers with at least this average shares. - `maxAvgShares` number, float: Only influencers with at most this average shares. - `minAvgEngagementRate` number, float: Only influencers with at least this average engagement rate. - `maxAvgEngagementRate` number, float: Only influencers with at most this average engagement rate. - `minVideoCount` number, float: Only influencers with at least this video count. - `maxVideoCount` number, float: Only influencers with at most this video count. - `lastDatePostedFrom` string: Only influencers who last posted on or after this date (`YYYY-MM-DD`). ## Response `200` Success - object - `obj` object - `data` object[], required: Influencers on this page. - `full_name` string, nullable: The creator's display name. - `handle` string, nullable: TikTok handle, including the leading `@`. - `is_verified` boolean: Whether TikTok verifies the account. - `country` string, nullable: ISO 3166-1 alpha-2 code for the creator's own country. - `contacts` string[]: Public contact links the creator lists. - `type` string, nullable: Creator classification, e.g. `Brand`, `Celebrity`, `Social Media Creator`. - `language` string, nullable: The creator's primary language, lower-case. - `ethnicity` string[]: Ethnicities attributed to the creator, lower-case. - `age_group` string, nullable: Age bracket, e.g. `18-24`. - `gender` string, nullable: Gender, lower-case. - `categories` string[]: Broad content categories. - `sub_categories` string[]: Granular creator tags underneath those categories. - `top_hashtags` string[]: Hashtags the creator uses most. - `genres` string[]: Music genres attributed to the creator. - `bio` string, nullable: The creator's TikTok bio. - `featured_track` string, nullable: Name of the track their video used. - `followers` integer, nullable: TikTok follower count. - `engagement_rate` number, float, nullable: Engagement rate averaged across the creator's recent videos. - `avg_views` integer, nullable: Views averaged across those videos. - `avg_likes` integer, nullable: Likes averaged across those videos. - `avg_comments` integer, nullable: Comments averaged across those videos. - `avg_saves` integer, nullable: Saves averaged across those videos. - `avg_shares` integer, nullable: Shares averaged across those videos. - `video_count` integer, nullable: Videos on the account. - `top_videos` object[]: Up to five of the creator's videos using the queried sounds. - `video_id` string, nullable: TikTok's ID for the video. - `video_url` string, nullable: Direct link to the video. - `thumbnail_url` string, nullable: Thumbnail URL. - `views` integer, nullable: Views on the video. - `likes` integer, nullable: Likes on the video. - `comments` integer, nullable: Comments on the video. - `saves` integer, nullable: Saves on the video. - `shares` integer, nullable: Shares on the video. - `engagement_rate` number, float, nullable: Engagement rate for the video. - `created_at` string, nullable: Date the video was posted. - `description` string, nullable: The video's caption. - `track_name` string, nullable: Track the video's sound belongs to. - `total` integer, required: Influencers matching the current filters, across all pages. --- [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)