按 TikTok 标签名称查询话题资料与 ID
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过必填的字符串路径参数 challenge_name 查询话题（标签）信息。虽然操作标识中含有 keyword，但本接口是按名称查询，不是返回多个匹配标签的自由文本搜索。文档示例和默认值均为 fyp。已有一次针对 fyp 的成功实测：HTTP 状态码为 200，响应包含 status=ok 和 data.status_code=0。观测到的 data.ch_info 对象包含返回的标签名称 cha_name、话题标识 cid、用量相关计数 user_count 和浏览计数 view_count。该次响应中 cha_name=fyp、cid=229207，user_count 和 view_count 均为非零值，另有分享信息，但其嵌套字段尚未明确。这些字段只在一次实测中得到观察，不保证所有名称都返回相同结构；目前也没有单独提供响应示例或字段结构说明。如需衔接按话题 ID 查询资料或获取视频列表的流程，请同时保存提交的名称与返回的 cid。计数应记录为带获取时间的报告值快照，不能解释为独立人数、去重触达量、增长率或历史趋势。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/tiktok/challenge-data-by-keyword API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-data-by-keyword?key=<API_KEY>&challenge_name=fyp'
查询结果
使用场景
- 将分析人员提供的已知标签名称解析为返回的 cid，再构建单独的话题 ID 查询流程。
- 在实际响应具备相应字段时，使用 cha_name、cid、user_count 和 view_count 制作带获取时间的话题资料卡。
- 同时记录提交的 challenge_name 和返回的 cha_name，让活动标签引用可核查、可追溯。
- 将实测中出现的 status 和 data.status_code 与名称查询结果一并保存，便于采集程序区分报告成功与预期元数据缺失的情况。
常见问题
challenge_name 是标签名称，还是通用关键词搜索？
该参数用于填写话题或标签名称，文档示例为 fyp。本接口没有说明支持多结果关键词搜索、模糊匹配或任意文本短语。
如何通过标签名称获取话题 ID？
在已有的一次 fyp 成功实测中，data.ch_info.cid 为 229207，data.ch_info.cha_name 为 fyp。请在实际响应中核验这些字段，保存返回的标识，再用于单独的按话题 ID 查询或话题视频列表请求。
实际观测到了哪些元数据字段？
fyp 实测响应包含 status=ok、data.status_code=0，以及 data.ch_info 下的 cha_name、cid、user_count 和 view_count，另有嵌套字段尚未明确的分享信息。一次观测不能保证所有查询都返回同样的字段，目前也未提供单独的响应示例。
user_count 和 view_count 能表示独立触达人数或增长情况吗？
现有证据尚未明确这些字段的具体统计口径。请将其视为某一获取时刻报告的计数，而不是独立人数、去重触达量或增长率。单次响应也不构成历史时间序列。