Get TikTok Top-Track Chart

​

Return the TikTok top-track chart — either the post-based chart (default) or the country-based chart when countryChart=true. Each row merges track-basic-info with the chart row and a rankStats history carrying rank + posts.

Query Parameters
  • date
    Type: string Format: date-time

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

  • interval
    Type: string enum

    Chart interval (e.g. daily, weekly, all_time); defaults to all_time.

    values
    • daily
    • weekly
    • monthly
    • semi-yearly
    • yearly
    • all_time
  • 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).

  • countryChart
    Type: boolean

    If true, return the country chart and use code2. Otherwise, return the post chart.

  • 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
curl https://api.chartmetric.com/api/charts/tiktok/tracks \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": 1,
    "data": [
      {
        "id": 31475,
        "tiktok_track_id": "Laxed-Siren-Beat-6804093117843770118",
        "tiktok": 31475,
        "name": "Laxed - Siren Beat",
        "isrc": "NZAM02001128",
        "image_url": "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-i-0000/79fc18806b60494cb9117888b5a5f621.jpeg",
        "cm_track": 29203381,
        "tiktok_artist_names": [
          "Jawsh 685"
        ],
        "tiktok_track_ids": [
          "Laxed-Siren-Beat-6804093117843770118"
        ],
        "album_ids": [
          5963064
        ],
        "album_names": [
          "Laxed (Siren Beat)"
        ],
        "album_upc": [
          "9420058747152"
        ],
        "album_label": [
          "Jawsh 685"
        ],
        "release_dates": [
          "2020-04-24T07:00:00.000Z"
        ],
        "rank": 1,
        "posts": 55300000,
        "added_at": "2020-10-11T07:00:00.000Z",
        "velocity": 0,
        "pre_rank": 1,
        "peak_rank": 1,
        "peak_date": "2020-08-27T07:00:00.000Z",
        "time_on_chart": "171",
        "rankStats": [
          {
            "rank": 1,
            "posts": 55300000,
            "timestp": "2020-10-04T07:00:00.000Z"
          }
        ],
        "views": 411800,
        "views_prev": 380000
      }
    ]
  }
}

Success