Planet Minecraft APIplanetminecraft.com ↗
Access Planet Minecraft server listings, project maps, and user profiles via API. Filter by Java/Bedrock, sort order, tags, and more. 6 endpoints.
What is the Planet Minecraft API?
The Planet Minecraft API exposes 6 endpoints covering Minecraft server listings, community project maps, and user profiles from planetminecraft.com. The get_servers endpoint returns paginated server results including player counts, online status, votes, and engagement stats for both Java and Bedrock categories. Companion endpoints retrieve full server details by slug, project listings with tag and edition filters, project detail pages, user profile data, and wall posts.
curl -X GET 'https://api.parse.bot/scraper/3edb2b52-0725-4786-ac00-7c8285db44a6/get_servers?page=1&order=order_hot&category=servers&keywords=survival' \ -H 'X-API-Key: $PARSE_API_KEY'
List Minecraft servers from Planet Minecraft. Supports Java and Bedrock categories, multiple sort orders, keyword search, and pagination. Each result includes server name, online status, player count, and basic engagement stats (votes, views, diamonds, favorites). Pagination is page-number based.
| Param | Type | Description |
|---|---|---|
| page | integer | The page number to retrieve. |
| order | string | Sort order for the server listing. |
| category | string | The category of servers to list. |
| keywords | string | Search keywords to filter servers by name or description. |
{
"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/pupland-friendly-smp-no-pvp-pup-play-in-testing/",
"name": "PupLand | Friendly SMP",
"slug": "pupland-friendly-smp-no-pvp-pup-play-in-testing",
"stats": {
"views": "163",
"votes": "5",
"diamonds": "3",
"favorites": "3"
},
"players": "2/1000",
"is_online": true
}
],
"pagination": {
"order": "order_hot",
"category": "servers",
"current_page": 1,
"total_results": 25
}
},
"status": "success"
}
}About the Planet Minecraft API
Server Data
get_servers lists Minecraft servers with support for category (Java or Bedrock), order (sort by votes, views, new, etc.), keywords for name/description search, and page for pagination. Each result object includes name, slug, url, players, is_online, and a stats block with votes, views, diamonds, and favorites. The pagination object reports current_page, total_results, the active category, and order. To fetch a full server record, pass the slug from those results to get_server_details, which returns ip (when published by the server owner), description, tags, table_data (a key-value map of Status, Location, Game Version, MOTD, Players, and similar fields), online_players, and a stats block with views, votes_this_month, and server_score.
Project Maps
get_projects lists community-submitted maps with rich filtering: order accepts site sort tabs such as order_hot (Trending), order_updated, order_new, and order_top; edition accepts '1' for Java and '2' for Bedrock; tag narrows results to a specific tag slug; category filters by project type; and time_range limits results to windows from last24h through all_time. The response includes a heading string naming the active filters, a projects array of card objects (id, title, slug, url, category, thumbnail, author, stats), and a pagination object with has_next and card count. get_project_details takes a slug and returns the full page record: info key-value pairs (Progress, Credit, etc.), tags, stats with exact views and downloads integers alongside display strings, author, category, progress, and full plain-text description.
User Profiles and Wall Posts
get_user_profile retrieves a public member page by username (case-insensitive) and returns level, rank, about bio text, trophies array, avatar_url, banner_url, post_cards (custom profile cards with both plain-text content and content_html), subscriber_count, and the internal profile_id. get_user_wall_posts paginates wall posts at 20 per page, returning each post's post_id, author, author_avatar, date (ISO timestamp), date_display, content, content_html, and permalink.
The Planet Minecraft API is a managed, monitored endpoint for planetminecraft.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when planetminecraft.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official planetminecraft.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Minecraft server finder that filters Java vs. Bedrock servers by player count and vote rank using
get_serverswithcategoryandorderparams. - Track server popularity over time by polling
get_server_detailsforvotes_this_month,views, andserver_scoreon a set of slugs. - Aggregate trending Bedrock maps by combining
get_projectswithedition='2'andorder=order_hot, then fetchingdownloadscounts viaget_project_details. - Index community map metadata by tag — e.g. all 'castle' maps — using
get_projectswith thetagparam and iterating pages. - Display a player's public Planet Minecraft presence by combining profile fields (level, rank, trophies) from
get_user_profilewith recent wall activity fromget_user_wall_posts. - Monitor new server additions in a specific category by polling
get_serverswithorder=newand comparing against a stored snapshot. - Compile an author's full catalog by searching
get_projectswithkeywordsset to an author name and reading per-projectstats.downloadsfor each result.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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 for the server IP address?+
ip field is extracted from the server's description text when the owner has published it there. If the owner has not included an IP in their description, the field returns null. The table_data object may also contain connection details when the server's info table includes them.Can I retrieve comments on projects or servers?+
get_project_details, and server details via get_server_details, but comment threads are not exposed. You can fork this API on Parse and revise it to add a comments endpoint for either resource type.How does pagination work across the listing endpoints?+
get_servers and get_user_wall_posts use integer page parameters and return a pagination object. For get_servers, pagination includes total_results. For get_user_wall_posts, pagination reports current_page and has_next (boolean). get_projects similarly returns current_page, has_next, and a count of cards on the current page — approximately 25–28 per page.