Skip to main content
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": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.postsyncer.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Get Post

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. 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

​
id
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

​
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 (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