Minecraft Server
List API
Live Java, Bedrock and cross-play servers as JSON. Try it here, then call it from your bot, launcher or website. No key needed to start.
GET /api/servers?game=mc_java&sort=most_players&limit=5
EvPkRevEvPkRev.minehut.gg · 1.21.112,778/9590 votes
FlameBoundflamebound.minehut.gg · 1.21.11,26.1,26.2,26.1.2,26.1.12,772/9590 votes
LabsLabsMC.net · 1.21.11,1.21.10,1.21.9,1.21.8,1.21.7,1.21.6,1.21.5,1.21.4,1.21.3,1.21.2,1.21.1,1.21,1.20.6,1.20.5,1.20.4,1.20.3,1.20.2,1.20.1,1.20,1.19.4,1.19.3,1.19.2,1.19.1,1.19,1.18.2,1.18.1,1.18,1.17.1,1.17,1.16.5,1.16.4,1.16.3,1.16.2,1.16.1,1.16,1.15.2,1.15.1,1.15,1.14.4,1.14.3,1.14.2,1.14.1,1.14,1.13.2,1.13.1,1.13,1.12.2,1.12.1,1.12,1.11.2,1.11,1.10.2,1.10,1.9.4,1.9.2,1.9,1.8.9,1.8.8,1.8,1.7.10,1.7.9,1.7.8,1.7.7,1.7.6,1.7.5,1.7.4,1.7.22,770/9590 votes
survival133survival133.minehut.gg · 26.22,769/9580 votes
hertzgethertzget.minehut.gg · 26.22,767/9590 votes
Live from anyserver.pro · 104 servers match
Every listing, one request away
The same data that runs the AnyServer list, with nothing held back for the website.
Parameters and fields| Endpoint | Returns |
|---|---|
GET /api/servers | Search and filter the list by edition, version, category, players and keyword. |
GET /api/servers/:id | One server in full: address, versions, live status, votes and screenshots. |
GET /api/servers/:id/widget | A small status payload any website can read from the browser. |
GET /api/config | Every Minecraft version and category the list supports. |
GET /api/stats | Totals, edition and version breakdowns, and the busiest servers. |
fetch("https://anyserver.pro/api/servers/453/widget"){
"id": 453,
"name": "EvPkRev",
"player_count": 2778,
"max_players": 959,
"is_online": 1,
"edition": "Java"
}<script src="https://anyserver.pro/widget/card.js" data-server-id="453"></script>Server status on any website
The widget endpoint answers browsers on any domain, so your server's site can show its own player count without a backend. Prefer no code? One script tag gives you a ready-made card.
Widget docsFree to start, no sign-up
60
requests a minute, no key
2,000 a day, counted per IP address.
120
requests a minute with a free key
10,000 a day to start, tracked in your Developer Portal.
More
for approved developers
300 a minute and 50,000 a day or more, plus full /api/stats access. Tell us what you are building.
Send a key as a Bearer token, or in an X-API-Key header. Every response tells you how much is left, and a request over the limit gets HTTP 429 instead of data.
Authorization: Bearer YOUR_API_KEY
HTTP/1.1 200 OK
X-RateLimit-Limit-Minute: 120
X-RateLimit-Remaining-Minute: 119
X-RateLimit-Limit-Day: 10000
X-RateLimit-Remaining-Day: 9999Questions
Is the AnyServer Minecraft server list API free?
Yes. Every public endpoint is free to use. You can call it without an account, or create a free API key in the Developer Portal to track usage per key.
Do I need an API key to use the API?
No. GET endpoints such as /api/servers and /api/servers/:id work anonymously, limited to 60 requests per minute and 2,000 per day per IP address. Send a key in the Authorization header when you want usage tracked against your account instead of your IP.
What are the API rate limits?
Anonymous requests get 60 requests per minute and 2,000 per day per IP. A new API key starts at 120 requests per minute and 10,000 per day, and approved developers start at 300 per minute and 50,000 per day. Send the key as Authorization: Bearer or X-API-Key. Every response includes X-RateLimit headers, and a request over the limit returns HTTP 429.
Which Minecraft editions does the API cover?
Java Edition, Bedrock Edition and cross-play servers. Filter with the game parameter: mc_java, mc_bedrock or mc_crossplay.
Can I get live player counts and server status?
Yes. Server objects include is_online, player_count, max_players, version and last_updated, refreshed by AnyServer's status checker. You can also embed a ready-made status card or vote button with one script tag.
How do I get higher limits or access to /api/stats?
Create a key in the Developer Portal, then contact the AnyServer team with what you are building. Approved developers get custom quotas and full access to the global statistics endpoint.
Start with one request
Questions on the way? Ask in the AnyServer Discord.