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

# Get Mastodon and Bluesky profile statistics

`POST /profile-statistics`

## Request

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

Followers, following and post count of one connected Mastodon or Bluesky account.
Cached for about 2 hours. Requires a plan with analytics.

## Request body

- object
  - `platform` 'mastodon' | 'bluesky', required
  - `platformId` string, required: Connection ID, with or without the `<platform>-` prefix

## Response `200`

Profile retrieved

- object
  - `success` boolean
  - `profile` PlatformProfileMetrics: Follower counters for one connected account.
    - `followers` integer, nullable
    - `following` integer, nullable
    - `posts` integer, nullable
  - `cached` boolean: true when the answer came from the cache
  - `fetchedAt` string, date-time, nullable
  - `rateLimited` boolean: Present only during a rate-limit cooldown
  - `unavailable` 'AUTH_REVOKED' | 'FORBIDDEN': Present only when the connection is marked unavailable for analytics

## Other responses

- `400`: Bad request - missing or invalid parameters
- `403`: The plan does not include analytics
- `404`: The connection is not the caller's
- `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/profile-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)