登入開始免費試用
easyCoexistence 官方 API

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 提供的帳戶權杖。

Nov 2, 2026

TikTok for Developers 的權杖頁面已更新:用戶存取權杖有效 2 小時,刷新權杖有效 180 天,並於每次刷新時輪換。

Oct 16, 2026

自此,/business/get/ 的 is_business_account 只標示 Verified Business Accounts,has_advanced_access 則顯示是否具備 Advanced Access。

1,200

自 2026 年 8 月 7 日起,透過 API 的留言或回覆可容納的字元數,由 150 提升至 1,200。

Jun 18, 2026

TikTok 將留言內容加入 comment.update Webhook 事件的時間點。

Mar 20, 2026

規定開始生效:新的應用程式,或涉及 TikTok Accounts 的權限範圍擴充,須提交 Accounts API Access Application Form。

Dec 1, 2026

TikTok 棄用 API for Business 沙盒帳戶的日期,並建議改在正式環境中使用測試帳戶。

哪些 2026 年的 TikTok API 變更會導致功能失效?

TikTok 在 business-api.tiktok.com 的「What's New」與參考頁面,以及 developers.tiktok.com 的更新日誌與權杖頁面,記錄了以下 2026 年對管理帳戶及其內容的 API 所作的變更。由新至舊排列,即將生效的日期列於最前;大部分變更只是新增欄位,少數需要採取行動:

What breaksThe fix
Dec 1: sandbox accounts endTests against sandbox-ads.tiktok.comA test account in production
Nov 2: shorter developer tokensDaily refresh jobs and reused refresh tokensRefresh within expires_in and save each new refresh_token
Oct 16: is_business_accountChecks that read it as Advanced AccessRead has_advanced_access as well
Sep 25: hashtag post countsNothing; the order follows post countsRank with the new post_count
Aug 7: 1,200-character commentsNothing; 150 is no longer the capLift your own 150 limit
Jul 24: location tagsNothingOptional location_id with location_name
Jun 18: text in comment.updateNothingRead text from the event
May 21: Research API fieldsNothingfavorites_count and display_name
May 15: is_ad on postsNothingAn optional field to request
Mar 20: access formApp or scope requests without itSubmit the form first
Feb 26: Research API coverageComparisons with earlier pullsPull the baseline again
Feb 13: images in commentsCode that expects text on each commentHandle image_url
Jan 16: commercial musicNothingOptional 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 字元。
使用 EasyCoexistence 完成這項設定

每個連接每月 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 監察

驗證日期