TikTok API 速率限制:按账户、应用和端点统计请求数
TikTok 的 API for Business 同时在三个层级限制调用:每个已授权账户在每个 Accounts API 端点上每分钟 40 次;每个开发者应用的 Accounts API 合计额度在 Basic 级为每分钟 600 次,更高等级为 1,000 次;以及应用级的单端点限制,在 Basic 级为每秒 10 次、每分钟 600 次和每天 864,000 次,到 Ultimate 级提高到每秒 50 次。
easyCoexistence 通过 TikTok 的 API for Business,为 Claude、ChatGPT 或您自己的代码发布帖子、读取洞察数据并回复 TikTok 评论;TikTok 限流时返回其代码和消息,并跟踪每个帖子直至 TikTok 完成或让其失败。
每个已授权 TikTok 账户在每个 Accounts API 端点上每分钟的查询次数,是独立于应用等级的单一数值。
每个开发者应用在所有 Accounts API 端点上的合计额度,适用于 Advanced、Premium 和 Ultimate 级;Basic 级为 600。
最高应用等级 Ultimate 的单端点限制,同时还有每分钟 3,000 次查询和每天 4,320,000 次查询。
TikTok 随返回代码一并返回的状态,包括 40100 等 4xxxx 代码;只有代码 0 表示成功。
每个开发者应用在每个 Discovery API 端点上的速率限制。
每日限制的重置时间;超出每分钟限制后,TikTok 改为要求暂停 5 分钟。
哪些限制适用于 TikTok API 调用?
每次 Accounts API 调用最多会同时累计三个计数器,部分产品和操作还会有各自的计数。TikTok 让各端点的计数器相互独立,因此某个端点可能被限流,而应用的其他端点仍可正常响应:
四个应用等级各允许什么?
所有开发者应用默认为 Basic 级。在「My Apps」「App Detail」「Authorization」下提交申请并说明理由后,TikTok 会逐级提升应用等级。每个等级既规定单个端点可从应用获取的上限,也规定 Accounts API 调用的合计额度:
更高等级会提高 Accounts API 的额度吗?
只会提高一次。从 Basic 升级到 Advanced 时,Accounts API 的合计额度从每分钟 600 次提高到 1,000 次,并在 Premium 和 Ultimate 级保持为 1,000 次;而每秒和每天的单端点限制仍会继续提高。每个账户和端点每分钟 40 次的限制完全不随等级变化,因此无论应用处于哪个等级,一个繁忙的账户在某个端点上仍会被限制为每分钟 40 次调用。
多个账户的限制如何累加?
账户限制会随账户数量相乘,而应用额度不会。十个账户各自可以每分钟向 /business/comment/list/ 发起 40 次调用,合计 400 次;但二十个账户做同样的事则需要 800 次,超过 Basic 应用为全部 Accounts API 调用设定的 600 次合计额度,此时尚未计入任何其他端点。Basic 以上的等级中,该共享额度最高为每分钟 1,000 次。
调用超出限制时会发生什么?
TikTok 会对该端点限流。其速率限制指南中提到,被限流的调用会以代码 40100 表示,并在 HTTP 200 响应的正文中返回;超出每分钟限制后,该端点关闭 5 分钟;超出每日限制后,则需等到 UTC 00:00 每日计数重置。应用的其他端点仍可正常响应。在代码中检测并妥善重试,属于错误 40100 的处理内容。
发布数量上限属于速率限制吗?
不属于。它们统计的是帖子数量而非调用次数,并有单独的说明页面。TikTok 允许账户通过 /business/video/publish/ 每分钟发布 6 条、每天发布 15 条帖子,/business/photo/publish/ 的限制与此相同。超过该数量的帖子会在其发布状态中以 spam_risk_too_many_posts 失败,而速率限制则是直接拒绝调用本身。
哪些习惯最快耗尽限制?
轮询。按计时器反复查询发布状态或评论列表,无论内容是否变化,都会消耗账户在该端点上每分钟 40 次的调用额度。TikTok 的 Webhook 正是为替代轮询而设:帖子发布事件会报告帖子的每个阶段,comment.update 则会在五分钟内报告新评论。分页读取(每次 20 条帖子或 30 条评论),并每天拉取一次 Mentions 数据,可以让其余消耗保持在较低水平。
easyCoexistence 如何处理被限流的 TikTok 调用?
它会如实转达 TikTok 的响应,而不是加以隐藏。被 TikTok 限流的工具调用(例如 list_social_comments、reply_to_comment 或 get_tiktok_publish_status)会以错误形式返回给 AI,错误中包含代码 40100 和 TikTok 的原始消息,且不会自动重复。帖子则走另一条路径:publish_tiktok_post 会将每个帖子交给 easyCoexistence 的队列处理,可立即发布,也可定时发布:
- 队列会在收到 HTTP 429 响应后等待并重试,间隔分别为 5 分钟、30 分钟和 2 小时。
- TikTok 在 HTTP 200 响应中返回 40100,因此被限流的 TikTok 发布会以 TikTok 的消息失败,并在「Needs attention」下等待您点击「Retry」。
- 队列状态检查中出现的 40100 同样会使帖子失败,但 TikTok 可能已经发布该帖子:点击「Retry」之前,请先查看账户最新的帖子。
- 后台失败的帖子会向所有者发送电子邮件,每个渠道每 3 小时最多一封。
easyCoexistence 会为某个账户发起哪些 TikTok 调用?
数量很少,它们与您自己的调用一样计入账户的限额:
- /business/get/,约每 6 小时一次,用于确认账户仍可正常响应。
- 每条帖子发起一次发布调用,随后约每 20 秒调用一次 /business/publish/status/,直到 TikTok 完成或让帖子失败,最长持续 2 小时。
- 开启评论规则或自动化后,每条新的顶层评论调用一次 /business/comment/list/ 以读取其作者,每条已发布的回复也调用一次。
- 仅在 AI 或您的代码请求时才调用工具,每次读取 20 条帖子或 30 条评论。
常见错误
- 通过 HTTP 状态判断是否被限流。TikTok 以 HTTP 200 返回 40100,因此检查 res.ok 或 429 会漏掉它;请读取正文中的代码。
- 为修复某个繁忙账户而提高应用等级。每个账户和端点每分钟 40 次的限制在四个等级中都保持不变,因此应将该账户的调用分散到不同时间段。
- 每天多次拉取 Mentions 数据。TikTok 每天只刷新一次,刷新时间在 UTC 午夜至早上 7 点之间,并建议每个端点、每个账户每天只调用一次。
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,首 3 天免费试用。
常见问题
TikTok API 每个账户的速率限制是多少?
每个已授权 TikTok 账户在每个 Accounts API 端点上每分钟 40 次查询,并计入开发者应用的合计额度,Basic 级为每分钟 600 次,更高等级为 1,000 次。
TikTok 速率限制是按端点分别计算的吗?
是的。TikTok 的指南说明,端点专属限制相互独立,因此达到某个端点的限制不会阻止对另一个端点的调用。
如何提高我的 TikTok API 速率限制?
在「My Apps」「App Detail」「Authorization」下提交申请,并说明理由。等级逐级提升,从 Basic 到 Advanced,再到 Premium,最后是 Ultimate。
通过 easyCoexistence 的调用会计入 TikTok 的限额吗?
会。这些调用以已连接账户及其访问令牌的身份运行,因此与该账户的其他调用一样,计入其每个端点每分钟 40 次的调用额度。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间