TOOL API

tto_tcm_rank_get

Gets a paginated list of up to 100 US creators who rank highest for a specified ranking label on the TikTok One (TTO) Creator Leaderboard. Before calling this endpoint, obtain ranking labels from /tto/tcm/category/label/ with `label_type` set to `RANKING`.

ecommerceOAuth1 credits

Call information

Tool slug: tiktok-ads.tto_tcm_rank_get
Provider: TikTok for Business
Average response: 0 ms
Calls in 7 days: 0

Input parameters

country_coderequired

Country or region code for the creator ranking. Currently only `US` is supported because ranking data is available only for the United States.

label_idrequired

Creator label ID to rank by. When `ranking_type` is `BRANDED_CONTENT`, provide a creator industry label ID from `/tto/tcm/category/label/` returned in `industry_labels`. When `ranking_type` is `ORGANIC_CONTENT`, provide a content tag label ID from `/tto/tcm/category/label/` returned in `content_labels`.

page

Current page number. Must be greater than or equal to 1. Defaults to 1 if omitted.

page_size

Number of results per page. Valid range: 1-100. Defaults to 20 if omitted.

ranking_typerequired

Type of ranking. `BRANDED_CONTENT` ranks creators by branded content. `ORGANIC_CONTENT` ranks creators by organic content. This value also determines which kind of label must be provided in `label_id`.

time_periodrequired

Time period used for the ranking.

time_period_lookbackrequired

Specific lookback period for the selected `time_period`. `ONE` means the most recent available period, `TWO` the second most recent, and `THREE` the third most recent. For example, if the most recent available monthly period is October and you set `time_period` to `MONTH` and `time_period_lookback` to `TWO`, the API returns ranking data for September.

tto_tcm_account_idrequired

The ID of the TikTok One Creator Marketplace account. To obtain account IDs accessible by the current `Access-Token`, use /tto/oauth2/tcm/.