如何通过 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 的当前状态及任何失败原因。
帖子 ID 在 PUBLISH_COMPLETE 之后可能需要多久才会出现;若缺失,TikTok 建议三分钟后重试。
TikTok 对下载 1 GB 帖子文件所需时间的一般估计;实际时间取决于文件大小和网络。
文件上传完成后,帖子通常最长需要多久才会公开;人工审核可能耗时更长。
下载超时时间:超时后 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 使帖子失败。
每个连接每月 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 监控
验证时间