List Social Posts

Overview#

Returns the social posts in your workspace — drafts waiting for review, scheduled posts, and everything already published or failed. This is the same history the Posts Log shows in your dashboard.

Use it to find a post's id before reading, editing, publishing or discarding it.

https://api.orshot.com/v1/social/posts

Request#

await fetch("https://api.orshot.com/v1/social/posts?status=draft&limit=10", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Query Parameters#

Pass status=draft to list exactly the posts that are being held and have not reached any platform.

Post Object#

Every endpoint that returns a post returns this shape.

Branch on the two capability flags rather than on status — they are not the same test:

• is_editable is true only while the post is held (draft or scheduled). Editing and publishing require it.
• is_discardable is true unless at least one account already published. A failed post is discardable but not editable; a partial post is neither.

Error Responses#

Invalid cursor (400)#

{
  "error": "Invalid cursor",
  "message": "cursor must be a post id"
}

Unauthorized (403)#

{
  "error": "Access Forbidden"
}

Rate Limits#

• 20 requests per minute per workspace, shared across all social endpoints