minecraftservers.org APIminecraftservers.org ↗
Access Minecraft server listings, real-time player counts, uptime stats, and historical data from minecraftservers.org via 3 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/bb77c61d-ba0a-42c2-9c34-a3e2f8e97e59/search_servers?query=survival' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Minecraft servers by name or keyword. Returns a list of matching servers with basic info including player counts and status.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword to find servers (e.g. 'survival', 'hypixel', 'skyblock'). |
{
"type": "object",
"fields": {
"query": "string — the search term used",
"results": "array of server objects with id, name, ip, status, current_players, url"
},
"sample": {
"data": {
"query": "survival",
"results": [
{
"id": "594028",
"ip": "hub.fadecloud.com",
"url": "https://minecraftservers.org/server/594028",
"name": "FadeCloud",
"status": "online",
"current_players": "5514/5614"
}
]
},
"status": "success"
}
}About the minecraftservers.org API
The minecraftservers.org API exposes 3 endpoints for searching, listing, and inspecting Minecraft servers, returning fields like current player counts, server IP, uptime percentage, and historical vote and player data. The get_server_details endpoint goes deepest, providing per-server stats arrays covering player history, vote history, and daily stats alongside owner, country, and Java edition IP.
What the API Returns
The API covers the minecraftservers.org directory, which indexes thousands of community-run Minecraft servers. All three endpoints return server objects with id, name, ip, status, and current_players. The search_servers endpoint accepts a query string — keywords like survival, skyblock, or a specific server name — and returns matching servers as an array. The list_servers endpoint paginates the top servers ranked by popularity, returning up to 20 results per page along with a pagination array of labeled page links.
Server Details and Historical Stats
The get_server_details endpoint takes a numeric server_id (obtained from search_servers or list_servers) and returns a richer payload. Beyond basic status, it includes uptime as a percentage string, votes as a total integer, country, java_ip, and a players field formatted as current/max (e.g. 4389/4500). The nested stats object contains three arrays — player_history, vote_history, and daily_stats — allowing trend analysis over time for a given server.
Pagination and IDs
Pagination on list_servers is controlled by the optional page integer parameter, and the response includes a pagination array so you can discover adjacent pages programmatically. Server IDs are numeric strings that remain stable across requests, making them reliable keys for repeated detail lookups or building a local index.
- Monitor real-time player counts across top-ranked servers using
list_serversand thecurrent_playersfield - Track a specific server's popularity trend over time using the
player_historyarray fromget_server_details - Build a server recommendation tool by searching for keyword-matched servers via
search_servers - Compare uptime reliability across servers using the
uptimepercentage field from detail responses - Aggregate vote totals and vote history to identify trending or fast-growing Minecraft communities
- Display server capacity status by parsing the
playerscurrent/max string fromget_server_details - Compile a country-segmented directory of Minecraft servers using the
countryfield in detail responses
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does minecraftservers.org have an official developer API?+
What does `get_server_details` return that `list_servers` does not?+
get_server_details returns fields not present in list results: owner, country, java_ip, votes, uptime, the formatted players capacity string, and the stats object containing player_history, vote_history, and daily_stats arrays. The list endpoints return only id, name, ip, status, current_players, and url.Can I filter `list_servers` by game mode, version, or region?+
list_servers accepts only a page integer and returns servers ranked by overall popularity. search_servers accepts a keyword query, which can be a game-mode term like skyblock or creative, but neither endpoint supports structured filters for Minecraft version or server region. You can fork this API on Parse and revise it to add filtered listing endpoints.How granular is the historical data in the `stats` object?+
stats object in get_server_details returns three arrays — player_history, vote_history, and daily_stats — reflecting the time-series data shown on the server's minecraftservers.org detail page. The resolution and retention window of those arrays mirrors what the site exposes for each server and may vary by server age or activity.Does the API return Bedrock edition connection details?+
get_server_details response includes a java_ip field but does not currently expose a separate Bedrock edition IP or port. Coverage is limited to the Java edition connection address and the general fields listed above. You can fork this API on Parse and revise it to surface Bedrock-specific fields if the source page exposes them.