💎 Premium — List Top TikTok Videos for an Artist

​

Top TikTok videos using any of the artist's sounds. Takes the same paging and filter params as the track route, and each row carries track_name so a caller can tell which of the artist's tracks a video used. Page with limit and offset, narrow with postedWithinDaysAgo or the min/max metric bounds, and set withTotal=true to receive the rows inside an envelope carrying total and available_count rather than as a bare array.

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

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
Query Parameters
  • type
    Type: string enum

    Sort metric for the returned videos. Defaults to likes; allowed values come from TikTok engagement stats.

    values
    • likes
    • views
    • comments
    • followers
    • created_at
    • trending
    • modified_at
    • saves
    • shares
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Maximum number of videos to return. Max 100.

  • offset
    Type: integer
    min:  
    0
    max:  
    10000

    Number of videos to skip from the start of the result set, for paging past the first limit rows. Defaults to 0, max 10,000.

  • sortOrderDesc
    Type: boolean

    Sort direction for type. Defaults to true (highest first).

  • withTotal
    Type: boolean

    If true, wrap the videos in an object carrying total and available_count so a caller can page to the end. Defaults to false, which returns the bare array.

  • postedWithinDaysAgo
    Type: integer
    min:  
    0

    Only return videos posted within this many days. Omit to cover all time.

  • fromDaysAgo
    Type: integer
    min:  
    0
    max:  
    365

    Window in days used as the baseline for the change-rate fields. Defaults to 28, max 365.

  • minViews
    Type: integer
    min:  
    0

    Only return videos with at least this many views.

  • maxViews
    Type: integer
    min:  
    0

    Only return videos with at most this many views.

  • minLikes
    Type: integer
    min:  
    0

    Only return videos with at least this many likes.

  • maxLikes
    Type: integer
    min:  
    0

    Only return videos with at most this many likes.

  • minComments
    Type: integer
    min:  
    0

    Only return videos with at least this many comments.

  • maxComments
    Type: integer
    min:  
    0

    Only return videos with at most this many comments.

  • minShares
    Type: integer
    min:  
    0

    Only return videos with at least this many shares.

  • maxShares
    Type: integer
    min:  
    0

    Only return videos with at most this many shares.

  • minSaves
    Type: integer
    min:  
    0

    Only return videos with at least this many saves.

  • maxSaves
    Type: integer
    min:  
    0

    Only return videos with at most this many saves.

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

{
  "obj": [
    {
      "created_at": "2026-05-11 00:00:00",
      "modified_at": "2026-08-19",
      "username": "haileybieber",
      "followers": 19338972,
      "video_id": "7638754937748360478",
      "cm_id": 11647783,
      "sound_id": "x-7559312683885201425",
      "tiktok": 25646255,
      "cm_track": 154524166,
      "tiktok_video": 845854366,
      "influencerCountries": [
        "US"
      ],
      "avatar_url": "https://d2xuw6r9djpzwq.cloudfront.net/tiktok/users/6772347709954851846.jpg",
      "link": "https://www.tiktok.com/@haileybieber/video/7638754937748360478",
      "stats": {
        "likes": 3056560,
        "comments": 13728,
        "views": 27629256,
        "shares": 74701,
        "saves": 138553
      },
      "description": "Choosin' Texas",
      "thumbnail_url": "https://d2xuw6r9djpzwq.cloudfront.net/tiktok/videos/7638754937748360478.jpg",
      "tiktokVideoHistoricalStats": [
        {
          "views": 25600000,
          "likes": 2900000,
          "shares": 73100,
          "saves": 133600,
          "comments": 13300,
          "timestp": "2026-07-08"
        },
        {
          "views": 25700000,
          "likes": 2900000,
          "shares": 73200,
          "saves": 133900,
          "comments": 13300,
          "timestp": "2026-07-09"
        }
      ],
      "likesPercentChange": null,
      "commentsPercentChange": null,
      "viewsPercentChange": null,
      "sharesPercentChange": null,
      "savesPercentChange": null,
      "likesValueChange": null,
      "commentsValueChange": null,
      "viewsValueChange": null,
      "sharesValueChange": null,
      "savesValueChange": null
    }
  ]
}

Success