GET

/api/v1/instances

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

Query Parameters

Parameter	Type	Default	Description
sort	string	"users"	ソート項目。`users`, `notes`, `createdAt`, `recommended`, `repository` のいずれか
language	string	なし	言語コード (ISO 639-1)。自動検出のため、実際の主要言語と異なる場合があります。
order	string	"desc"	ソート順。`asc` または `desc`
limit	number	30	取得件数 (最大100)
offset	number	0	ページネーションのオフセット
search	string	-	サーバー名で検索 (部分一致)
repository	string	-	リポジトリURL (完全一致)

Response

{
  "items": [
    {
      "host": "example.com",
      "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",
      "language": "ja"
    }
  ],
  "total": 500,
  "limit": 30,
  "offset": 0
}

Example

cURL

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