💎 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.

Path Parameters
  • id
    Type: integer
    min:  
    0
    max:  
    2147483647
    required

    Chartmetric track ID.

Query Parameters
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Influencers per page. Defaults to 25, max 100.

  • offset
    Type: integer
    min:  
    0
    max:  
    10000

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

  • sortBy
    Type: string enum

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

    values
    • rank
    • totalFollowers
    • totalViews
    • totalLikes
    • totalComments
  • sortDirection
    Type: string enum

    Sort direction. Defaults to asc.

    values
    • asc
    • desc
  • isVerified
    Type: boolean

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

  • country[]
    Type: array string[]

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

  • categories[]
    Type: array string[]

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

  • ageGroup[]
    Type: array string[]

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

  • gender[]
    Type: array string[]

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

  • ethnicity[]
    Type: array string[]

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

  • language[]
    Type: array string[]

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

  • type[]
    Type: array string[]

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

  • minFollowers
    Type: number Format: float

    Only influencers with at least this followers.

  • maxFollowers
    Type: number Format: float

    Only influencers with at most this followers.

  • minAvgViews
    Type: number Format: float

    Only influencers with at least this average views.

  • maxAvgViews
    Type: number Format: float

    Only influencers with at most this average views.

  • minAvgLikes
    Type: number Format: float

    Only influencers with at least this average likes.

  • maxAvgLikes
    Type: number Format: float

    Only influencers with at most this average likes.

  • minAvgComments
    Type: number Format: float

    Only influencers with at least this average comments.

  • maxAvgComments
    Type: number Format: float

    Only influencers with at most this average comments.

  • minAvgSaves
    Type: number Format: float

    Only influencers with at least this average saves.

  • maxAvgSaves
    Type: number Format: float

    Only influencers with at most this average saves.

  • minAvgShares
    Type: number Format: float

    Only influencers with at least this average shares.

  • maxAvgShares
    Type: number Format: float

    Only influencers with at most this average shares.

  • minAvgEngagementRate
    Type: number Format: float

    Only influencers with at least this average engagement rate.

  • maxAvgEngagementRate
    Type: number Format: float

    Only influencers with at most this average engagement rate.

  • minVideoCount
    Type: number Format: float

    Only influencers with at least this video count.

  • maxVideoCount
    Type: number Format: float

    Only influencers with at most this video count.

  • lastDatePostedFrom
    Type: string

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

Responses
  • application/json
Request Example for get/api/track/{id}/tiktok-top-influencers
curl https://api.chartmetric.com/api/track/1/tiktok-top-influencers \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "total": 384,
    "data": [
      {
        "full_name": "Hailey Bieber",
        "handle": "@haileybieber",
        "is_verified": true,
        "country": "US",
        "contacts": [],
        "type": "Celebrity",
        "language": "english",
        "ethnicity": [
          "white"
        ],
        "age_group": "25-34",
        "gender": "female",
        "categories": [
          "Beauty & Cosmetics"
        ],
        "sub_categories": [
          "makeup",
          "skincare"
        ],
        "top_hashtags": [
          "rhodeskin",
          "grwm"
        ],
        "genres": [
          "pop"
        ],
        "bio": "founder of rhode",
        "featured_track": "Choosin' Texas",
        "followers": 19338972,
        "engagement_rate": 0.0077,
        "avg_views": 418531,
        "avg_likes": 42600,
        "avg_comments": 253,
        "avg_saves": 2024,
        "avg_shares": 1875,
        "video_count": 8233,
        "top_videos": [
          {
            "video_id": "7638754937748360478",
            "video_url": "https://www.tiktok.com/@haileybieber/video/7638754937748360478",
            "thumbnail_url": "https://d2xuw6r9djpzwq.cloudfront.net/tiktok/videos/7638754937748360478.jpg",
            "views": 27629256,
            "likes": 3056560,
            "comments": 13728,
            "saves": 138553,
            "shares": 74701,
            "engagement_rate": 0.1161,
            "created_at": "2026-05-11",
            "description": "Choosin' Texas",
            "track_name": "Choosin' Texas"
          }
        ]
      }
    ]
  }
}

Success