Skip to main content
GET
/
posts
/
{post}
/
metrics
curl https://app.trypost.it/api/posts/9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c/metrics \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "post_id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "platforms": [
    {
      "post_platform_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
      "platform": "linkedin",
      "status": "published",
      "platform_post_id": "urn:li:share:7263...",
      "platform_url": "https://www.linkedin.com/feed/update/urn:li:share:7263...",
      "metrics": [
        { "label": "Likes", "value": 42 },
        { "label": "Comments", "value": 7 }
      ]
    },
    {
      "post_platform_id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
      "platform": "x",
      "status": "pending",
      "platform_post_id": null,
      "platform_url": null,
      "metrics": {
        "unsupported": true,
        "reason": "not_published"
      }
    }
  ]
}

​
Path parameters

​
post
string
required
The UUID of the post.

​
Behaviour

  • The post must belong to the caller’s current workspace; otherwise the response is 404.
  • Returns one entry per enabled platform on the post.
  • A platform entry returns metrics: { unsupported: true, reason: "not_published" } when the platform hasn’t been published yet, and { unsupported: true, reason: "platform_not_supported" } for platforms that don’t expose post-level metrics. Today that’s TikTok and personal LinkedIn (linkedin); LinkedIn Pages (linkedin-page) and every other platform return real metrics.
  • Successful metrics responses are cached for 5 minutes per post_platform.

​
Response

{
  "post_id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "platforms": [
    {
      "post_platform_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
      "platform": "linkedin",
      "status": "published",
      "platform_post_id": "urn:li:share:7263...",
      "platform_url": "https://www.linkedin.com/feed/update/urn:li:share:7263...",
      "metrics": [
        { "label": "Likes", "value": 42 },
        { "label": "Comments", "value": 7 }
      ]
    },
    {
      "post_platform_id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
      "platform": "x",
      "status": "pending",
      "platform_post_id": null,
      "platform_url": null,
      "metrics": {
        "unsupported": true,
        "reason": "not_published"
      }
    }
  ]
}

curl https://app.trypost.it/api/posts/9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c/metrics \
  -H "Authorization: Bearer YOUR_API_KEY"