按话题 ID 获取 TikTok 视频列表
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →请求 TikTok 话题(标签)关联的视频列表。必填路径参数 challenge_id 应以字符串传入,文档默认值为 229207。可选查询参数 max_cursor 也为字符串,但没有已说明的默认值或示例。首次请求应省略该参数,不要自行假定起始游标。目前没有可核验的实际响应,也未提供响应示例或字段结构说明,因此视频条目字段、列表所在字段、下一页游标字段及列表结束标记均未确认。继续翻页前,请先核实实际响应中的游标如何对应 max_cursor。返回的视频应作为有限样本使用,不代表完整历史导出、全部话题参与者名单,也不保证固定排序。
API 功能
获取指定话题的关联视频 按一个已知 challenge_id 请求关联视频,而不只是查询标签本身的资料。
按需传入分页游标 确认实际响应与 max_cursor 的对应关系后,再在后续请求中传入受支持的字符串游标。
首次采样无需指定游标 只提供必填话题 ID 即可发起首次请求;本接口没有已说明的 max_cursor 默认值或示例值。
分批留存活动视频样本 为选定话题收集有限的视频列表响应,并保留请求上下文供后续内容审核使用,但不承诺覆盖全部视频。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/tiktok/challenge-feed-by-id API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-feed-by-id?key=<API_KEY>&challenge_id=229207'
curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-feed-by-id?key=<API_KEY>&challenge_id=229207'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 按活动 challenge_id 收集一批关联视频样本,供人工评审创意内容。
- 核实视频标识所在字段后,保存 challenge_id、本地获取时间及返回的视频标识,以关联多次复查中的列表样本。
- 确认实际响应与分页参数的映射后,将已提交的 max_cursor 保存为检查点,便于恢复话题内容审核。
- 比较不同复查日期新采集的话题视频样本,挑选有代表性的帖子,但不将样本视为完整参与总量。
常见问题
请求话题视频列表需要哪些必填参数?
只有 challenge_id 为必填项,它是字符串类型的路径参数,文档默认值为 229207。max_cursor 是可选的字符串查询参数。
首次请求的 max_cursor 应该填什么?
没有已说明的起始值。首次请求请省略 max_cursor,检查响应并确认返回游标与请求参数的对应关系后,再尝试获取下一页。
视频列表和下一页游标分别在哪个字段中?
目前没有实际响应或响应示例可供核验,因此这些字段名尚未确认。实现分页前,请先核实返回的视频列表、条目标识、游标以及分页结束标记。
返回列表能保证包含使用该标签的每一个视频吗?
不能。文档未承诺完整历史覆盖、固定排序或完整参与者名单。请将返回内容作为所请求话题下的有限视频样本。