Get TikTok Top-Video Chart

​

Return the TikTok top-video chart. Each row merges video-track-basic-info with the chart row and carries both rankStats (rank + views history) and viewStats (views-only slice of the same history).

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

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

  • limit
    Type: integer
    max:  
    100

    Maximum entries returned (≤100).

  • 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).

  • latest
    Type: boolean

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

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

{
  "obj": {
    "length": 1,
    "data": [
      {
        "id": "6981234567890123456",
        "tiktok_video": "6981234567890123456",
        "name": "Viral clip",
        "rank": 1,
        "added_at": "2024-05-01T00:00:00.000Z",
        "velocity": 0,
        "pre_rank": 1,
        "peak_rank": 1,
        "peak_date": "2024-04-28T00:00:00.000Z",
        "time_on_chart": "12",
        "views": 411800,
        "likes": 72500,
        "comments": 222,
        "rankStats": [
          {
            "rank": 1,
            "views": 411800,
            "timestp": "2024-04-30T00:00:00.000Z"
          }
        ],
        "viewStats": [
          {
            "views": 411800,
            "timestp": "2024-04-30T00:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Success