Charts

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.

get/api/charts/tiktok/users

Request

Query parameters

datestring date-time

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

interval'daily' | 'weekly' | 'monthly' | 'semi-yearly' | 'yearly' | 'all_time'

Chart interval (e.g. daily, weekly, monthly).

type'likes' | 'followers' required

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

limitinteger

Maximum entries returned (≤100).

offsetinteger

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

latestboolean

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

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.