透過 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_ids 數量上限,每個標籤返回前 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_ids,每個返回前 20 段熱門影片,按結合觀看、留言、讚好及分享的評分排序。
AI 助理如何利用建議為貼文撰寫文案?
由你自己的程式碼先走第一步。easyCoexistence 的工具不會取得建議,因此你的程式碼會憑 get_social_credentials 提供的權杖向 TikTok 索取;助理再保留與貼文相符者,以 # 符號寫入文案,並透過 publish_tiktok_post 發布,立即或於指定時間。TikTok 的發布參考文件指出,透過 API 傳送的文案中,主題標籤在應用程式內會以純文字顯示:
easyCoexistence 能觸及什麼,又超出哪些範圍?
get_social_credentials 會為您自己的程式碼提供帳戶的權杖與 business_id,用於 business/ 下的 TikTok 路徑,因此主題標籤建議可以運作;/business/mention/top_hashtag/list/ 亦然,因為 TikTok 已向該帳戶開放 Mentions API。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 無建議可提供時,便會以這種方式返回關鍵字本身。
- 以不同於列表呼叫的 country_code 或 date_range 查詢 /discovery/detail/。TikTok 會返回錯誤,而列表以外的主題標籤則會得到空結果。
每個連接每月由 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 監察
驗證日期