# Mastodon Server Directory API

> Mastodon: official server directory by language and category, with user counts and network stats

- Vendor: `mastodonserverdirectoryapi` · version 1.0 · category Social · tags mastodon api, fediverse servers api, mastodon instances api, decentralized social api, social network stats api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/mastodonserverdirectoryapi
- This document: https://apiclay.com/docs/mastodonserverdirectoryapi.md
- OpenAPI 3.1: https://apiclay.com/api/mastodonserverdirectoryapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `mastodonserverdirectoryapi`
- Updated: 2026-11-18

## About

## Mastodon Server Directory API

The public directory API behind joinmastodon.org: the Mastodon servers that meet the project's server covenant, filterable by language, category and region, each with domain, version, description, languages, categories, total and last-week active users, sign-up approval and thumbnail; and the daily totals of servers, users and active users across the Mastodon network.

Data comes from **joinmastodon.org** (https://joinmastodon.org). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/servers?language=en&amp;category=general`, `/statistics`.

### Routes

#### GET `/servers` - Servers
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| language | query | string | no | Language code, e.g. `en`, `de`, `ja`. |
| category | query | string | no | e.g. `general`, `tech`, `art`, `music`, `regional`, `academia`, `games`. |
| region | query | string | no | e.g. `europe`, `north_america`, `asia`. |
| ownership | query | string | no | `juridicial` or `natural`. |
| registrations | query | string | no | `instant` or `manual`. |

Returns: Array: `domain`, `version`, `description`, `languages`, `region`, `categories`, `proxied_thumbnail`, `total_users`, `last_week_users`, `approval_required`, `language`, `category`.

#### GET `/statistics` - Statistics
No parameters.

Returns: Array of days: `period`, `server_count`, `user_count`, `active_user_count`.

### Caveats

- Lists only servers in the joinmastodon.org directory, not every Mastodon server.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by joinmastodon.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /servers — Servers
- Gateway: `GET https://api.apiclay.com/v1/api/mastodonserverdirectoryapi/servers`
- Public query params: `language` (string), `category` (string), `region` (string), `ownership` (string), `registrations` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /statistics — Statistics
- Gateway: `GET https://api.apiclay.com/v1/api/mastodonserverdirectoryapi/statistics`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/mastodonserverdirectoryapi/servers" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
