List Top TikTok Videos for a Track

​

Return the top TikTok videos associated with a track. When type=trending only, returns trending videos; otherwise the top videos by the selected sort. cm_id is populated when the poster is linked to a Chartmetric artist.

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

    Chartmetric track ID.

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.

  • byTiktokId
    Type: boolean

    If true, treat id as a TikTok sound ID (string-internally) rather than a Chartmetric track ID. Defaults to false.

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

{
  "obj": [
    {
      "created_at": "2021-04-23T07:09:53.962Z",
      "username": "ivanmarsiglia",
      "video_id": "6953643605160480005",
      "thumbnail_url": "https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/1d79b9af19d543349c0e225fef89e01d",
      "followers": 290700,
      "cm_id": null,
      "link": "https://www.tiktok.com/@ivanmarsiglia/video/6953643605160480005",
      "stats": {
        "likes": 8400000,
        "comments": 82100,
        "views": 54100000
      }
    }
  ]
}

Success