---
title: "Get Mastodon and Bluesky post statistics"
method: POST
path: "/post-statistics"
tags: ["Platform Analytics"]
---

# Get Mastodon and Bluesky post statistics

`POST /post-statistics`

## Request

- Base URL: `https://api.publora.com/api/v1`
- URL: `https://api.publora.com/api/v1/post-statistics`
- Auth: API key in header `x-publora-key`

Engagement counters for up to 50 published Mastodon or Bluesky posts. Values are
read from the platform when requested and cached for about 2 hours; nothing is
collected in the background, so there is no history.

Only posts Publora published for the caller, and stored a `postedId` for, can be
queried; any other id is answered `null` without contacting the platform. Publora
began storing `postedId` for these two platforms on 2026-09-07. For a thread, only
the root part is addressable.

Requires a plan with analytics; otherwise `403 ANALYTICS_PLAN_REQUIRED`.

## Request body

- object
  - `posts` object[], required: One entry per post. Platforms and connections may be mixed.
    - `platform` 'mastodon' | 'bluesky', required
    - `platformId` string, required: Connection ID, with or without the `<platform>-` prefix
    - `postedId` string, required: Bluesky AT-URI or Mastodon status ID

## Response `200`

Statistics retrieved. A `null` value in `stats` means "no data right now" —
a deleted post, an id that is not one of the caller's published posts, or a
connection listed in `issues`.

- object
  - `success` boolean
  - `stats` object: Keyed by postedId
  - `rateLimited` boolean: Present only when a connection was in a rate-limit cooldown
  - `issues` object: Present only when non-empty. Keyed by connection ID in the `<platform>-<platformId>` form.

## Other responses

- `400`: Bad request - missing or invalid parameters
- `403`: The plan does not include analytics
- `500`: Server error
- `504`: The request exceeded its 90-second budget

## Changes

- **2026-09-08** `e1c86e247b92`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/publora/apis/publora-api/changes/post-statistics/post.md)

---

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