---
title: "Quick stats of a post"
method: GET
path: "/calendar-actions/posts/{id}/stats"
tags: ["Posts"]
---

# Quick stats of a post

`GET /calendar-actions/posts/{id}/stats`

## Request

- Base URL: `https://www.sociahive.com/api/v1`
- URL: `https://www.sociahive.com/api/v1/calendar-actions/posts/{id}/stats`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `/api/oauth/authorize`, token URL `/api/oauth/token`, scopes: `posts:read`)

The latest numbers each target of a post reported, one row per target. Rolling out (SCHEDULER_CALENDAR_CARD_ACTIONS): a 403 `feature_disabled` until it reaches your account.

## Path parameters

- `id` string, required: MongoDB ObjectId (24-character hex string)

## Response `200`

Quick stats

- PostQuickStatsEnvelope: The latest analytics of each target of one post.
  - `data` object, required
    - `post_id` string, required: MongoDB ObjectId (24-character hex string)
    - `status` string, required
    - `targets` object[], required
      - `platform` string, required: Platform id. A free string: decode ids you do not know.
      - `account_id` string, required: MongoDB ObjectId (24-character hex string)
      - `status` string, required: Target publish status (pending, processing, published, failed, ...).
      - `permalink` string
      - `published_at` string
      - `metrics` object, nullable, required: `null` until the platform has reported numbers.
        - `impressions` number, required
        - `reach` number, required
        - `engagement` number, required
        - `likes` number, required
        - `comments` number, required
        - `shares` number, required
        - `saves` number, required
        - `clicks` number, required
        - `video_views` number
      - `fetched_at` string, nullable, required

## Other responses

- `400`: Bad request — invalid parameters
- `401`: Authentication required — provide X-API-Key or Bearer token
- `403`: Insufficient scope for this operation
- `404`: Not found (or not yours)
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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