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 null

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

urlstring or null

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

Errors

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