登录开始免费试用
easyCoexistence 官方 API

通过 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 监控。

35

建议端点 language 参数可接受的语言,默认为 en;建议以关键词所用的语言返回。

40 a minute

一个已授权账户向单个 Accounts API 端点可发送的请求数上限,话题标签建议也计入在内。

NEW

热门标签未进入上一时间段前 200 时,rank_change 所取的值。

30 days

trending_history 的最长跨度,即 TikTok 为每个热门标签返回的每日排名和播放量。

10

/discovery/video_list/ 单次调用最多接受的 hashtag_id 数量,每个返回前 20 条热门视频。

哪些 TikTok 端点会返回话题标签?

TikTok 的 API for Business 上有五个端点会为自然发布的帖子返回话题标签,它们按所用令牌区分:一类使用 TikTok 账户自身的令牌,另一类使用来自已授权广告账户的广告主令牌。Marketing API 的工具中还有第六个端点,它改为为广告定向推荐话题标签:

/business/hashtag/suggestion/10 hashtags for a keyword, for captions; account token
/discovery/trending_list/Top 200 popular hashtags by country, category and period; advertiser token
/discovery/detail/One popular hashtag's numbers, ad status and viewer ages; advertiser token
/discovery/video_list/Top 20 trending videos for up to 10 popular hashtags; advertiser token
/business/mention/top_hashtag/list/The 20 hashtags used most in posts that @mention the business; account token
/tool/hashtag/recommend/Hashtags to target ads at, under an advertiser_id; not for captions

如何调用建议端点?

使用 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 权限之下,即视频发布所用的同一权限:

Hashtag suggestions for a keyword, after TikTok's own example
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 发送的文案中,话题标签会以普通文本显示:

1Pick keywordsFrom the post's topic, in the caption's language
2Ask TikTokbusiness/hashtag/suggestion/, from your own code
3ChooseThe names that fit, weighed by post_count
4Write#name in the caption, within 2,200 UTF-16 units on a video
5Publishpublish_tiktok_post, now or with scheduled_at

easyCoexistence 能访问什么,无法访问什么?

get_social_credentials 会向您自己的代码提供该账户的令牌和 business_id,用于 business/ 下的 TikTok 路径,因此话题标签建议可用。在 TikTok 已向该账户开放 Mentions API 的情况下,/business/mention/top_hashtag/list/ 也可用。Discovery 端点无法访问:它们使用广告主令牌和 advertiser_id,而非账户的令牌。其专用工具不返回话题标签。

Suggestions, then a scheduled post with them in the caption
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 会返回错误;列表之外的话题标签则返回空结果。
使用 EasyCoexistence 完成这些操作

每个连接每月 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 监控

验证时间