# Fediverse Statistics API
> Live Fediverse statistics as an API — a read on the size and shape of the decentralised social web. The fediverse is the network of interoperable social platforms — Mastodon, Misskey, Pixelfed, Lemmy, PeerTube and dozens more — and this returns the network-wide totals (instances, users, posts and monthly active users), the breakdown by software (how many instances and users each platform runs, with its license, website and source repository, and the hosting providers it concentrates on), and the largest servers ranked by user count, with an optional filter to a single platform. The meta-social layer: not one platform's posts, but the whole federated network as clean JSON, served live from FediDB. Distinct from the single-platform Mastodon, Misskey, Mbin and Lemmy APIs — this is the cross-fediverse statistics layer for social, research and dashboard apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fediverse-api/..."
```

## Pricing
- **Free** (Free) — 12,000 calls/Mo, 5 req/s
- **Starter** ($6/Mo) — 160,000 calls/Mo, 15 req/s
- **Pro** ($16/Mo) — 800,000 calls/Mo, 40 req/s
- **Scale** ($39/Mo) — 4,000,000 calls/Mo, 100 req/s

## Endpoints

### Stats

#### `GET /v1/stats` — Network-wide fediverse totals

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fediverse-api/v1/stats"
```

**Response:**
```json
{
    "data": {
        "total_posts": 1596667299,
        "total_users": 13349964,
        "last_updated": "2026-06-09T03:00:02+00:00",
        "total_instances": 42812,
        "monthly_active_users": 1097954
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:37.250Z",
        "request_id": "1c5901f2-e593-48f0-8c42-81b6b67edbcd"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Software

#### `GET /v1/software` — Software breakdown, or one platform detail

**Parameters:**
- `name` (query, optional, string) — A platform for full detail (e.g. mastodon) Example: `mastodon`
- `limit` (query, optional, string) — Max platforms when listing (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fediverse-api/v1/software?name=mastodon&limit=20"
```

**Response:**
```json
{
    "data": {
        "name": "Mastodon",
        "slug": "mastodon",
        "posts": 979907529,
        "users": 8574538,
        "license": "AGPL",
        "website": "https://joinmastodon.org",
        "instances": 9011,
        "description": "Mastodon is an open source decentralized social network - by the people for the people",
        "source_repo": "https://github.com/mastodon/mastodon",
        "top_hosting": [
            {
                "provider": "OVH",
                "instances": 2999
            },
            {
                "provider": "Cloudflare",
                "instances": 1792
            },
            {
                "provider": "Hetzner",
                "instances": 1672
            },
            {
                "provider": "DigitalOcean",
                "instances": 660
            },
            {
                "provider": "Akamai Connected Cloud",
                "instances": 341
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:37.754Z",
        "request_id": "2fc4355b-8f46-4444-85d4-3a8f884ac34b"
    },
    "status": "ok",
    "message": "Software retrieved successfully",
    "success": true
}
```

### Servers

#### `GET /v1/servers` — Largest servers by user count

**Parameters:**
- `software` (query, optional, string) — Filter to one platform Example: `lemmy`
- `limit` (query, optional, string) — Max servers (1-40) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fediverse-api/v1/servers?software=lemmy&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "servers": [
            {
                "rank": 1,
                "posts": 709278,
                "users": 193391,
                "domain": "lemmy.world",
                "version": "0.19.18-8-g5d8cbdd9d",
                "location": {
                    "city": null,
                    "country": null
                },
                "software": "Lemmy",
                "description": null,
                "software_slug": "lemmy",
                "open_registration": true,
                "monthly_active_users": 13284
            },
            {
                "rank": 2,
                "posts": 133985,
                "users": 34340,
                "domain": "sh.itjust.works",
                "version": "0.19.18",
                "location": {
                    "city": null,
                    "country": null
                },
                "software": "Lemmy",
                "description": null,
                "software_slug": "lemmy",
                "open_registration": true,
                "monthly_active_users": 2269
            },
            {
                "rank": 3,
                "posts": 63955,
                "users": 20075,
                "domain": "lemmy.dbzer0.com",
                "version": "0.19.15",
                "location": {
                    "city": null,
                    "country": "France"
                },
                "software": "Lemmy",
                "description
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fediverse-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "FediDB public API (live)",
        "service": "fediverse-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/stats": "Network-wide fediverse totals (instances, users, posts, MAU).",
            "GET /v1/servers": "Largest servers by user count (limit up to 40, optional software= filter).",
            "GET /v1/software": "Software breakdown ranked by users; add name=mastodon for one platform's detail."
        },
        "description": "Live Fediverse statistics from FediDB: network-wide totals (instances, users, posts, monthly active users), the breakdown by software (Mastodon, Misskey, Pixelfed, Lemmy, PeerTube and more — instances, users, license, source repo), and the largest servers ranked by users with an optional software filter. The meta-social layer for the decentralised social web. Live, no key. Distinct from single-platform Mastodon / Misskey / Mbin / Lemmy APIs — this is cross-fediverse statistics.",
        "total_instances": 42812
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:38.257Z",
        "request_id": "dcac35d3-57fe-4778-965e-c74984914eba"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/fediverse-api
OpenAPI spec: https://www.oanor.com/api/fediverse-api/openapi.json