登入開始免費試用
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_ids 數量上限,每個標籤返回前 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_ids,每個返回前 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 路徑,因此主題標籤建議可以運作;/business/mention/top_hashtag/list/ 亦然,因為 TikTok 已向該帳戶開放 Mentions API。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 無建議可提供時,便會以這種方式返回關鍵字本身。
  • 以不同於列表呼叫的 country_code 或 date_range 查詢 /discovery/detail/。TikTok 會返回錯誤,而列表以外的主題標籤則會得到空結果。
使用 EasyCoexistence 完成這項設定

每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,前 3 天免費試用。

常見問題

透過 API 發布的 TikTok 文案,最多可有多少個主題標籤?

TikTok 的發布參考文件並未對主題標籤另設上限:它們計入文案字數,影片貼文上限為 2,200 個 UTF-16 字元,相片貼文為 4,000 個,而 @ 提及上限為 30 個。

能否取得其他語言的主題標籤建議?

可以。將 language 與關鍵字一併傳入,例如 pt-BR、es 或 ja-JP;建議會跟隨關鍵字的語言,預設為英文。

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 監察

驗證日期