登录开始免费试用
easyCoexistence 官方 API

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 或您自己的代码能够通过其工具发布内容、处理评论并读取数据洞察。

18000000

TikTok Accounts 的范围 ID,即位于 Accounts API 个人资料、帖子、评论和发布端点之上的一级权限。

user.account.type

账户个人资料数据中 is_business_account 和 has_advanced_access 所对应的范围。

comment.list

所有者必须授予并保持有效的范围,应用才能接收 comment.update Webhook 事件。

video.upload

令牌需具备的范围,用于将帖子以草稿形式上传,而非直接发布。

2 to 3 days

TikTok 审核开发者应用权限变更可能需要的工作日数。

TikTok 权限的两层分别是什么?

应用权限和令牌范围。应用权限在 My Apps 中依次进入应用、Scope of permission 进行选择,并由 TikTok 审核。权限分为三个级别,一级权限覆盖其下的所有端点。令牌范围则是账户所有者授权应用时批准的内容,随每个令牌以 scope 字段返回,是一个以逗号分隔的字符串。调用某个端点需要应用对该端点拥有相应权限,部分响应字段还需要令牌具备相应范围。

每个端点由哪项应用权限开放?

TikTok 的 API 参考为每个 Accounts API 端点列出了开放它的 TikTok Accounts 下的权限,若无则标注为无。其权限范围参考和 Webhook 指南则将同一组权限称为 Business User、Business Media、Business Comment 和 Business Content,因此您会同时看到两套名称:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

哪些令牌范围解锁哪些字段?

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,其名称与发布和评论管理端点相对应,不过其参考文档并未将任何字段与这两项关联。

Read the scopes an access token carries
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 等名称属于应用设置。
使用 EasyCoexistence 完成这些操作

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 监控

验证时间