Server data endpoints
These endpoints are public and need no key. Use them to show your live player count, rank and votes on your own website, in a Discord bot or in a launcher.
One server
GET https://craftrank.org/api/v1/servers/{id}
Returns everything we know about a live server. Servers that are not approved or were removed answer 404. The main fields:
name, address, host, port | Name and how to join |
edition, crossplay, bedrock_port | java or bedrock, and whether Bedrock players can join a Java server |
online, players | Live status; players has online, max and peak |
version, motd, tags, language | Version, message of the day as plain text, game modes, language code |
premium_required, modded | Whether a paid account is needed, and the mod loader and mod count (null when unknown) |
rank, votes | Current rank, and votes.month and votes.total |
uptime, last_checked | Uptime in percent, time of the last check |
url, vote_url, badge_url, banner | Links to the server page, vote page, vote badge and banner image |
website, discord, sponsored | Owner links, and whether the server has a sponsored spot right now |
awards | Hall of fame places: period, place, votes |
The ranking
GET https://craftrank.org/api/v1/top?limit=10&tag=survival&edition=java&language=en
The current ranking, in the same order as the home page, as {"servers": [...]} with the same fields as above (without awards). All parameters are optional:
limit: 1 to 50, default 10.tag: a game mode, for examplesurvivalorskyblock.edition:java, orbedrock(which includes Java servers that Bedrock players can join).language: a language code such asen,trorde.
List totals
GET https://craftrank.org/api/v1/stats
Live totals for the whole list: servers listed and online (also by edition and crossplay), players online, votes this month, the biggest game modes and the languages. Player counts that look faked are left out of players_online.
Monthly winners
GET https://craftrank.org/api/v1/awards?period=2026-09
The top three servers by votes for a month, as winners with place, server_id, name and votes. Without period you get the latest month. The same data is in the Hall of fame.