Posts
Get Post
Retrieve details for a specific post
GET
Return the canonical status for a single post, including every account’s state (
pending, posted, failed, retry metadata, published URLs, etc.) plus normalized media metadata. Media mirrors the create payload (type + url/urls) or returns null for text-only posts, and surfaces music_url alongside it.
Path Parameters
string
required
The UUID of the post to retrieve (e.g.,
11111111-1111-1111-1111-111111111111).Response
string
Post ID.
string
Post caption.
string
Overall status of the post.
object | null
Returned in the same shape as create/update payloads, or
null for text-only posts.string | null
TikTok post URL when music is applied;
null otherwise.object | null
Optional TikTok settings when present on the post; otherwise
null.object | null
Optional Pinterest settings (
board_id, link, title, tags) when present on the post;
otherwise null.object
Error Responses
401- authentication failed (missing/invalid/revoked token)402 subscription_required- active Creator/Professional/Business plan required403 tier_not_allowed- Scheduler tier cannot use Partner API404 not_found- post does not exist in the authenticated key scope500 get_failed- unexpected database/serialization error
