通过用户名获取 TikTok 创作者作品列表
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过必填的字符串路径参数 username 获取 TikTok 创作者的作品列表，例如 khaby.lame。可选查询参数 max_cursor 和 min_cursor 均为字符串；首次请求请同时省略。已观察到的成功请求返回 HTTP 200、status=ok，data.aweme_list 中包含 10 条视频，并返回 has_more=1 以及 min_cursor、max_cursor 分页字段。该样本的视频记录包含视频标识、作者信息、创建时间戳、互动统计和可播放的媒体链接。样本中首条 aweme_id 为 7697307919943060767，作者是 khaby.lame，创建日期为 2026-10-16，采集时返回的播放量为 3363153。这些只是样本观察值，并非固定返回内容，也不保证每页都含有 10 条记录。已有研究也指出作品描述可用于内容审阅，但现有证据尚未确定对应的准确响应字段名；也没有独立响应示例可用于确认其他嵌套字段名。可将返回的游标字段暂存为后续翻页的候选位置，并保留其字符串值，但正确的游标组合、翻页方向及连续多页行为尚未验证。采集时请按视频 ID 去重，并在游标位置重复时停止。此接口没有 count 参数。不要根据已观察到的一页结果推断其按时间排序、覆盖完整发帖历史、提供创作者私有分析数据或保证媒体链接永久可用。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/tiktok/user-media-feed-by-username API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/user-media-feed-by-username?key=<API_KEY>&username=khaby.lame'
查询结果
使用场景
- 利用作品列表中的视频标识和可用媒体链接，为已知创作者建立近期内容审阅队列，并在有作品描述时补充展示。
- 从作品列表中选择视频，再通过独立的视频详情查询补充资料，使用 aweme_id 关联记录而非匹配文案。
- 将采集时点的互动数据快照与视频 ID 一起保存，供编辑比较内容表现，但不将其展示为创作者私有分析数据。
- 试做限定页数的创作者作品采集流程，验证返回游标、去除重复视频 ID，并在游标位置重复时终止。
常见问题
请求作品列表需要创作者的数字用户 ID 吗？
不需要。此路由要求传入 username 字符串，例如 khaby.lame。它按用户名查询作品，与独立的按用户 ID 查询路由不同。
已观察到的成功作品列表请求返回了什么？
已有 HTTP 200 观察记录返回 status=ok，data.aweme_list 中有 10 条记录，并包含 has_more=1 和 min_cursor、max_cursor 字段。视频记录含有视频标识、作者信息、创建时间戳、互动统计及可播放链接。除已报告的 aweme_id 外，这些内容对应的准确嵌套字段名尚未在现有证据中确定。
应该如何使用 max_cursor 和 min_cursor？
二者均为可选的字符串查询参数。首次请求请省略，随后将返回的游标值保留为后续翻页的候选位置。游标方向、应传一个还是同时传两个，以及能否成功连续翻页均尚未验证。请在限定范围的测试中确认这些细节；若游标位置重复，或一页结果全部是重复记录，请停止采集。
能设置每页条数，或默认按最新作品优先排序吗？
此接口未定义 count 参数。某次请求的一页结果中观察到 10 条视频，但这不能证明每页条数固定、结果按时间排序或完整覆盖发帖历史。
作品统计和播放链接适合长期留存吗？
请以视频 ID 和采集时间作为留存记录的基础。互动计数反映采集时点的快照，不是历史或私有分析数据。已观察到可播放链接，但不能将其视为永久媒体资源；请单独处理链接不可用的情况。