按 ID 查询 TikTok 话题详情
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过必填的路径参数 challenge_id 查询 TikTok 话题（标签）信息。话题 ID 必须按字符串传入，文档默认值为 229207。本接口面向已知话题 ID，不接受话题名称，也不用于获取该话题的视频列表。目前没有可核验的实际响应，也未提供响应示例或字段结构说明，因此返回字段及可用统计指标尚未确认。请勿直接套用按话题名称查询接口中的 data.ch_info 字段；应先检查实际响应，再确定元数据字段映射或计数计算方式。本次查询不能用于确认历史趋势，也不代表已收集该话题下的全部视频。
API 功能
指定话题 ID 查询 传入一个已有的 challenge_id 即可查询对应话题信息，无需提供标签显示名称，也无需进行关键词搜索。
以文本保留话题标识 将必填话题 ID 始终作为字符串处理；即使是文档默认值 229207 这样的纯数字内容，也应保留其文本形式。
聚焦话题资料而非视频列表 本接口用于查询话题信息；如需采集相关视频样本，应另行选择按话题 ID 获取视频列表的接口。
复查归档话题资料 按新的复查时间重新查询活动档案中已保存的话题 ID，记录当次返回的信息，但不预设响应字段结构。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/tiktok/challenge-data-by-id API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-data-by-id?key=<API_KEY>&challenge_id=229207'
curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-data-by-id?key=<API_KEY>&challenge_id=229207'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 在每次活动复盘时重新查询已保存的 challenge_id，留存当次返回的话题元数据。
- 为话题档案附上请求时使用的 challenge_id 和本地记录的获取时间，便于追溯各次资料快照。
- 先复查候选标签 ID，再决定对哪些话题单独请求视频列表，供编辑选材使用。
- 在数据接入流程中核验 ID 查询接口的实际响应结构，避免照搬按话题名称查询时的字段映射。
常见问题
challenge_id 应该填写什么？
填写已有的 TikTok 话题标识，并按字符串传入。文档默认值为 229207。即使该值仅包含数字，也应作为文本处理。
可以用话题名称代替 ID 吗？
本接口要求传入话题 ID，而不是话题名称。如果你手上只有 fyp 这类名称，应使用单独的按话题名称查询接口。
按 ID 查询时，哪些响应字段已经确认？
本接口尚无已确认的响应字段：目前没有可核验的实际响应，也未提供响应示例或字段结构说明。依赖名称、标识、计数或嵌套对象之前，请先核验实际返回内容。按名称查询接口的响应不能作为本接口字段结构的依据。
这个接口能采集话题视频或查询历史统计吗？
本接口的用途是查询话题信息。若要请求相关视频，请使用单独的话题视频列表接口；这两个接口都不应被视为完整历史数据导出或历史趋势查询的保证。