> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Get post metrics

> Fetch engagement metrics (likes, comments, shares, etc.) for a published post across every platform.

## Path parameters

<ParamField path="post" type="string" required>
  The UUID of the post.
</ParamField>

## 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.
* **Telegram and Discord metrics use a different shape.** Neither Bot API exposes likes, shares, or views, so each metric entry carries an extra `kind` field: `"subscribers"` for the Telegram channel's member count (and the Discord server's member count), `"reaction"` for each reaction type (where `label` is the emoji), and — for Discord only — `"comments"` for the post thread's reply count. Standard platforms omit `kind` and return likes/comments/shares.
* Successful metrics responses are cached for 5 minutes per `post_platform`.

## Response

<ResponseExample>
  ```json theme={null}
  {
    "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"
        }
      },
      {
        "post_platform_id": "c3d4e5f6-a7b8-9c0d-1e2f-3a4b5c6d7e8f",
        "platform": "telegram",
        "status": "published",
        "platform_post_id": "42",
        "platform_url": "https://t.me/c/1234567890/42",
        "metrics": [
          { "label": "Subscribers", "value": 1280, "kind": "subscribers" },
          { "label": "👍", "value": 34, "kind": "reaction" },
          { "label": "🔥", "value": 12, "kind": "reaction" }
        ]
      }
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash theme={null}
  curl https://app.trypost.it/api/posts/9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c/metrics \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>