获取 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 从视频样本建立带采集时间的编辑选题池,用于趋势观察,但不将结果包装为 TikTok 通用排行榜。
- 编写热门流响应解析逻辑,分别读取 data.list.aweme_list 与 data.custom_cursor,并检查嵌套的 has_more 标记。
- 将每条视频的 create_time 与本地采集时间对比,区分旧内容重新受到关注和近期发布的视频。
- 先检查热门样本实际提供的创作者与互动信息,再挑选视频加入人工内容分析队列。
- 通过限定次数的请求测试 custom_cursor 续页,再设计定期保存热门视频快照的采集流程。
常见问题
获取热门视频流需要用户名或视频 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。目前仅观察了初始响应,完整分页流程和停止条件尚未验证。
这是全球热度排名,还是我账号的个性化推荐?
接口说明与实测均未证实这两种解释。请将其作为可用于研究的热门视频样本,而非官方通用排行榜、个性化推荐流或热门视频的完整记录。