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

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

array

Array of content objects with text, media, optional cover_image, and optional first-comment fields (is_first_comment, first_comment_delay). Cover requirements by platform: TikTok uses video_cover_timestamp_ms only; YouTube, Instagram, and Facebook use thumbnail only - see Create post. First comments: see Create post - first comments.

string

Status of the post (draft, scheduled, published, failed)

array

Array of posted timestamps in workspace timezone

string

Scheduled date and time in workspace timezone

boolean

Whether the post is set to repeat

integer

Number of times the post will repeat

integer

Gap between repeats

string

Unit for the repeat gap (minutes, hours, days, weeks, months)

integer[]

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

integer

Number of remaining posts in the repeat sequence

object

Information about the post’s workspace

array

Array of labels attached to the post

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

object | null

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

object | null

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

object | null

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

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.

string

Creation timestamp in workspace timezone

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"

const axios = require('axios');

const getPost = async (postId) => {
  try {
    const response = await axios.get(`https://postsyncer.com/api/v1/posts/${postId}`, {
      headers: {
        'Authorization': 'Bearer YOUR_API_TOKEN'
      }
    });
    
    console.log('Post:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error fetching post:', error.response?.data || error.message);
  }
};

getPost(123);

<?php

$postId = 123;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://postsyncer.com/api/v1/posts/{$postId}");
curl_setopt($ch, CURLOPT_HTTPGET, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $post = json_decode($response, true);
    echo "Post {$post['id']}: " . $post['content'][0]['text'];
} else {
    echo "Error: " . $response;
}
?>

import requests

post_id = 123
headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.get(
    f'https://postsyncer.com/api/v1/posts/{post_id}',
    headers=headers
)

if response.status_code == 200:
    post = response.json()
    print(f"Post {post['id']}: {post['content'][0]['text']}")
    print(f"Status: {post['status']}")
    print(f"Platforms: {len(post['platforms'])}")
else:
    print(f"Error: {response.status_code}")
    print(response.text)

Error Codes

Unauthorized

Missing or invalid API token

Forbidden

Token does not have ‘posts’ permission

Not Found

Post not found or user does not have access to the post’s workspace

Create Post

Get Post by URL

Start here

Guides

MCP

API reference

Get Post

Get Post

Request

Response

Code Examples

Error Codes

​Get Post

​Request

​Response

​Code Examples

​Error Codes

Get Post

Request

Response

Code Examples

Error Codes