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

如何通过 API 查看 TikTok 帖子的发布状态

TikTok 以异步方式处理 API 发布的帖子:发布调用会返回 share_id,将该 ID 作为 publish_id 传入 GET /business/publish/status/,即可查看帖子进度。状态为 PROCESSING_DOWNLOAD 时,TikTok 正在下载文件;帖子通过审核并发布后显示 PUBLISH_COMPLETE;若发布失败,则显示 FAILED 及 frame_rate_check_failed 等原因。

easyCoexistence 通过 publish_tiktok_post 向 TikTok 发布内容,并通过 get_tiktok_publish_status 跟踪每个帖子,可在 Claude、ChatGPT 或您自己的代码中使用,让您的 AI 看到 TikTok 的当前状态及任何失败原因。

3 min

帖子 ID 在 PUBLISH_COMPLETE 之后可能需要多久才会出现;若缺失,TikTok 建议三分钟后重试。

30 min

TikTok 对下载 1 GB 帖子文件所需时间的一般估计;实际时间取决于文件大小和网络。

2 min

文件上传完成后,帖子通常最长需要多久才会公开;人工审核可能耗时更长。

1 hour

下载超时时间:超时后 TikTok 会以 video_pull_failed 或 photo_pull_failed 使帖子失败。

为什么需要跟踪 TikTok 帖子?

因为 TikTok 在后台发布帖子。发布调用会启动一个任务,并立即返回 share_id;随后 TikTok 从其 URL 下载文件、检查格式、进行审核,并将帖子公开。即使调用本身已成功,帖子仍可能发布失败。

有哪些状态?

GET /business/publish/status/ 需要传入账户的 business_id,并将 share_id 作为 publish_id,返回以下四种状态之一:

  • PROCESSING_DOWNLOAD:TikTok 正在从其 URL 下载内容。
  • PUBLISH_COMPLETE:帖子已通过审核并发布;公开可见后,post_ids 会列出该帖子。
  • FAILED:发布已停止,reason 说明原因。
  • SEND_TO_USER_INBOX:草稿已上传,TikTok 已通知创作者的收件箱;仅适用于草稿。

发布需要多长时间?

TikTok 没有给出固定时间。下载时间取决于文件大小和网络。TikTok 的一般估计是,1 GB 文件 30 分钟足够,上限为一小时。之后,帖子通常在 2 分钟内公开;若需要人工审核,则会更晚。其帖子 ID 最多还需三分钟才会在状态中显示。

失败原因分别是什么意思?

reason 说明了是什么导致帖子停止。有些意味着文件必须修改,有些则表示重试可能成功:

  • file_format_check_failed、duration_check_failed、frame_rate_check_failed、picture_size_check_failed:文件违反了格式规则,TikTok 将这些标记为不可重试。
  • video_pull_failed、photo_pull_failed:TikTok 无法下载文件,或未能在一小时内完成下载;待 URL 可公开访问后重试。
  • internal:TikTok 的部分服务不可用,可以重试。
  • spam_risk_too_many_posts、spam_risk、spam_risk_text:因发帖数量、行为或标题内容,TikTok 停止了该帖子。
  • auth_removed:处理期间,账户撤销了应用的访问权限;TikTok 表示不应重试。
  • spam_risk_user_banned_from_posting:该账户已被禁止发布新帖子。

帖子 ID 有什么用?

用于之后找到该帖子。TikTok 的参考文档会将帖子 ID 通过 filters.video_ids 传给 /business/video/list/,以读取帖子的指标。评论调用则从账户的视频列表中获取帖子的 item_id,作为 video_id 使用;easyCoexistence 的评论工具也以它作为 post_id。

easyCoexistence 如何跟踪帖子?

publish_tiktok_post 会返回 TikTok 的 share_id,并附注 TikTok 正在处理该帖子;get_tiktok_publish_status 接收该 share_id,并返回 TikTok 当前的状态,若有原因则一并返回。请让您的 AI 在几分钟后再次查询,而不要立即查询。

常见错误

  • 因为尚未看到任何结果就重新发布。首次调用只是启动了任务,因此请先检查状态,再重新发送帖子。
  • 将缺少 post_ids 的 PUBLISH_COMPLETE 视为错误。帖子 ID 最多可能还需三分钟,届时再检查即可。
  • 使用同一文件重试格式失败。file_format_check_failed 及其他检查失败都需要更正后的文件。
  • 在下载期间下线 URL。TikTok 无法获取文件时,会以 video_pull_failed 或 photo_pull_failed 使帖子失败。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 至 US$ 0.75,连接越多越便宜,前 3 天免费试用。

常见问题

TikTok 的 share_id 是什么?

发布任务的 ID,由视频和图片发布端点返回。在状态调用中作为 publish_id 传入。

TikTok 发布状态有 Webhook 吗?

有。订阅 event_type 为 VIDEO 的应用(通过 /business/webhook/update/ 设置)会收到 TikTok 的帖子发布事件,例如包含原因和 publish_id 的 post.publish.failed,无需反复查询状态。

为什么已发布的帖子还没有帖子 ID?

TikTok 在 PUBLISH_COMPLETE 之后最多可能需要三分钟才返回 post_ids,并且仅为公开可见的帖子返回。

失败的 TikTok 帖子可以重试吗?

视情况而定。下载失败和内部错误可以重试;格式、时长、帧率和图片尺寸失败则需要更正文件。

继续阅读

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

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

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

验证时间