Servers

Search and list published servers

Returns at most 25 published listings per page and supports pages 1-100. Unknown or repeated query parameters are rejected. Search text may be interpreted as a Minecraft mode or edition. Random results support page 1 only, are not cacheable, and have a tighter request limit. This is not a bulk export endpoint.

get/servers

Request

  • Base URL: https://newminecraftservers.net/api/v1
  • URL: https://newminecraftservers.net/api/v1/servers
  • Auth: none declared

Query parameters

qstring

Search text; blank text is ignored.

family'all' | 'new' | 'cracked'
modestring

A controlled Minecraft game-mode ID, such as survival, skyblock, or bedwars.

edition'java' | 'bedrock'
outcome'online' | 'offline' | 'unknown'
sort'newest' | 'ranked' | 'relevance' | 'random' | 'votes'
pageinteger
limitinteger

Response

A page of published server summaries.

Changes

No recorded changes to this operation across all 1 revision of this API.