Get TikTok Top-User Chart

​

Return the TikTok top-user chart by type (likes / followers) and interval (daily / weekly / all_time). Each row merges the TikTok user basic info (from #getArtistInfoForPlatformMap) with the chart row + rankStats history.

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, monthly).

    values
    • daily
    • weekly
    • monthly
    • semi-yearly
    • yearly
    • all_time
  • type
    Type: string enum
    required

    TikTok user chart type (e.g. likes, followers, viewer_hours).

    values
    • likes
    • followers
  • 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/users
curl 'https://api.chartmetric.com/api/charts/tiktok/users?type=likes' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": 1,
    "data": [
      {
        "tiktok_user": "sample_user",
        "cm_artist": 123456,
        "name": "Sample User",
        "image_url": "https://example.com/avatar.jpg",
        "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",
        "followers": 15000000,
        "rankStats": [
          {
            "rank": 1,
            "followers": 15000000,
            "timestp": "2024-04-30T00:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Success