通过关键词搜索 TikTok 挑战和话题标签
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →在路径中填写必填字符串 keyword，搜索 TikTok 挑战，也就是话题标签。这是按关键词发现候选话题的接口，并非精确名称查询，也不会直接获取某个挑战的视频列表。可选查询参数 max_cursor 为字符串，用于尝试分页。首次搜索不传该参数，后续应根据搜索响应确认续页方式，不要直接套用视频列表的游标规则。接口说明仅明确结果属于挑战搜索，未提供响应字段结构，也没有该接口的实测响应或响应示例。因此，候选名称、挑战 ID、排序、数量、响应外层结构及续页字段均未得到验证。选择要监测的挑战前，请先检查实际匹配结果的相关性，并区分含义不明确的候选项。
API 功能
以关键词发现挑战话题 使用必填 keyword 搜索 TikTok 挑战或话题标签，无需预先掌握某个挑战的标识符。
人工筛选标签候选项 将搜索匹配项作为待核查的候选话题，而非保证精确匹配的结果或自动选定的活动标签。接口说明未约定排序规则。
话题搜索独立续页输入 检查实际搜索响应后，可为后续请求传入字符串 max_cursor。游标字段与分页终止方式尚未验证。
扩展细分话题词表 在返回内容支持的情况下，从候选结果整理人工审核的话题词表。接口说明不保证提供候选名称、ID 或热度字段。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/tiktok/search-challenges-by-keyword API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/search-challenges-by-keyword?key=<API_KEY>&keyword=<keyword>'
curl -X GET 'https://api.opendata-api.com/api/project/tiktok/search-challenges-by-keyword?key=<API_KEY>&keyword=<keyword>'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 将活动关键词扩展为候选 TikTok 话题标签，由编辑审核后再选择需要持续监测的具体话题。
- 依据实际搜索结果整理细分领域的话题词表，同时记录含义模糊或不相关的挑战候选项，留待复核。
- 先检查关键词搜索能否返回有用的挑战名称或 ID，再设计独立的挑战视频列表采集步骤。
- 在规划重复话题发现请求前，单独测试搜索接口的 max_cursor 分页，不沿用视频列表的分页假设。
常见问题
这个接口搜索话题标签，还是获取标签下的视频？
它通过关键词搜索挑战，也就是话题标签，属于话题发现接口，并非挑战视频列表。若需另外查询某个挑战的视频，请先检查搜索返回的候选项并选定具体挑战。
keyword 是挑战的精确名称，还是挑战 ID？
keyword 是路径中的必填搜索字符串。接口说明描述的是关键词搜索，而非按挑战 ID 查询，也不保证返回结果与输入文本完全一致。
挑战搜索能复用视频列表的游标吗？
不要假定不同接口的游标规则通用。此搜索接口接受可选字符串 max_cursor，但目前没有经过验证的搜索响应来确认其续页游标来源或格式。首次不传游标，再根据实际搜索响应确认后续用法。
响应是否已确认包含挑战 ID、名称和热度数量？
尚未确认。接口说明仅表明支持挑战搜索，未提供响应字段结构，也没有该接口的实测响应或响应示例。依赖候选 ID、名称、数量或排序前，请先检查实际返回的字段。