API Reference

Explore the Fediverse programmatically. All endpoints return JSON and require no authentication for read access.

Base URL:https://api.fedisea.surf

Auth

None required

Format

JSON

Instances

2 endpoints

List all known Fediverse instances with pagination and filtering.

Parameters

pageintegerPage number (default: 1)

sizeintegerResults per page (default: 20, max: 100)

softwarestringFilter by software (e.g. mastodon, lemmy)

searchstringSearch for instance name

sortstringSort by: users, activeUsersMonth, activeUsersHalfyear, posts, softwareVersion, name

orderstringasc or desc (default: desc)

Response

200 OK — application/json

{
  "data": [
    {
      "domain": "mastodon.social",
      "title": "Mastodon",
      "description": "The original server operated by the Mastodon gGmbH non-profit",
      "sourceUrl": "https://github.com/mastodon/mastodon",
      "thumbnail": "https://files.mastodon.social/site_uploads/files/000/000/001/@1x/57c12f441d083cde.png",
      "software": "mastodon",
      "version": "4.6.0-nightly.2026-03-05",
      "openRegistration": true,
      "totalUsers": 3170635,
      "activeUsersMonth": 301031,
      "activeUsersHalfyear": 712642,
      "localPosts": 167545501,
      "localComments": null,
      "softwareLogoUrl": "https://assets.fedisea.surf/logos/mastodon.svg"
    }
  ],
  "currentPage": 0,
  "totalPages": 33589,
  "totalItems": 33589,
  "pageSize": 1,
  "hasNext": true,
  "hasPrevious": false
}