planetminecraft.com APIplanetminecraft.com ↗
Access Minecraft server listings from Planet Minecraft. Get server IPs, player counts, versions, tags, and stats for Java and Bedrock servers via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/3edb2b52-0725-4786-ac00-7c8285db44a6/get_servers?page=1&order=order_hot&category=servers' \ -H 'X-API-Key: $PARSE_API_KEY'
List Minecraft servers from Planet Minecraft, supporting Java and Bedrock categories, various sort orders, and search keywords. Returns paginated results with server names, online status, player counts, and basic stats.
| Param | Type | Description |
|---|---|---|
| page | integer | The page number to retrieve. |
| order | string | Sort order: 'order_hot' (Trending), 'order_top' (Top Voted), 'order_new' (New), 'order_views' (Most Viewed). |
| category | string | The category of servers to list: 'servers' for Java, 'bedrock-servers' for Bedrock. |
| keywords | string | Search keywords to filter servers. |
{
"type": "object",
"fields": {
"servers": "array of server objects each containing name, slug, url, players, is_online, and stats",
"pagination": "object containing current_page, category, order, and total_results"
},
"sample": {
"data": {
"servers": [
{
"url": "https://www.planetminecraft.com/server/livia-smp-26-1-2-new-launch-whitelist-proximity-voice-chat/",
"name": "Livia SMP (26.1.2) (Whitelist) (Proximity Voice Chat)",
"slug": "livia-smp-26-1-2-new-launch-whitelist-proximity-voice-chat",
"stats": {
"views": "933",
"votes": "309",
"diamonds": "8",
"favorites": "7"
},
"players": "21/50",
"is_online": true
}
],
"pagination": {
"order": "order_hot",
"category": "servers",
"current_page": 1,
"total_results": 25
}
},
"status": "success"
}
}About the planetminecraft.com API
The Planet Minecraft API provides access to thousands of Minecraft server listings across Java and Bedrock categories via 2 endpoints. Use get_servers to search and paginate server lists with filtering by sort order and keywords, and get_server_details to retrieve a specific server's IP address, game version, online player count, tags, and full description by slug.
Listing and Searching Servers
The get_servers endpoint returns paginated arrays of server objects from Planet Minecraft. Each object includes name, slug, url, players, is_online, and a stats object. You can filter by category (servers for Java, bedrock-servers for Bedrock), sort using the order parameter (order_hot for trending, order_top for top-voted, order_new for newest, order_views for most viewed), and narrow results with a keywords search string. The pagination object in the response provides current_page, total_results, and the active category and order values so you can walk through result pages programmatically.
Server Detail Data
The get_server_details endpoint accepts a slug (obtainable from get_servers results) and returns a detailed record for a single server. Key fields include ip (the server address, or null if not listed), name, tags (an array of category/feature strings), online_players (formatted as current/max, e.g. 21/50), and a full description string. The table_data object surfaces structured metadata from the server info panel — fields like Status, Location, Game Version, MOTD, and Players — which varies per server depending on what the listing owner has filled in. The stats object includes views, votes_this_month, and server_score.
Coverage and Scope
Both endpoints cover servers listed publicly on Planet Minecraft. Java and Bedrock servers are separated by the category parameter in get_servers. Server slugs are stable URL identifiers (e.g. hypixel) and serve as the join key between the list and detail endpoints. Not all servers will have every table_data field populated — availability depends on what each server owner has configured in their listing.
- Build a Minecraft server browser that surfaces trending Java servers using the
order_hotsort order. - Monitor player counts across a curated list of servers by polling
online_playersfromget_server_details. - Aggregate top-voted Bedrock servers by combining the
order_topsort withcategory=bedrock-servers. - Extract server IPs and game versions from
table_datato auto-populate a server connection manager. - Track vote momentum over time by collecting
votes_this_monthandserver_scorefrom thestatsobject. - Index server tags from
get_server_detailsto build a searchable directory filtered by Minecraft features or game modes. - Identify newly listed servers using
order_newto feature fresh additions in a community newsletter.
| 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 Planet Minecraft have an official developer API?+
What does `get_server_details` return that `get_servers` does not?+
get_server_details returns fields not present in list results: the server ip address, tags array, full description text, structured table_data (Status, Location, Game Version, MOTD, Players), and the votes_this_month and server_score stats. The list endpoint returns only name, slug, url, is_online, players, and summary stats.Can I retrieve a server's player history or vote history over time?+
online_players count and votes_this_month as point-in-time values; no historical time-series data is exposed. You can fork this API on Parse and revise it to add a scheduled polling endpoint that stores snapshots over time.Are there limitations on which servers appear in results?+
ip field can be null if a server owner has not published their address in the listing.