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

2026 年 TikTok API 变更:哪些已失效,以及如何处理

2026 年有四项 TikTok API 变更需要采取行动:TikTok for Developers 现在记载 2 小时的访问令牌,以及每次刷新即轮换的 180 天刷新令牌(11 月 2 日);is_business_account 现在仅指 Verified 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 Account,has_advanced_access 则显示 Advanced Access。

1,200

自 2026 年 8 月 7 日起,通过 API 发送的评论或回复最多可包含 1,200 个字符,此前为 150 个。

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 上的 Changelog 和令牌页面,记录了以下 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/ 提供的测试视频 URL。

2026 年 11 月 2 日,TikTok for Developers 的令牌发生了什么变化?

其令牌页面现在规定,用户访问令牌自签发起 2 小时有效,刷新令牌自首次签发起 180 天有效,并且刷新令牌会轮换:一次成功的刷新会返回新的 refresh_token,并立即使所提交的那个失效。会受影响的是每天刷新一次的任务,或重复使用已存储刷新令牌的任务。解决方法是在 expires_in 到期之前刷新,在使用前保存每一个新的 refresh_token,并计划在 180 天内重新授权。API for Business 认证指南仍然为 TikTok 账户令牌提供 1 天和 1 年的有效期。

2026 年 10 月 16 日,is_business_account 发生了什么变化?

TikTok 在 /business/get/ 中新增了 has_advanced_access,既可作为 fields 的取值,也作为响应字段,并将 is_business_account 的含义收窄为仅表示 Verified Business Account。将 is_business_account 当作 Advanced Access 标志来读取的代码,对于拥有 Advanced Access 但未经验证的账户,现在会得到 false。解决方法是同时请求这两个字段(需要 user.account.type 权限范围),并依据两者之一为 true 来控制 Advanced Access 所解锁的功能。

2026 年 9 月 25 日,话题标签建议发生了什么变化?

/business/hashtag/suggestion/ 新增了 post_count,即使用过每个推荐话题标签的帖子数量。其 10 条建议现在在精确匹配项之后,按帖子数量排序,TikTok 称此排序与应用内的推荐一致。没有任何内容被删除,因此现有代码仍可继续工作;但依据旧顺序建立的排序会发生变化,而 post_count 可用于按此排序。

2026 年 8 月 7 日,评论文本发生了什么变化?

TikTok 将 /business/comment/create/ 和 /business/comment/reply/create/ 中文本的上限,以及 Mentions API 中对评论提及的回复,从 150 个字符提高到 1,200 个字符。不会有任何功能失效。若您的代码为了符合 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 中的一首曲目。

2026 年 6 月 18 日,评论 Webhook 发生了什么变化?

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 日,应用审核发生了什么变化?

自当日 00:00 GMT 起,开发者在提交新的开发者应用,或申请包含 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_uri,并搭配 image_width 与 image_height 使用,评论列表对于图片评论会返回 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 令牌上,这些令牌保持 1 天和 1 年的有效期,并由 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 天免费试用。

常见问题

2026 年 API for Business 是否更改了令牌有效期?

没有。其认证指南仍然为 TikTok 账户访问令牌提供 1 天的有效期,为刷新令牌提供 1 年的有效期;2 小时和 180 天的有效期属于 TikTok for Developers 自身的规定。

TikTok 在哪里公布 API 变更?

API for Business 的变更在 business-api.tiktok.com 的 What's New 中公布,TikTok for Developers 的变更则在 developers.tiktok.com 的 Changelog 中公布。参考页面也会附有注明日期的说明,例如 3 月 20 日的申请表。

TikTok 在 2026 年是否更改了 Accounts API 的速率限制?

其 2026 年的 What's New 条目中,Accounts 相关内容没有记录任何变更:每个账户在每个接口上每分钟 40 次调用,每个应用每分钟 600 或 1,000 次。

2026 年哪项变更对回复 TikTok 评论的 AI 智能体影响最大?

有两项:自 8 月 7 日起,回复最多可达 1,200 个字符;自 6 月 18 日起,comment.update 携带评论文本,因此智能体可直接从事件中读取。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间