获取 TikTok 热门视频样本

查看 TikTok 用户、视频与音乐数据 API 的全部接口 →

获取 TikTok 热门视频流,接口说明将其描述为主屏幕轮播视频流。请求无需填写用户名、视频 ID 或关键词,唯一记录的输入是可选字符串查询参数 custom_cursor;首次获取样本时不传即可。一次不带参数的实测请求返回 HTTP 200,响应中观察到 status=ok、data.custom_cursor,以及嵌套的 data.list 对象。data.list 包含 status_code=0、has_more=1 和有 10 条视频的 aweme_list 数组。该样本还包含创作者信息与互动数量,但此处尚未确认各项字段名称及其完整性。请注意层级:视频和 has_more 位于 data.list 内,custom_cursor 则直接位于 data 下。可将返回的游标作为续页输入的候选值,并检查后续响应;此次实测未验证完整分页流程。样本视频的创建日期介于 2026-08-30 至 2026-10-21,包含实测当天,因此应将每条视频的 create_time 与本地采集时间对比,不要将所有条目都视为新发布内容。这些观察仅对应一次响应,不代表固定每页条数、通用热度排名、账号个性化推荐流或保证完整的导出结果,也没有其他响应示例提供更多已验证字段。

API 功能

无需标识符获取热门样本 无需创作者、声音或挑战 ID 即可发起初始请求。无参数实测返回了 10 条视频,但这只是一次观察,不代表固定每页条数。
已观察到的视频列表嵌套结构 视频条目位于 data.list.aweme_list,续页标记位于 data.list.has_more,游标位于 data.custom_cursor;三者并不处于同一对象层级。
实测样本中的创作者与互动信息 观察到的热门视频样本包含创作者资料与互动数量。各项元数据的具体键名,以及是否每条视频都提供这些信息,尚未验证。
结合创建时间辨别内容新旧 当前热门样本可能包含较早发布的视频。实测创建日期跨越 2026-08-30 至 2026-10-21,因此不应将热门响应直接标注为今日新发布内容。
利用返回游标测试热门流续页 测试后续页面时,可将已观察到的 data.custom_cursor 值填入可选查询参数 custom_cursor。实测出现 has_more=1,但完整遍历及终止规则尚未验证。

在线 API 演示

GET /api/project/tiktok/trending-media-feed

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/tiktok/trending-media-feed?key=<API_KEY>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

获取热门视频流需要用户名或视频 ID 吗?

不需要。接口没有必填输入,唯一参数是可选字符串 custom_cursor。首次实测请求未携带任何参数,并成功返回响应。

实测响应中的视频和续页信息分别在哪里?

实测返回 status=ok。视频条目位于 data.list.aweme_list,status_code=0 和 has_more=1 位于 data.list 内。游标则位于 data.custom_cursor,不在 data.list 内。这些是已观察到的路径,不保证未来每次响应都包含相同内容。

每次都会返回 10 条今天发布的视频吗?

尚未确认固定每页条数,也不保证视频均在当天发布。实测响应包含 10 条视频,创建日期介于 2026-08-30 至 2026-10-21。请将 create_time 与采集时间对比,判断内容的新旧。

如何测试热门视频流的分页?

首次不传 custom_cursor,再将响应中的 data.custom_cursor 作为下一次请求的候选游标,并检查 data.list.has_more。目前仅观察了初始响应,完整分页流程和停止条件尚未验证。

这是全球热度排名,还是我账号的个性化推荐?

接口说明与实测均未证实这两种解释。请将其作为可用于研究的热门视频样本,而非官方通用排行榜、个性化推荐流或热门视频的完整记录。

相关接口

相关指南

查看订阅方案 →