Skip to Content
MineSpark API - Servers List Documentation

Servers List API

Access our curated database of popular Minecraft servers categorized by platform and live status.

Endpoints

Java Edition List

Retrieves popular Java Edition servers including player counts and logos.

GET servers.minespark.org/servers/java/

Bedrock Edition List

Retrieves Bedrock and Pocket Edition servers with platform metadata.

GET servers.minespark.org/servers/bedrock/

Response Fields

FieldTypeDescription
namestringThe display name of the server.
ipAddressstringThe hostname used for connection.
platformstringConnection type (e.g., cross-platform).
statusstringCurrent reachability: online / offline.
playersintegerLive player count at last check.
maxPlayersintegerMaximum player capacity.
logostringURL to the server's favicon/icon image.
Note: Lists are cached for performance. For ultra-precise, real-time data on a specific server, use its ipAddress with our Server Status API.

Example Response

[
  {
    "name": "FadeMC [1.20-1.21.10]",
    "ipAddress": "b.fademc.xyz",
    "platform": "cross-platform",
    "status": "online",
    "players": 52744,
    "maxPlayers": 75000,
    "logo": "https://api.mcsrvstat.us/icon/b.fademc.xyz"
  },
  {
    "name": "OPBlocks » Skyblock",
    "ipAddress": "buzz.opblocks.com",
    "platform": "cross-platform",
    "status": "offline",
    "players": 0,
    "maxPlayers": 0,
    "logo": "https://api.mcsrvstat.us/icon/buzz.opblocks.com"
  }
]