Planet Minecraft APIplanetminecraft.com ↗
Access Planet Minecraft server listings, stats, player counts, and user profiles via 4 structured endpoints. Filter by category, sort order, and keywords.
What is the Planet Minecraft API?
The Planet Minecraft API gives developers structured access to Minecraft server data and user profiles across 4 endpoints. The get_servers endpoint returns paginated server listings with player counts, online status, votes, and engagement stats for both Java and Bedrock categories. get_server_details exposes full server metadata including IP address, game version, MOTD, tags, and description text retrieved by slug.
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 Listings and Search
The get_servers endpoint accepts category (Java or Bedrock), order for sort direction, keywords for name/description filtering, and page for pagination. Each server object in the response includes name, slug, url, players, is_online, and a stats block containing votes, views, diamonds, and favorites. The pagination object reports current_page, total_results, the active category, and order.
Server Detail
Pass a slug from get_servers into get_server_details to retrieve the full record for one server. The response surfaces table_data — a key-value map of structured metadata including Status, Location, Game Version, MOTD, and player capacity — alongside tags, description (full text), online_players as a formatted current/max string, and a stats object with views, votes_this_month, and server_score. The ip field returns the server address when the owner has published it in their description, or null otherwise.
User Profiles and Wall Posts
get_user_profile retrieves a public profile by username and returns level, rank, subscribers, avatar_url, banner_url, about bio text, trophies (array of trophy names), and a profile_id. get_user_wall_posts pages through a user's public wall, returning posts with post_id, author, author_avatar, date, content, content_html, and a permalink. Pages return 20 posts each, and the pagination object includes a has_next flag.
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 discovery tool filtered by Bedrock or Java category and sorted by current player count.
- Monitor a specific server's
online_playersandvotes_this_monthover time to track community growth. - Aggregate
tagsandgame_versionfrom server detail pages to classify servers by type (survival, creative, PvP). - Display Planet Minecraft user profiles — including
level,rank, andsubscribers— on a community leaderboard. - Collect wall post content from user profiles for community sentiment analysis or moderation tools.
- Alert on server IP changes by polling
get_server_detailsand diffing theipfield across runs. - Populate a server comparison widget using
server_score,views, andvotes_this_monthfrom multiple slugs.
| 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 contains the server address when the server owner has published it in their description. If no IP is present in the description, the field returns null. The table_data object may also include a Players and MOTD field depending on what the server owner has configured.Does the API cover Minecraft project listings (skins, mods, texture packs)?+
Can I retrieve comments posted on a server's page?+
How does pagination work across the server listing and wall post endpoints?+
get_servers uses a page integer parameter and returns a pagination object with current_page and total_results. get_user_wall_posts also uses a page parameter but returns 20 posts per page and uses a has_next boolean rather than a total count to indicate whether more pages exist.