Skip to content

DevelopersMinecraft

Search Minecraft servers

Java and Bedrock servers with filters and sorting, the same as the directory. Player counts are measured by Lobbydex, not reported by owners.

GET/api/v1/minecraft/servers
Bucket search60/min with a key · 10 withoutCached 30 sKey optional

Query parameters

qstring
Words to match in the name, address, description or tags.
editionenum
Only servers with this edition.javabedrock
modesstring
Game mode slugs, comma-separated; a server matches any.
versionstring
A Java version the server must accept, e.g. "1.21.4".
softwarestring
Server software, comma-separated: modded, forge, neoforge, fabric, plugins, proxy.
languagesstring
Two-letter language codes, comma-separated.
onlineenum
Leave out servers that are offline now (default true).01truefalseDefault "true"
claimedenum
Only listings a verified owner manages.01truefalseDefault "false"
crossplayenum
Only servers with both a Java and a Bedrock address.01truefalseDefault "false"
players_mininteger 0–10000000
At least this many players online.
players_maxinteger 0–10000000
At most this many players online.
sortenum
rank, players (now), rising (this week), name, oldest (first seen), busy (usually busy at this hour).rankplayersrisingnameoldestbusyDefault "rank"
limitinteger 1–100
Results per page, 1–100.Default 25
pageinteger 1–200
Page number, from 1.Default 1

Response

200 OK, JSON. Full schema in openapi.json.

totalinteger
pageinteger
limitinteger
serversobject[]13 fields
slugstring
namestring
urlstringThe listing's Lobbydex page. Link to it where you show the data.
iconstring | null
addressstring | nullThe address players type (primary hostname).
editionsenum[]
onlineboolean
playersobject2 fields
onlineinteger
maxinteger | null
versionstring | null
rankinteger | nullLobbydex rank position; null when unranked.
modesstring[]Game mode slugs it advertises (see /api/v1/minecraft/modes).
tagsstring[]Tags its owner picked.
motdstring | null

Errors

invalid_request400

A query or path parameter is missing or out of range.

invalid_key401

The key is malformed, revoked or unknown. Leave it out to use the anonymous allowance.

rate_limited429

Over a bucket or the global limit. Wait retry_after seconds.

internal_error500

Something broke on our side. Retry with backoff.