Servers by Country

Overview Authentication Endpoints Rate Limiting Examples
GET /servers/countries

Retrieves a list of unique countries where Minecraft servers are located. Results are filtered to only include servers that have been pinged within the last 30 days.

Authentication

None required

Query Parameters

Parameter Type Required Description
country string No Filter by country code or country name. Accepts * as a wildcard for partial matching (e.g., United* to match United States, United Kingdom, etc.)

Example Requests

Get all countries:

GET /api/v0.1/servers/countries

Filter by country name (with wildcard):

GET /api/v0.1/servers/countries?country=United*

Example Response

{
  "unique_countries": 45,
  "countries": [
    {
      "num_servers": 1234,
      "country": "United States",
      "country_code": "US"
    },
    {
      "num_servers": 567,
      "country": "United Kingdom",
      "country_code": "GB"
    },
    {
      "num_servers": 432,
      "country": "Germany",
      "country_code": "DE"
    },
    {
      "num_servers": 389,
      "country": "Canada",
      "country_code": "CA"
    }
  ]
}

Response Fields

Field Type Description
unique_countries integer Total number of unique countries
countries array Array of country objects
countries[].num_servers integer Number of servers in that country
countries[].country string Full country name
countries[].country_code string Two-letter ISO country code