BLblotato
publishing

Get post status

Changed on

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}

Request

  • Base URL
    https://backend.blotato.com
  • Auth
    API key in header blotato-api-key

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"
}

Changes

  • 39e94457ccb2Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 51232970f10eRevision changes
    • info

      added the non-success response with the status