Get TikTok Tracks Chart by Type (V2 via CCC)

​

Return the TikTok tracks chart for a given chart_type (popular / breakout). Uses the CCC cm_chart_cache_v2 pipeline (Charts.getChartsFromCH → #hydrateChartRowsByEntity) and returns a bare array under obj (NOT wrapped in { length, data }).

Path Parameters
  • chart_type
    Type: string enum
    required

    TikTok track chart type (popular or breakout).

    values
    • popular
    • breakout
Query Parameters
  • date
    Type: string Format: date-time

    Date for the time-slice (YYYY-MM-DD). Required unless latest=true.

  • interval
    enum
    const:  
    weekly

    Chart interval; only weekly is supported on this endpoint.

    values
    • weekly
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Maximum number of items to return per request.

  • offset
    Type: integer
    min:  
    0
    max:  
    9900

    Number of items to skip; capped at 9900 because the underlying Elasticsearch window allows at most 10000 results (offset + limit).

  • code2
    Type: string
    min length:  
    2
    max length:  
    2

    ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

  • latest
    Type: boolean

    If true, use the most recently available date and ignore date.

Responses
  • application/json
Request Example for get/api/charts/tiktok/tracks/{chart_type}
curl https://api.chartmetric.com/api/charts/tiktok/tracks/popular \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "entityId": 15818551,
      "targetId": "2212754",
      "name": "My Boo - Hitman's Club Mix",
      "rank": 1,
      "chartedDate": "2025-05-05",
      "country": "US",
      "imageUrl": "https://i.scdn.co/image/df8c9d9318a5f598dba02de84323d97656d5adbe",
      "rankDiff": 1,
      "artists": [
        {
          "careerStage": "mainstream",
          "code2": "US",
          "id": 209688,
          "name": "Ghost Town DJs",
          "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb156aef8c73890e10b60e94d4"
        }
      ],
      "album": {
        "id": 903594,
        "name": "My Boo (Hitman's Club Mix)",
        "label": "Columbia",
        "releaseDate": "1996-03-26T00:00:00.000Z"
      },
      "externalId": "My-Boo-Hitman's-Club-Mix-6716386670813399041",
      "targetExtras": {
        "airplayStreams": 35174,
        "spotifyPlays": 160344152,
        "shazamCount": 3813848,
        "tiktokTopVideosViews": 79470645
      },
      "genre": "r&b/soul",
      "isChartGenre": false
    }
  ]
}

Success