Get Post

curl -X GET "https://postsyncer.com/api/v1/posts/123?include_comments=true" \
  -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
              }
          },
          "analytics": {
              "comments": 8,
              "likes": 42,
              "shares": 8,
              "impressions": 1250,
              "quotes": 2,
              "saves": 12,
              "engagement_rate": 4.4
          }
      }
  ],
  "auto_plug": null,
  "comments": []
}

GET

posts

{id}

curl -X GET "https://postsyncer.com/api/v1/posts/123?include_comments=true" \
  -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
              }
          },
          "analytics": {
              "comments": 8,
              "likes": 42,
              "shares": 8,
              "impressions": 1250,
              "quotes": 2,
              "saves": 12,
              "engagement_rate": 4.4
          }
      }
  ],
  "auto_plug": null,
  "comments": []
}

Retrieves detailed information about a specific post, including its content, status, scheduling information, and platform-specific details. Use include_comments=true to attach all comments for the post, including their associated contact info. You can also load the same resource by public permalink or by platform-native post id when you do not know the internal PostSyncer id. For aggregated analytics without parsing platforms here, use the Analytics API — for example GET /analytics/posts/{post} for one post (totals plus per-account rows).

Request

integer

required

The ID of the post to retrieve

include_comments

boolean

default:"false"

When true, includes all comments associated with the post, including their contact info (CRM contact)

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

Response

integer

Unique identifier for the post

content

array

Array of content objects with text, media, and optional cover_image. Cover requirements by platform: TikTok uses video_cover_timestamp_ms only; YouTube, Instagram, and Facebook use thumbnail only — see Create post.

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 (minutes, hours, days, weeks, months)

repeatable_accounts

integer[]

Account IDs limiting repeat scheduling when set; configure with repeatable / repeatable_accounts on create or update.

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. For published posts, each platform includes an analytics object with performance metrics (likes, comments, impressions, engagement_rate, etc.)

auto_plug

object | null

Auto plug when enabled, or null. Update via Update post auto plug.

comments_settings

object | null

Per-post comment moderation. Update via Update post comment moderation.

contact_collection_settings

object | null

CRM contact collection rules. Update via Update post contact collection.

comments

array

When include_comments=true, includes all comments for the post. Each comment has id, content, author_name, platform, created_at, and a contact object with CRM contact info (name, username, profile_url, etc.) when available.

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
              }
          },
          "analytics": {
              "comments": 8,
              "likes": 42,
              "shares": 8,
              "impressions": 1250,
              "quotes": 2,
              "saves": 12,
              "engagement_rate": 4.4
          }
      }
  ],
  "auto_plug": null,
  "comments": []
}

Code Examples

curl -X GET "https://postsyncer.com/api/v1/posts/123?include_comments=true" \
  -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

Create Post

Get Post by URL

​Get Post

​Request

​Response

​Code Examples

​Error Codes

Get Post

Request

Response

Code Examples

Error Codes