工具 API
tto_
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`.
调用信息
- 工具标识
- tiktok-ads.tto_tcm_rank_get
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
country_code必填Country or region code for the creator ranking. Currently only `US` is supported because ranking data is available only for the United States.
label_id必填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`.
pageCurrent page number. Must be greater than or equal to 1. Defaults to 1 if omitted.
page_sizeNumber of results per page. Valid range: 1-100. Defaults to 20 if omitted.
ranking_type必填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_period必填Time period used for the ranking.
time_period_lookback必填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_id必填The ID of the TikTok One Creator Marketplace account. To obtain account IDs accessible by the current `Access-Token`, use /tto/oauth2/tcm/.