[中文]

用途:

获取 TikTok Creative Center 热门视频榜单(Top Contents)，榜单固定收录 100 条热门视频

支持按内容分类筛选、按播放量/互动率/完播率排序，用于选题与创意参考

参数:

period_end_timestamp: 榜单周期结束时间戳(10位秒级)，必填

period_dimension 为 1 时需传周日 00:00 UTC 的时间戳，其余日期无数据

period_dimension 为 3 或 5 时可传任意已过去日期的时间戳

period_dimension: 榜单周期，默认3

1: 周榜

3: 日榜

5: 长周期榜(收录时间跨度更长的视频)

country_code: 国家/地区代码，默认US，取值见 /get_location_list

content_label_ids: 内容分类ID，多个用逗号分隔(如 11002,11015)，空为全部。可选值:

11001: 自然与动物

11002: 美妆护理

11003: 时尚

11004: 音乐与娱乐

11005: 游戏

11006: 教育与职场

11007: 运动户外

11008: 创意与才艺

11009: 家庭与情感

11010: 食品饮料

11011: Vlog与自拍

11012: 社会

11013: 生活与休闲

11014: 汽车与交通

11015: 科技与金融

order_by_metric: 排序指标，默认1

1: 按播放量排序

2: 按互动率排序

3: 按6秒完播率排序

organic_only: 是否仅看自然流量内容，默认False

page: 页码，默认1

limit: 每页数量，默认20，最大100

cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据

注意:

榜单总量固定为 100 条，页码超出范围会返回错误码 38014001

榜单仅覆盖部分国家/地区，未覆盖的地区会返回空的 entityInfos（属正常响应，非参数错误）。
截至 2026-08 实测可返回数据的有 US / TH / JP / ID / VN，覆盖范围以上游为准

查询榜单视频的详情时，建议向 /get_top_contents_item_detail 传入相同的 country_code

返回内容说明:

entityInfos: 视频列表，每项包含:

itemInfo: 视频基础信息 (itemID / title / createTime / coverURL / videoURL / authorID / creatorID)

itemMetrics: 视频指标 (videoViews 播放量 / engagementRate 互动率 / sixSecondsVTR 6秒完播率，及各自的 LifeTime 累计值)

itemAuthorInfo: 作者信息 (nickName / handlerName / avatarURI / bio)

itemAuthorMetrics: 作者指标 (followers 粉丝数)

contentTags: 内容分类标签 (contentLabelID / contentLabelName)

pagination: 分页信息 (page / limit / pageCount / totalCount / hasMore)

[English]

Purpose:

Get the Top Contents ranking from TikTok Creative Center, which always contains 100 trending videos

Filter by content category and sort by views / engagement rate / 6-second view rate for creative research

Parameters:

period_end_timestamp: Period end timestamp in seconds, required

For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data

For period_dimension 3 or 5, any past date works

period_dimension: Period, default 3

1: Weekly ranking

3: Daily ranking

5: Long-period ranking (covers videos over a longer time span)

country_code: Country code, default US, see /get_location_list for options

content_label_ids: Content label IDs, comma separated (e.g. 11002,11015), empty for all. Options:

11001: Nature & Animals

11002: Beauty & Care

11003: Fashion

11004: Music & Entertainment

11005: Games

11006: Education & Work

11007: Sports & Outdoor

11008: Creativity & Talent

11009: Family & Relationship

11010: Food & Beverage

11011: Vlog & Selfie

11012: Society

11013: Lifestyle & Leisure

11014: Vehicles & Transportation

11015: Technology & Finance

order_by_metric: Sorting metric, default 1

1: By video views

2: By engagement rate

3: By 6-second view-through rate

organic_only: Only include organic content, default False

page: Page number, default 1

limit: Items per page, default 20, max 100

cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data

Note:

The ranking always holds 100 items; an out-of-range page returns error code 38014001

The ranking covers only some countries/regions; uncovered ones return an empty entityInfos
(a normal response, not a parameter error). As of 2026-08, US / TH / JP / ID / VN
return data; the actual coverage follows upstream

Pass the same country_code to /get_top_contents_item_detail when querying a video from the ranking

Return Description:

entityInfos: Video list (itemInfo / itemMetrics / itemAuthorInfo / itemAuthorMetrics / contentTags)

pagination: Pagination info (page / limit / pageCount / totalCount / hasMore)

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/tiktok/ads/get_top_contents_list' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "period_end_timestamp": 0, "period_dimension": 3, "country_code": "US", "content_label_ids": "", "order_by_metric": 1, "organic_only": false, "page": 1, "limit": 20, "cookie": "string" }'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取热门视频榜单/Get top contents list

[中文]

用途:

参数:

注意:

返回内容说明:

[English]

Purpose:

Parameters:

Note:

Return Description:

Request

Responses

获取热门视频榜单/Get top contents list

[中文]#

用途:#

参数:#

注意:#

返回内容说明:#

[English]#

Purpose:#

Parameters:#

Note:#

Return Description:#

Request

Responses

[中文]

用途:

参数:

注意:

返回内容说明:

[English]

Purpose:

Parameters:

Note:

Return Description: