通过 API 获取 TikTok 话题标签建议与热门话题标签
TikTok 的 API for Business 通过 GET /business/hashtag/suggestion/ 提供话题标签建议。该端点接受 35 种语言之一的关键词,返回 10 个话题标签,并附上每个标签的使用帖子数,使用的是 TikTok 账户自身的访问令牌。热门标签则来自 GET /discovery/trending_list/,它使用广告主令牌,按国家、行业和时间段对前 200 个标签进行排名。
easyCoexistence 通过 TikTok 的 API for Business 连接 TikTok 账户,因此您自己的代码可使用 get_social_credentials 提供的令牌获取话题标签建议,Claude、ChatGPT 或该代码再将其写入文案,并使用 publish_tiktok_post 发布或定时发布帖子,每个连接全天候 24/7 监控。
建议端点 language 参数可接受的语言,默认为 en;建议以关键词所用的语言返回。
一个已授权账户向单个 Accounts API 端点可发送的请求数上限,话题标签建议也计入在内。
热门标签未进入上一时间段前 200 时,rank_change 所取的值。
trending_history 的最长跨度,即 TikTok 为每个热门标签返回的每日排名和播放量。
/discovery/video_list/ 单次调用最多接受的 hashtag_id 数量,每个返回前 20 条热门视频。
哪些 TikTok 端点会返回话题标签?
TikTok 的 API for Business 上有五个端点会为自然发布的帖子返回话题标签,它们按所用令牌区分:一类使用 TikTok 账户自身的令牌,另一类使用来自已授权广告账户的广告主令牌。Marketing API 的工具中还有第六个端点,它改为为广告定向推荐话题标签:
如何调用建议端点?
使用 GET 请求,携带账户的 business_id、一个关键词,以及可选的 language 参数。language 参数共 35 个值,从默认值 en 起,经 es、pt-BR、ja-JP,直至 zh-Hant-TW;TikTok 会将建议匹配到关键词所用的语言。Access-Token 标头保存 TikTok 账户的访问令牌。TikTok 的 API 参考将该端点归在 TikTok Accounts 下的 Video Publish 权限之下,即视频发布所用的同一权限:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'keyword=summer' \
--data-urlencode 'language=en'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"suggestions": [
{ "name": "summer", "post_count": 65296335 },
{ "name": "summertime", "post_count": 4787632 },
{ "name": "summeroutfit", "post_count": 2245117 }
]
}
}每条建议包含什么?
包含名称、要使用的话题标签,以及 post_count,即使用该标签的帖子总数。TikTok 返回 10 条建议,与关键词完全匹配的排在最前,其余按帖子数排序。该列表不包含趋势数据:post_count 高,说明许多帖子已在使用该标签,这与 /discovery/trending_list/ 报告的上升排名是不同的信号。
每个端点需要哪些令牌和权限?
差异比路径看上去更大,开发前请先逐一核对:
- /business/hashtag/suggestion/:TikTok 账户的访问令牌和
business_id,应用需在 TikTok Accounts 下持有 Video Publish 权限。 - /discovery/
trending_list/、/discovery/detail/ 和 /discovery/video_list/:广告主访问令牌和advertiser_id(来自广告账户的授权),应用需在 Creative Management 下持有 Discovery 权限。 - /business/mention/
top_hashtag/list/:biz.brand.insights 范围,需要账户具有 Advanced Access 或 Verified Business Account。 - /tool/hashtag/recommend/:广告主令牌和
advertiser_id;TikTok 的参考文档未列出该端点的权限要求。
热门话题标签会返回什么?
GET /discovery/trending_list/ 接受 discovery_type,其唯一值为 HASHTAG,并可选 country_code、category_name 和 date_range;category_name 接受一级或二级行业,例如 FOOD_AND_BEVERAGE 或 COOKING。每个话题标签返回以下内容:
rank_position为该类别内的排名,以及相较上一时间段的rank_change:上升时为正值,下降时为负值,未进入前 200 时为 NEW。- 所选国家和时间段内的 views 与 posts,并附
views_global_lifetime与posts_global_lifetime。 top_country_list:该标签最热门的五个地区。trending_history:最多 30 天的rank_position_daily与views_daily;当该标签当天未进入热门,或当天播放量不足 1,000 时,返回 null。
如何深入查看一个热门话题标签?
使用同一广告主令牌再调用两个接口。/discovery/detail/ 接受列表返回的 hashtag_id,并使用与列表调用相同的 country_code 和 date_range,额外返回 hashtag_status(ONLINE 表示可用于创建广告),以及三个年龄段的观众年龄:18-24、25-34 和 35+;当状态为 OFFLINE 或预计受众少于 1,000 时,该字段留空。/discovery/video_list/ 最多接受 10 个 hashtag_id,并为每个标签返回前 20 条热门视频,按综合播放量、评论、点赞和分享计算的评分排序。
AI 助手如何用建议为帖子配文?
第一步在您自己的代码中完成。easyCoexistence 的工具不会获取建议,因此由您的代码使用 get_social_credentials 提供的令牌向 TikTok 请求;随后助手保留与帖子相符的标签,用 # 符号写入文案,并通过 publish_tiktok_post 立即发布或定时发布。TikTok 的发布参考文档指出,通过 API 发送的文案中,话题标签会以普通文本显示:
easyCoexistence 能访问什么,无法访问什么?
get_social_credentials 会向您自己的代码提供该账户的令牌和 business_id,用于 business/ 下的 TikTok 路径,因此话题标签建议可用。在 TikTok 已向该账户开放 Mentions API 的情况下,/business/mention/top_hashtag/list/ 也可用。Discovery 端点无法访问:它们使用广告主令牌和 advertiser_id,而非账户的令牌。其专用工具不返回话题标签。
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=recetas&language=es
Access-Token: <ACCESS_TOKEN>
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/tortilla.mp4",
"caption": "Tortilla en 10 minutos #recetas #recetasfaciles #cocina",
"scheduled_at": "2026-11-12T19:30:00+01:00"
}常见错误
- 把 name 值原样粘贴进文案。TikTok 示例返回的名称不带 # 符号,因此需在每个名称前加上 #。
- 按 view_count 排序建议。TikTok 已将该字段设为 2026 年 10 月 9 日前弃用,因此应改按 post_count 排序。
- 把 post_count 为 0 的建议当作正在使用的话题标签。当 TikTok 没有可建议的内容时,会以此方式返回关键词本身。
- 向 /discovery/detail/ 发送的 country_code 或 date_range 与列表调用不一致时,TikTok 会返回错误;列表之外的话题标签则返回空结果。
每个连接每月 US$ 9 至 US$ 0.75,连接越多,单价越低,前 3 天免费试用。
常见问题
通过 API 的 TikTok 文案最多能包含多少个话题标签?
TikTok 的发布参考文档没有对话题标签设置单独的上限:它们计入文案长度,视频帖子上限为 2,200 个 UTF-16 字符,图片帖子为 4,000 个,而 @ 提及的上限为 30 个。
能否获取其他语言的话题标签建议?
可以。将 language 与关键词一起传入,例如 pt-BR、es 或 ja-JP;建议会跟随关键词的语言,默认为英语(en)。
TikTok 账户没有广告账户,能否获取热门话题标签?
不能通过 /discovery/trending_list/ 获取,该端点需要广告主令牌。拥有 Advanced Access 或 Verified Business Account 的账户,可以读取提及该账户的帖子中使用最多的 20 个话题标签。
easyCoexistence 对一个 TikTok 账户收费多少?
每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费试用;每个 TikTok 账户算作一个连接。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间