TikTok publish status

Query parameters

accountIduuidRequired

publishIdstringRequired

From the publish response. 1–200 characters of [A-Za-z0-9._~-].

profileIduuid

Optional, because accountId names its profile. If you pass both, they must agree.

Fields

statusstring

PROCESSING_DOWNLOAD while TikTok fetches the media; then PUBLISH_COMPLETE, SEND_TO_USER_INBOX (a draft was delivered), or FAILED. The last three are final.

publicPostIdsstring[]

The TikTok post ids, once the post is public. They can arrive up to a few minutes after PUBLISH_COMPLETE, so keep polling until they do. Absent for posts that are not public.

failureReasonstring | null

TikTok's machine-readable reason when FAILED, such as frame_rate_check_failed, video_pull_failed, or spam_risk_too_many_posts (the daily limit).

publiclyAvailableboolean | null

Whether the post is publicly viewable. false after TikTok reports it is no longer public — moderation, or the creator made it private. null when not yet known.

source"webhook" | "provider"

Whether the answer came from a TikTok webhook Adeli received or a live status call.