API Referenceposts

Get post status

Look up a post by the post_id returned from POST /v1/posts. Returns the current status; once the post is live, also returns the TikTok platform_post_id and url. Lets you confirm delivery without relying on the webhook.

Rate limit: 200 requests per minute per team.

Authentication

X-API-Keystring
API Key authentication via header

Path parameters

post_idstringRequired

Response

Successful Response
post_idstring

The post identifier (the same value returned by POST /v1/posts).

profile_idstring
The farm profile this post belongs to.
statusenum

processing while the post uploads/publishes on the device, posted once it is live on TikTok, failed if the post errored out.

platform_post_idstring or nullOptional

TikTok’s native post ID. null until the post is posted.

urlstring or nullOptional

Public TikTok URL of the post. null until the post is posted.

failure_reasonstring or nullOptional

Why the post failed, when status is failed. null otherwise.

Errors

404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error