/v1/stats
Returns network statistics, updated every 15 minutes using the latest data we collect.
curl -X GET "https://api.fedidb.org/v1/stats"
Everything on FediDB comes from this API. It is public, read only and needs no key.
The base URL is https://api.fedidb.org/v1/. Responses are JSON. Most list endpoints page with a cursor and return at most the number of rows you ask for in limit. Totals are refreshed every 24 hours as each server is crawled.
Need everything at once? Download the weekly datasets instead of paging through the API.
Returns network statistics, updated every 15 minutes using the latest data we collect.
curl -X GET "https://api.fedidb.org/v1/stats"
Returns popular accounts across the fediverse, updated every 24 hours using the latest data we collect.
curl -X GET "https://api.fedidb.org/v1/popular-accounts"
Returns an array of ServerEntity
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | Integer | No | The number of records to return, between 1-40. Default 10. |
curl -X GET "https://api.fedidb.org/v1/servers?limit=10"
Endpoint is not cached. Returns a ServerEntity.
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | string | Yes | The domain name of the server. |
curl -X GET "https://api.fedidb.org/v1/server/domain/mastodon.social"
Returns an array of SoftwareEntity
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | Integer | No | The number of records to return, between 1-40. Default 10. |
curl -X GET "https://api.fedidb.org/v1/software?limit=10"
Endpoint is cached for 15 minutes. Returns a SoftwareEntity.
| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | Yes | The slug identifier for the software. |
curl -X GET "https://api.fedidb.org/v1/software/pixelfed"
A single server, as returned by the server endpoints.
| Attribute | Type | Nullable | Description |
|---|---|---|---|
| id | String | No | The server id |
| domain | String | No | The server domain |
| open_registration | Boolean | Yes | Server allows new account registration |
| description | String | Yes | Description of the server |
| banner_url | String | Yes | URL of server banner image |
| location[city] | String | Yes | The city the server is hosted in |
| location[country] | String | Yes | The country the server is hosted in |
| software[id] | Integer | Yes | The server software id |
| software[name] | String | Yes | The server software name |
| software[url] | String | Yes | The server software FediDB listing URL |
| software[version] | String | Yes | The server software version |
| stats[status_count] | Integer | Yes | The total status count of this server |
| stats[user_count] | Integer | Yes | The total user count of this server |
| stats[monthly_active_users] | Integer | Yes | The monthly active users of the server |
| first_seen_at | String | No | The ISO8601 timestamp of when we first observed the server |
| last_seen_at | String | Yes | The ISO8601 timestamp of when we last observed the server |
A software project, as returned by the software endpoints.
| Attribute | Type | Nullable | Description |
|---|---|---|---|
| id | String | No | The software id |
| name | String | No | The software name |
| url | String | No | The url of the FediDB software listing |
| description | String | Yes | The software description |
| license | String | Yes | The software license |
| instance_count | Integer | No | |
| user_count | Integer | No | |
| monthly_active_users | Integer | Yes | |
| status_count | Integer | No | |
| website | String | Yes | |
| source_repo | String | Yes |
An account from the popular accounts list.
| Attribute | Type | Nullable | Description |
|---|---|---|---|
| id | Integer | No | The account id |
| rank | Integer | No | The account popularity rank |
| username | String | No | The account username |
| name | String | No | The account name |
| domain | String | No | The account server domain |
| account_url | String | No | The url of account |
| avatar_url | String | No | The avatar url of account |
| following_count | Integer | No | The following count of account |
| followers_count | Integer | No | The followers count of account |
| status_count | Integer | No | The status count of account |
| webfinger | String | No | The account webfinger address |
| bio | String | Yes | The account bio |
| account_created_at | String | Yes | ISO 8601 timestamp of account creation |
| last_fetched_at | String | Yes | ISO 8601 timestamp of last account fetch |