---
title: "Engagement metrics for one post"
method: GET
path: "/metrics"
---

# Engagement metrics for one post

`GET /metrics`

## Request

- Base URL: `https://xpost.to/api/v1`
- URL: `https://xpost.to/api/v1/metrics`
- Auth: HTTP bearer

Per-delivery engagement (views, likes, comments, shares, reach, saves, engagement) with the live URL. A null metric means the platform doesn't report it — not zero. Empty `data` = not synced yet (metrics refresh roughly every 6 h).

## Query parameters

- `post_id` string, uuid, required

## Response `200`

Metrics

- object
  - `post_id` string
  - `data` object[]

## Other responses

- `401`: Missing or invalid API key
- `404`: Post not found in this project
- `429`: Rate limited

---

[API](https://skmtc.dev/xpost/apis/xpost-api.md) · [All operations](https://skmtc.dev/xpost/apis/xpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xpost/apis/xpost-api/revisions/9f570fcfed6d?raw)