按话题名称获取 TikTok 视频列表
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过必填路径参数 challenge_name 获取某个 TikTok 挑战话题（即标签）对应的视频列表，文档示例为 fyp。此接口按话题名称查询，并非通用的视频关键词搜索。可选查询参数 max_cursor 用于分页，首次请求应省略；游标的具体含义及续页时应使用的响应字段尚未验证。接口文档说明返回话题视频列表，但目前没有可用的成功响应样例或字段结构，因此视频字段、响应外层结构和分页输出均未确认。请将结果视为该话题的视频样本，而非使用该标签的全部视频导出。
API 功能
直接以话题名称查询 填写必需的 challenge_name 字符串即可发起查询，例如 fyp，无需先取得数字形式的话题 ID。
聚焦单个标签的视频内容 获取指定话题对应的视频列表，而不是对所有视频进行宽泛的关键词检索。
可选话题分页游标 请求支持 max_cursor 分页参数，首次查询请省略；续页值的格式及其对应的响应字段尚未验证。
明确话题样本的使用边界 结果用于观察话题内容。目前尚未证实能覆盖全部视频，也未确认固定的视频响应字段。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/tiktok/challenge-feed-by-keyword API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-feed-by-keyword?key=<API_KEY>&challenge_name=fyp'
curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-feed-by-keyword?key=<API_KEY>&challenge_name=fyp'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 让编辑直接查看已知话题的视频列表，无需事先维护独立的话题 ID 对照表。
- 为固定的活动话题名称定期保存带采集日期的样本，并明确标注为话题观察记录，而非活动全部投稿。
- 建立话题内容审核队列，将每次查询的话题名称与返回内容关联，便于编辑后续对比。
- 制作按名称输入的标签探索界面原型，并在界面中提示话题内容可能并不完整。
常见问题
challenge_name 会执行通用关键词搜索吗？
不会。它用于指定要获取视频列表的挑战话题或标签，文档示例为 fyp。此接口并未被描述为面向所有视频的文本搜索接口。
需要提供数字形式的话题 ID 吗？
不需要。此接口要求在路径中传入 challenge_name 字符串，而不是数字话题 ID。
max_cursor 应该填写什么？
首次请求请省略这个可选字符串参数。它用于分页，但具体值的格式及续页所需的响应字段尚未验证，请勿将其直接当作页码。
这个话题列表中有哪些已验证的视频字段？
目前没有可用的成功响应样例或响应字段结构。文档说明结果为话题视频列表，但具体视频字段、响应外层字段名和分页输出均尚未验证。
能获取使用该标签的所有视频吗？
尚未证实能够完整覆盖。请将返回内容作为话题视频样本使用，不要将其描述为该标签下全部视频的完整导出。