GET

/api/v1/instances

Misskeyサーバーの一覧を取得します。検索、ソート、ページネーションに対応しています。

Query Parameters

Parameter	Type	Default	Description
sort	string	"users"	ソート項目。`users`, `notes`, `createdAt` のいずれか
order	string	"desc"	ソート順。`asc` または `desc`
limit	number	30	取得件数（最大100）
offset	number	0	ページネーションのオフセット
search	string	-	サーバー名で検索（部分一致）

Response

{
  "items": [
    {
      "id": "example.com",
      "node_name": "Example Instance",
      "users_count": 100,
      "notes_count": 10000,
      "created_at": 1704067200000,
      "version": "2024.1.0",
      "is_alive": true,
      "last_updated": 1704153600000,
      "last_check_at": 1704153600000,
      "banner_url": "https://example.com/banner.jpg",
      "icon_url": "https://example.com/icon.png"
    }
  ],
  "total": 500,
  "limit": 30,
  "offset": 0
}

Example

curl "https://servers.misskey.ink/api/v1/instances?sort=users&order=desc&limit=10"