Get a Social Post

Overview#

Returns a single post with its per-account results — where it landed, the live URL on each platform, or why an account failed.

This is how you confirm what actually happened to a post, including confirming that a draft is still being held and has not been published.

https://api.orshot.com/v1/social/posts/{postId}

Request#

await fetch("https://api.orshot.com/v1/social/posts/512", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

See List Social Posts for the full post object reference.

Refreshing status#

Some platforms — Instagram and TikTok among them — publish asynchronously. A post sent to those sits at processing until the platform reports back, so a freshly created post will not immediately carry its live URLs.

To pull the current state from the platforms and update the stored post:

POST /social/posts/{postId}/sync#

await fetch("https://api.orshot.com/v1/social/posts/512/sync", {
  method: "POST",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

{
  "data": {
    "post": { "id": 512, "status": "published" },
    "synced": true,
    "status": "published",
    "platforms": [
      {
        "account_id": 15,
        "platform": "linkedin",
        "status": "published",
        "url": "https://linkedin.com/feed/update/urn:li:share:1234567890"
      }
    ]
  }
}

synced is false when there was nothing to refresh against, in which case the stored post is returned unchanged. Syncing never changes a held draft into a published post — a draft stays a draft until you publish it.

Only sync posts that are actually in flight (processing, scheduled or partial). Published and failed posts are settled, and syncing them just spends rate limit.

Error Responses#

Not found (404)#

{
  "error": "Post not found"
}

Returned both when no post has that ID and when the post belongs to a different workspace.

Unauthorized (403)#

{
  "error": "Access Forbidden"
}

Rate Limits#

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