Platform Analytics

Get Mastodon and Bluesky post statistics

Changed on

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.

post/post-statistics

Request

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

Request body

Example request

{
  "posts": [
    {
      "platformId": "bluesky-did:plc:3xcxmi4aiok5zyghylsa4dzw",
      "postedId": "at://did:plc:3xcxmi4aiok5zyghylsa4dzw/app.bsky.feed.post/3muxmedtwxd2k"
    }
  ]
}

Response

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.

successboolean
statsobject

Keyed by postedId

rateLimitedboolean

Present only when a connection was in a rate-limit cooldown

issuesobject

Present only when non-empty. Keyed by connection ID in the <platform>-<platformId> form.

Changes