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 或您自己的代码能够通过其工具发布内容、处理评论并读取数据洞察。
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 的示例范围字符串中还包含 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 门户为其应用生成的 TikTok 账户持有者授权 URL,该 URL 已列明这些权限,easyCoexistence 只额外添加一个自有的 state 值。所有者批准 TikTok 所显示的内容,TikTok 返回的范围字符串会与连接一同保存。随后 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/ 检查令牌的范围,再发出请求。
常见错误
- 期望已连接账户自动获得新的应用权限。它们的令牌会保留授权时批准的范围,直到每位所有者重新授权该应用为止。
- 请求 is_business_account 却没有 user.account.type。TikTok 仅向携带该范围的令牌开放此字段和 has_advanced_access。
- 等待 comment.update 却没有 comment.list。只有在所有者带有该范围的授权仍然有效时,TikTok 才会发送评论事件。
- 在令牌中搜索应用权限名称。范围字符串使用 video.list 等名称,而 Get Account Media 等名称属于应用设置。
get_social_credentials 也会把同一令牌提供给您自己的代码,用于访问 Accounts API 的其他端点。每个连接每月 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 监控
验证时间