2026 年 TikTok API 變更:哪些已失效,以及如何處理
2026 年有四項 TikTok API 變更需要處理:TikTok for Developers 現已記載 2 小時的存取權杖,以及每次刷新即輪換、為期 180 天的刷新權杖(11 月 2 日);is_business_account 現僅指已驗證的商業帳戶(10 月 16 日);新的 Accounts API 應用程式需提交 TikTok 的存取申請表(3 月 20 日);API for Business 沙盒帳戶於 12 月 1 日結束。其餘大部分變更只是新增欄位,例如 Webhook 中的留言文字。
easyCoexistence 為 Claude、ChatGPT 或你自己的平台,持續保持其 TikTok 連接為最新狀態:權杖會提前續期,預設個人資料欄位包括 has_advanced_access 及 is_business_account,留言事件會連同文字一併轉發,而 API for Business 的其餘功能則可使用 get_social_credentials 提供的帳戶權杖。
TikTok for Developers 的權杖頁面已更新:用戶存取權杖有效 2 小時,刷新權杖有效 180 天,並於每次刷新時輪換。
自此,/business/get/ 的 is_business_account 只標示 Verified Business Accounts,has_advanced_access 則顯示是否具備 Advanced Access。
自 2026 年 8 月 7 日起,透過 API 的留言或回覆可容納的字元數,由 150 提升至 1,200。
TikTok 將留言內容加入 comment.update Webhook 事件的時間點。
規定開始生效:新的應用程式,或涉及 TikTok Accounts 的權限範圍擴充,須提交 Accounts API Access Application Form。
TikTok 棄用 API for Business 沙盒帳戶的日期,並建議改在正式環境中使用測試帳戶。
哪些 2026 年的 TikTok API 變更會導致功能失效?
TikTok 在 business-api.tiktok.com 的「What's New」與參考頁面,以及 developers.tiktok.com 的更新日誌與權杖頁面,記錄了以下 2026 年對管理帳戶及其內容的 API 所作的變更。由新至舊排列,即將生效的日期列於最前;大部分變更只是新增欄位,少數需要採取行動:
| What breaks | The fix | |
|---|---|---|
| Dec 1: sandbox accounts end | Tests against sandbox-ads.tiktok.com | A test account in production |
| Nov 2: shorter developer tokens | Daily refresh jobs and reused refresh tokens | Refresh within expires_in and save each new refresh_token |
| Oct 16: is_business_account | Checks that read it as Advanced Access | Read has_advanced_access as well |
| Sep 25: hashtag post counts | Nothing; the order follows post counts | Rank with the new post_count |
| Aug 7: 1,200-character comments | Nothing; 150 is no longer the cap | Lift your own 150 limit |
| Jul 24: location tags | Nothing | Optional location_id with location_name |
| Jun 18: text in comment.update | Nothing | Read text from the event |
| May 21: Research API fields | Nothing | favorites_count and display_name |
| May 15: is_ad on posts | Nothing | An optional field to request |
| Mar 20: access form | App or scope requests without it | Submit the form first |
| Feb 26: Research API coverage | Comparisons with earlier pulls | Pull the baseline again |
| Feb 13: images in comments | Code that expects text on each comment | Handle image_url |
| Jan 16: commercial music | Nothing | Optional music_sound_info |
2026 年 12 月 1 日結束的是什麼?
API for Business 沙盒帳戶。TikTok 的沙盒頁面表示,這些帳戶將於 2026 年 12 月 1 日前棄用,並建議建立正式環境中的自有測試帳戶。它們是附有模擬報告數據的廣告帳戶,位於 https://sandbox-ads.tiktok.com/open_api,因此 Accounts API 的測試需改用一個保留作測試用途的真實 TikTok 帳戶,並使用 TikTok 為 /business/video/publish/ 提供的測試影片網址。
TikTok for Developers 的權杖於 2026 年 11 月 2 日有何變更?
其權杖頁面現時列明:用戶存取權杖由發出起計有效 2 小時,刷新權杖由首次發出起計有效 180 天,並會輪換刷新權杖。成功刷新後會回傳新的 refresh_token,同時立即使所發送的那個失效。會受影響的是每天刷新一次,或重用已儲存刷新權杖的排程任務。修復方法是在 expires_in 所示的時限內刷新,在使用前先儲存每個新的 refresh_token,並規劃在 180 天內重新授權。API for Business 的驗證指南仍然為 TikTok 帳戶權杖提供一天與一年的有效期。
is_business_account 於 2026 年 10 月 16 日有何變更?
TikTok 在 /business/get/ 加入了 has_advanced_access,作為 fields 的值及一個回應欄位;同時將 is_business_account 收窄為只表示已驗證的商業帳戶。把 is_business_account 當作 Advanced Access 標記的程式碼,現在對於具備 Advanced Access 但未經驗證的帳戶會得到 false。修復方法是同時請求這兩個欄位(需要 user.account.type 權限範圍),並將 Advanced Access 所解鎖的功能設定為:只要其中一個為 true 即可使用。
2026 年 9 月 25 日的主題標籤建議有何變更?
/business/hashtag/suggestion/ 新增了 post_count,即使用過每個建議主題標籤的貼文數量;其 10 個建議現按完全符合後的貼文數量排序,TikTok 表示此排序與應用程式內的推薦一致。並無任何項目被移除,因此現有程式碼仍可運作;但依舊有排序邏輯所建立的排名會改變,而 post_count 正是用來排序的欄位。
留言文字於 2026 年 8 月 7 日有何變更?
TikTok 將 /business/comment/create/ 與 /business/comment/reply/create/ 的文字上限,由 150 字元提高至 1,200 字元,Mentions API 中的留言提及回覆亦然。沒有任何功能失效。若程式碼為配合 TikTok 而把回覆截至 150 字元,現可讓回覆更長;但須留意 TikTok 的提醒:短時間內發出大量內容相近的留言,可能會被標記為垃圾訊息。
2026 年哪些新增功能無需修改程式碼?
三項發布與貼文的新增功能屬於可選欄位,現有呼叫可以忽略:
- 7 月 24 日:/business/publish/location/ 會列出帳戶的位置標籤,發布端點接受
location_id,且location_name須與之一併提供,屬必填。 - 5 月 15 日:/business/video/list/ 的
is_ad,作為可請求的欄位及回應值,顯示貼文是否正以廣告形式推廣。 - 1 月 16 日:影片與相片發布端點的
music_sound_info可附加 Commercial Music Library 的曲目。
留言 Webhook 於 2026 年 6 月 18 日有何變更?
comment.update 新增了 text,即留言或回覆的內容,與 comment_id、video_id、comment_action 及留言者的 unique_identifier 並列。接收端可直接從事件讀取文字,而無需呼叫 /business/comment/list/;留言者的顯示名稱及用戶名仍需從該清單取得,而 content 中的 ID 仍以 JSON 數字表示,其值已超出 double 可表示的範圍。
今年 Research API 有何變更?
共有兩項變更,均見於 TikTok for Developers 的 Research Tools。2 月 26 日,TikTok 更改了數據管道,以涵蓋所有公開影片內容,包括不符合 For You 資訊流資格的影片,因此與較早的抓取結果相比,計數可能有所變動。5 月 21 日,Query Videos,以及用戶喜歡、置頂及轉發影片的查詢,開始回傳 favorites_count;Query Video Comments 則開始為留言與回覆回傳 display_name。
2026 年 3 月 20 日的應用程式審核有何變更?
自當日 GMT 00:00 起,開發者提交新的開發者應用程式,或申請包含 TikTok Accounts 權限的權限範圍擴充前,必須先完成 TikTok 的 Accounts API Access Application Form。會失效的是未附上該表格的提交。修復方法是先清楚、準確地填寫表格,再提交應用程式或權限範圍變更;TikTok 的審核可能需要 2 至 3 個工作天才有回覆。
留言於 2026 年 2 月 13 日有何變更?
留言現可附帶圖片。/business/comment/image/upload/ 接收圖片並回傳 image_uri,/business/comment/create/ 與 /business/comment/reply/create/ 可連同 image_width 及 image_height 一併接受該 image_uri,而留言清單會為圖片留言回傳 image_url。回覆現可二選一:文字或圖片。因此假設每則留言都有文字的程式碼,也應處理 image_url。
哪些項目已標示為將移除,但未註明日期?
留言回應中的 user_id。TikTok 對 /business/comment/list/ 與 /business/comment/reply/create/ 的參考資料將其標示為 To-be-deprecated,表示將於下一個 API 版本棄用,並建議改用 unique_identifier,該值在各 API 之間保持不變。v1.3 本身並無終止日期:TikTok 的版本時間表將其列為可用至 TBD。
easyCoexistence 如何處理這些變更?
其 TikTok 連接使用 API for Business 權杖,保留一天與一年的有效期,並由 easyCoexistence 自行續期,因此 11 月 2 日的變更不會影響它。其餘逐項如下:
get_social_insights中若 metrics 清單為空,會向 TikTok 請求兩個標記:is_business_account與has_advanced_access。reply_to_comment會按你所寫的原文發送文字,因此 TikTok 的 1,200 字元上限適用;而自動化功能則將 TikTok 回覆維持在 150 字元,留言規則則上限為 500。- 轉發的 comment.update 事件會攜帶 TikTok 所發送的文字,而 ID 則已轉為字串。
is_ad及貼文清單的其他欄位,可由你自己的程式碼於 business/video/list/ 存取,並使用get_social_credentials提供的權杖。- 測試無需沙盒:你自己擁有的帳戶,只需在 TikTok 登入即可連接。
常見錯誤
- 硬編碼權杖有效期。TikTok for Developers 已於 2026 年 11 月 2 日更改其記載的有效期,但其刷新範例仍顯示 86400,因此應依每次回應中的 expires_in 安排刷新。
- 保留第一個刷新權杖。在 TikTok for Developers 中,每次刷新都會回傳新的 refresh_token,並使你所發送的那個失效,因此每次都要儲存最新的一個。
- 僅以 is_business_account 控制 Advanced Access 功能的存取。自 2026 年 10 月 16 日起,對於具備 Advanced Access 但未經驗證的帳戶,其值為 false。
- 為配合 TikTok 而保留 150 字元上限。自 2026 年 8 月 7 日起,留言端點最多可接受 1,200 字元。
每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,首 3 天免費。
常見問題
API for Business 在 2026 年有更改權杖有效期嗎?
沒有。其驗證指南仍然為 TikTok 帳戶存取權杖提供一天的有效期,為刷新權杖提供一年的有效期;2 小時與 180 天的有效期是 TikTok for Developers 本身的規定。
TikTok 在哪裡公布 API 變更?
API for Business 的變更見於 business-api.tiktok.com 的「What's New」;TikTok for Developers 的變更則見於 developers.tiktok.com 的更新日誌。參考頁面亦附有註明日期的說明,例如 3 月 20 日的表格。
TikTok 在 2026 年有更改 Accounts API 的速率限制嗎?
其 2026 年的「What's New」條目並未記錄任何相關更改:每個帳戶在各端點每分鐘 40 次呼叫,以及每個應用程式每分鐘 600 或 1,000 次。
對於回覆 TikTok 留言的 AI 代理而言,2026 年哪項變更最為重要?
有兩項:自 8 月 7 日起,回覆最多可達 1,200 字元;自 6 月 18 日起,comment.update 已攜帶留言文字,因此代理可直接從事件讀取。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期