How to check a TikTok post's publish status through the API
TikTok publishes API posts asynchronously: the publish call returns a share_id, and GET /business/publish/status/ with that ID as publish_id reports where the post stands. The status reads PROCESSING_DOWNLOAD while TikTok fetches the file, PUBLISH_COMPLETE once the post has passed moderation and been published, or FAILED with a reason such as frame_rate_check_failed.
easyCoexistence publishes to TikTok with publish_tiktok_post and follows each post with get_tiktok_publish_status, from Claude, ChatGPT or your own code, so your AI sees TikTok's status and any failure reason as they stand.
How long post IDs can take after PUBLISH_COMPLETE; TikTok says to retry after three minutes if they are missing.
TikTok's general estimate for downloading a 1 GB post file; the real time depends on size and network.
Usual longest wait, once the upload completes, for a post to become public; manual moderation can take longer.
Download timeout after which TikTok fails a post with video_pull_failed or photo_pull_failed.
Why does a TikTok post need following?
Because TikTok publishes it in the background. The publish call starts a task and returns a share_id at once; TikTok then downloads the file from its URL, checks the format, runs moderation and makes the post public. A post can still fail after the call itself has succeeded.
Which statuses are there?
GET /business/publish/status/ takes the account's business_id and the share_id as publish_id, and returns one of four statuses:
PROCESSING_DOWNLOAD: TikTok is downloading the content from its URL.PUBLISH_COMPLETE: the post has passed moderation and been published;post_idslists it once it is publicly viewable.- FAILED: publishing stopped, and reason says why.
SEND_TO_USER_INBOX: a draft was uploaded and TikTok notified the creator's inbox; it applies to drafts only.
How long does publishing take?
TikTok gives no fixed time. The download depends on the file size and the network, and TikTok's general estimate is that 30 minutes is enough for a 1 GB file, with an hour as the limit. After that, a post normally turns public within 2 minutes, or later when it needs manual moderation, and its post ID can take up to three more minutes to show in the status.
What do the failure reasons mean?
reason names what stopped the post. Some mean the file has to change, others that a retry can work:
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: the file breaks a format rule, and TikTok marks these as not retryable.video_pull_failed,photo_pull_failed: TikTok could not download the file, or not within the hour; retry once the URL is publicly reachable.- internal: part of TikTok's service was unavailable, and a retry is fine.
spam_risk_too_many_posts,spam_risk,spam_risk_text: TikTok stopped the post for volume, behavior or the caption's content.auth_removed: the account withdrew the app's access during processing, and TikTok says not to retry.spam_risk_user_banned_from_posting: the account is banned from making new posts.
What is the post ID for?
Finding the post afterwards. TikTok's reference passes post IDs to /business/video/list/ in filters.video_ids to read the posts' metrics. Comment calls, for their part, take a post's item_id from the account's video list as video_id, which is also what easyCoexistence's comment tools take as post_id.
How does easyCoexistence follow a post?
publish_tiktok_post returns TikTok's share_id with a note that TikTok is processing the post, and get_tiktok_publish_status takes that share_id and returns TikTok's status as it stands, with the reason when there is one. Ask your AI to check again after a few minutes rather than right away.
Common mistakes
- Publishing again because nothing showed yet. The first call only started the task, so check its status before sending the post a second time.
- Treating PUBLISH_COMPLETE without post_ids as an error. The IDs can take up to three minutes longer, so check again then.
- Retrying a format failure with the same file. file_format_check_failed and the other check failures need a corrected file.
- Taking the URL offline during the download. TikTok fails the post with video_pull_failed or photo_pull_failed when it cannot fetch the file.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
What is a share_id on TikTok?
The ID of a publishing task, returned by the video and photo publish endpoints. It goes into the status call as publish_id.
Is there a webhook for TikTok publish status?
Yes. An app subscribed with event_type VIDEO through /business/webhook/update/ receives TikTok's post publishing events, such as post.publish.failed with its reason and publish_id, in place of repeated status checks.
Why does a published post have no post ID yet?
TikTok can take up to three minutes after PUBLISH_COMPLETE to return post_ids, and returns them only for publicly viewable posts.
Can a failed TikTok post be retried?
Depending on the reason. Download and internal failures can be retried; format, duration, frame rate and picture size failures need a corrected file.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on