Charts

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.

get/api/charts/tiktok/tracks

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, all_time); defaults to all_time.

limitinteger

Maximum number of items to return per request.

offsetinteger

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

countryChartboolean

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

code2string

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

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.