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

{
  "post_id": 743,
  "total": {
    "comments": 16,
    "likes": 84,
    "shares": 12,
    "impressions": 2500,
    "quotes": 4,
    "saves": 20,
    "engagement_rate": 4.25
  },
  "accounts": [
    {
      "account_id": 55,
      "platform": "twitter",
      "status": "PUBLISHED",
      "post_url": "https://twitter.com/user/status/123",
      "analytics": {
        "comments": 8,
        "likes": 42,
        "shares": 8,
        "impressions": 1250,
        "quotes": 2,
        "saves": 12,
        "engagement_rate": 4.4
      },
      "account": {
        "id": 55,
        "workspace_id": 12,
        "platform": "twitter",
        "username": "example",
        "name": "Example",
        "avatar": "https://…",
        "has_expired": false,
        "is_default": false,
        "support_threads": true,
        "is_verified": false
      }
    }
  ]
}

​
By post

Returns cumulative engagement metrics for a single post (summed across every connected account / platform row) and a per-account breakdown. The only input is the post ID in the path (no query parameters). Metrics match the analytics object on each item under platforms when you get a post: comments, likes, shares, impressions, quotes, saves, and engagement_rate. For published platform rows, analytics uses the same values as the dashboard sync. For non-published rows, analytics is an empty object {}. The total.engagement_rate value is a weighted average by impressions across published rows when any row has impressions; otherwise it falls back to a simple average of non-zero rates.

​
Request

​
post
integer
required
Post primary key (same id as in /posts/{id}).
curl -X GET "https://postsyncer.com/api/v1/analytics/posts/743" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Response

​
post_id
integer
The post id from the path
​
total
object
Cumulative metrics: comments, likes, shares, impressions, quotes, saves, engagement_rate
​
accounts
array
One entry per platform post row: account_id, platform, status, post_url, analytics, and account (same shape as list-accounts when present)
{
  "post_id": 743,
  "total": {
    "comments": 16,
    "likes": 84,
    "shares": 12,
    "impressions": 2500,
    "quotes": 4,
    "saves": 20,
    "engagement_rate": 4.25
  },
  "accounts": [
    {
      "account_id": 55,
      "platform": "twitter",
      "status": "PUBLISHED",
      "post_url": "https://twitter.com/user/status/123",
      "analytics": {
        "comments": 8,
        "likes": 42,
        "shares": 8,
        "impressions": 1250,
        "quotes": 2,
        "saves": 12,
        "engagement_rate": 4.4
      },
      "account": {
        "id": 55,
        "workspace_id": 12,
        "platform": "twitter",
        "username": "example",
        "name": "Example",
        "avatar": "https://…",
        "has_expired": false,
        "is_default": false,
        "support_threads": true,
        "is_verified": false
      }
    }
  ]
}

​
Permissions

Requires the same posts ability as other post endpoints.

​
Error codes

​
401
Unauthorized
Missing or invalid API token
​
403
Forbidden
Token does not have the posts permission
​
404
Not Found
Post does not exist or is not in any workspace the user can access

​
Code examples

curl -X GET "https://postsyncer.com/api/v1/analytics/posts/743" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
See also: Analytics overview.