Skip to main content
GET
https://postsyncer.com/api/v1
posts
/
{id}
curl -X GET "https://postsyncer.com/api/v1/posts/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{ 
  "id": 743,
  "content": [
      {
          "text": "",
          "media": [
              {
                  "id": 1594,
                  "name": "file_example_MP4_1920_18MG.mp4",
                  "url": "https://postsyncer-local.c6c56f7fb91dd557ca29aa14c4e7d980.r2.cloudflarestorage.com/media/12/5ee789eb-c88c-4af2-8449-54c6c0561f31.mp4?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=a4bcd089276d5d5b77253aa9b13fe59c%2F20250705%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250705T131116Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=0ef23b86009e4cac6e160863a4b91f15b78270e5524f328fb764a9f22bdaffe3",
                  "type": "video/mp4",
                  "size": 17839845
              }
          ]
      }
  ],
  "status": "PUBLISHED",
  "posted_on": [
      "2025-07-05 12:36"
  ],
  "scheduled_at": "2025-07-05 16:00",
  "repeatable": false,
  "repeatable_times": null,
  "repeatable_gap": null,
  "repeatable_gap_unit": null,
  "remaining_posts": null,
  "created_at": "2025-07-05 12:34",
  "updated_at": "2025-07-05 12:36",
  "workspace": {
      "id": 12,
      "name": "abdulmejidshemsuawel",
      "slug": "abdulmejidshemsuawel",
      "type": "PERSONAL",
      "logo": null,
      "timezone": "Africa/Addis_Ababa",
      "language": "en"
  },
  "labels": [],
  "platforms": [
      {
          "platform": "twitter",
          "posted_on": [
              "2025-07-05 12:36"
          ],
          "status": "PUBLISHED",
          "settings": {
              "for_super_followers_only": false,
              "reply_settings": "everyone",
              "quote_tweet_id": null,
              "reply": {
                  "in_reply_to_tweet_id": null
              },
              "community_id": null,
              "share_with_followers": true,
              "text": null,
              "poll": {
                  "enabled": false
              }
          }
      }
  ],
  "auto_plug": null 
}

​
Get Post

Retrieves detailed information about a specific post, including its content, status, scheduling information, and platform-specific details.

​
Request

​
id
integer
required
The ID of the post to retrieve
curl -X GET "https://postsyncer.com/api/v1/posts/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Response

​
id
integer
Unique identifier for the post
​
content
array
Array of content objects with text and media
​
status
string
Status of the post (draft, scheduled, published, failed)
​
posted_on
array
Array of posted timestamps in workspace timezone
​
scheduled_at
string
Scheduled date and time in workspace timezone
​
repeatable
boolean
Whether the post is set to repeat
​
repeatable_times
integer
Number of times the post will repeat
​
repeatable_gap
integer
Gap between repeats
​
repeatable_gap_unit
string
Unit for the repeat gap (hours, days, weeks, months)
​
remaining_posts
integer
Number of remaining posts in the repeat sequence
​
workspace
object
Information about the post’s workspace
​
labels
array
Array of labels attached to the post
​
platforms
array
Array of platform-specific post information
​
auto_plug
boolean
Whether auto-plug is enabled for this post
​
created_at
string
Creation timestamp in workspace timezone
​
updated_at
string
Last update timestamp in workspace timezone
{ 
  "id": 743,
  "content": [
      {
          "text": "",
          "media": [
              {
                  "id": 1594,
                  "name": "file_example_MP4_1920_18MG.mp4",
                  "url": "https://postsyncer-local.c6c56f7fb91dd557ca29aa14c4e7d980.r2.cloudflarestorage.com/media/12/5ee789eb-c88c-4af2-8449-54c6c0561f31.mp4?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=a4bcd089276d5d5b77253aa9b13fe59c%2F20250705%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250705T131116Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=0ef23b86009e4cac6e160863a4b91f15b78270e5524f328fb764a9f22bdaffe3",
                  "type": "video/mp4",
                  "size": 17839845
              }
          ]
      }
  ],
  "status": "PUBLISHED",
  "posted_on": [
      "2025-07-05 12:36"
  ],
  "scheduled_at": "2025-07-05 16:00",
  "repeatable": false,
  "repeatable_times": null,
  "repeatable_gap": null,
  "repeatable_gap_unit": null,
  "remaining_posts": null,
  "created_at": "2025-07-05 12:34",
  "updated_at": "2025-07-05 12:36",
  "workspace": {
      "id": 12,
      "name": "abdulmejidshemsuawel",
      "slug": "abdulmejidshemsuawel",
      "type": "PERSONAL",
      "logo": null,
      "timezone": "Africa/Addis_Ababa",
      "language": "en"
  },
  "labels": [],
  "platforms": [
      {
          "platform": "twitter",
          "posted_on": [
              "2025-07-05 12:36"
          ],
          "status": "PUBLISHED",
          "settings": {
              "for_super_followers_only": false,
              "reply_settings": "everyone",
              "quote_tweet_id": null,
              "reply": {
                  "in_reply_to_tweet_id": null
              },
              "community_id": null,
              "share_with_followers": true,
              "text": null,
              "poll": {
                  "enabled": false
              }
          }
      }
  ],
  "auto_plug": null 
}

​
Code Examples

curl -X GET "https://postsyncer.com/api/v1/posts/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Error Codes

​
401
Unauthorized
Missing or invalid API token
​
403
Forbidden
Token does not have ‘posts’ permission
​
404
Not Found
Post not found or user does not have access to the post’s workspace