Sign in
latestOpenAPI 3.0.32026-08-23410223.0 KB

c93447ba6b9d

publishing

Get post status

Fetches the status of a post by its submission ID. This is useful for checking if a post was successfully published or if it failed. Post lookup has a user-level rate limit of 60 requests / minute to prevent spamming / abusing social media endpoints

get/v2/posts/{postSubmissionId}

Path parameters

postSubmissionIdstring required
Example:123e4567-e89b-12d3-a456-426614174000

The ID of the post submission to check.

Response

Default Response

postSubmissionIdstring required

The ID of the post submission.

status'in-progress' | 'failed' | 'published' | 'scheduled' required

The current status of the post.

scheduledTimestring

The scheduled time of the post if it is scheduled. Null if the post was published immediately.

publicUrlstring

The public URL of the post if it was published.

errorMessagestring

The error message if the post failed.

Example response

{
  "postSubmissionId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "published",
  "scheduledTime": "2025-03-11T15:30:00.000Z",
  "publicUrl": "https://x.com/post/12345",
  "errorMessage": "Unsupported media type"
}