TikTok API for Business 範圍:各權限能解鎖什麼
TikTok 的 API for Business 分兩層授權。開發者應用程式在 TikTok Accounts 之下持有權限,例如 Video Publish 和 Manage Account Comment,這些權限開放相應端點。帳戶擁有者的授權則發出存取權杖的範圍,例如 user.insights 和 video.list,由它們決定回傳哪些欄位。/tt_user/token_info/get/ 會列出存取權杖所帶的範圍。
easyCoexistence 讓 TikTok 帳戶擁有者只需一次登入,即可授予應用程式持有的全部權限,之後 Claude、ChatGPT 或你自己的程式便能透過其工具發布、處理留言並讀取數據洞察;get_social_credentials 則會把同一存取權杖提供予你自己的程式,用於其他 Accounts API 端點。
TikTok Accounts 的範圍 ID,屬於第一級權限,高於 Accounts API 的個人資料、貼文、留言與發布端點。
帳戶個人資料中 is_business_account 與 has_advanced_access 背後的範圍。
擁有者必須授予並保持有效的範圍,應用程式才能接收 comment.update webhook 事件。
存取權杖要以草稿形式上傳貼文(而非直接發布)所需的範圍。
TikTok 審核開發者應用程式權限變更可能需要的工作天數。
TikTok 權限分為哪兩層?
應用程式權限與存取權杖範圍。應用程式權限在「My Apps」、應用程式、「Scope of permission」下選擇,並由 TikTok 審核;共分三級,第一級權限涵蓋其下的所有端點。權限範圍是帳戶擁有者授權應用程式時批准的內容,以逗號分隔的字串形式作為 scope 隨每個存取權杖回傳。呼叫需要該端點對應的應用程式權限,部分回應欄位還需要權杖上有相應範圍。
哪個應用程式權限開放各個端點?
TikTok 的 API 參考為每個 Accounts API 端點列出在 TikTok Accounts 下開放它的權限,或註明無需權限。其權限範圍參考與 webhook 指南把同一組權限稱為 Business User、Business Media、Business Comment 和 Business Content,因此兩套名稱都可能見到:
哪些存取權杖範圍解鎖哪些欄位?
TikTok 的 /business/get/ 與 /business/video/list/ 參考為每個回應欄位列出所需權限,另有兩項功能各自指定了獨立範圍:
- user.info.basic:
display_name與profile_image。 - user.info.username:username,2023 年 6 月前需要 user.info.basic。
- user.info.profile:
profile_deep_link、bio_description與is_verified。 - user.info.stats:
following_count、followers_count、total_likes與videos_count。 - user.account.type:
is_business_account與has_advanced_access。 - user.insights:每日帳戶指標,以及追蹤者的年齡、性別、國家及城市分佈。
- video.list:貼文欄位,例如
item_id、caption、share_url、likes、comments、shares、reach 與video_views。 - video.insights:觀看時長、完整觀看率、留存率、流量來源、觀眾分佈,以及貼文帶來的點擊次數。
- comment.list:comment.update webhook,TikTok 將其描述為讀取應用程式內容的留言及回覆。
- video.upload:以
upload_to_draft或is_draft將影片或相片貼文上傳為草稿。
如何查看權杖上的範圍?
呼叫 /tt_user/token_info/get/,傳入 app_id 與存取權杖,即會回傳該權杖的 scope 與帳戶的 creator_id。TikTok 的範例 scope 字串還包括 video.publish 與 comment.list.manage,其名稱與發布及留言管理端點相符,不過其參考文件並未將任何欄位與兩者對應。
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}easyCoexistence 的 TikTok 連接要求哪些權限?
其開發者應用程式持有的全部權限,都會在 TikTok 的同意頁面顯示。easyCoexistence 會把帳戶擁有者帶到 TikTok 入口網站為其應用程式生成的帳戶持有人授權網址,該網址已列明上述權限,僅另加一個 state 值。擁有者批准 TikTok 所顯示的內容,TikTok 回傳的 scope 字串會與該連接一併儲存。隨後 easyCoexistence 為該帳戶呼叫的端點如下:
- /business/get/:個人資料、每日指標與追蹤者分佈。
- /business/video/list/:貼文及其指標。
- /business/video/publish/、/business/photo/publish/ 及 /business/publish/status/:發布。
- /business/comment/list/、/business/comment/reply/create/、/business/comment/hide/ 及 /business/comment/delete/:留言。
- /business/webhook/update/,於應用程式層級,用於留言 webhook。
之後如何新增權限?
分兩個步驟,每層一步。應用程式層面:打開「My Apps」、應用程式、「Scope of permission」,編輯並填寫與新範圍相符的理由後提交;TikTok 審核可能需要兩至三個工作天,而自 2026 年 3 月 20 日起,包含 TikTok Accounts 的申請須先提交 Accounts API Access Application Form。權杖層面:擁有者需重新授權應用程式,因為存取權杖會保留發出時所批准的範圍。
缺少權限時會怎樣?
呼叫方面,TikTok 的錯誤代碼為 40001,即無權執行相關操作,其修正建議指向權限範圍參考。欄位方面,參考文件指出,只有擁有者授予相應範圍後才能使用,其修正方法是由擁有者以該範圍重新授權應用程式。提問前,請先用 /tt_user/token_info/get/ 檢查權杖的範圍。
常見錯誤
- 預期已連接的帳戶會自行獲得新的應用程式權限。它們的存取權杖會保留授權時批准的範圍,直至每位擁有者重新授權應用程式為止。
- 在未加入 user.account.type 的情況下請求 is_business_account。TikTok 僅向帶有該範圍的權杖開放此欄位及 has_advanced_access。
- 未有 comment.list 便等待 comment.update。TikTok 只會在擁有者帶有該範圍的授權仍有效時發送留言事件。
- 在權杖中搜尋應用程式權限名稱。範圍字串使用 video.list 等名稱,而 Get Account Media 等名稱屬於應用程式的設定。
每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供 3 天免費試用。
常見問題
TikTok API for Business 使用哪些範圍?
存取權杖範圍,例如 user.info.basic、user.info.stats、user.insights、video.list、video.insights、comment.list 和 video.upload,由帳戶擁有者在應用程式的 TikTok Accounts 權限之上授予。
TikTok 留言 webhook 需要哪些權限?
應用程式需要 TikTok Accounts 與 Business Comment,擁有者必須授予 comment.list。若該授權到期或被撤銷,事件便會停止。
新的 TikTok 範圍會套用到已發出的權杖嗎?
不會。存取權杖會保留發出時批准的範圍,因此帳戶擁有者須重新授權應用程式,才能加入新範圍。
TikTok 需要多久批准新權限?
TikTok 表示審核權限變更可能需要兩至三個工作天;加入 TikTok Accounts 的申請,則須先提交 Accounts API Access Application Form。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期