API

We've got a full rich set of endpoints for receiving MCTracker data for completely free of charge

Get Servers List

GET https://mctracker.ir/api/servers

This endpoint allows you to get a complete list of all servers with their id's that would be useful when using other API's.

200 Servers are successfully retrieved.

[
  {
    "id": 1,
    "name": "MadCraft"
  },
  {
    "id": 10,
    "name": "TrexMine"
  }
]

Get Specific Server Data

GET https://mctracker.ir/api/server/:server_id:

This endpoint allows you to get full updated information about specified server

Path Parameters

Name	Type	Description
server_id	number	Server ID [Can be found in website URL in server pages or the endpoint above]

200 Response: https://mctracker.ir/api/server/1

{
  "id": 1,
  "name": "MadCraft",
  "description": "قدیمی ترین سرور و مرجع ماینکرافت ایران از سال 1392",
  "address": "Hub.MadCraft.iR",
  "ip": "185.105.237.201",
  "country": "IR",
  "latest_version": "MadCord 1.8.x-1.17.x",
  "latest_latency": 1,
  "current_players": 166,
  "max_players": 500,
  "up_from": 1631348823
}

Get Server Last 24h Votes

GET https://mctracker.ir/api/server/:server_id:/votes

This endpoint allows you to get a full list of usernames that voted within 24 hours ago to the specified server

Path Parameters

Name	Type	Description
server_id	number	Server ID [Can be found in website URL in server pages or the endpoint above]

200 Response: https://mctracker.ir/api/server/1/votes

[
  {
    "id": 215,
    "username": "Alijk",
    "voted_at": 1631550693,
    "total_votes": 2
  },
  {
    "id": 216,
    "username": "Cipher",
    "voted_at": 1631553764,
    "total_votes": 1
  },
  {
    "id": 217,
    "username": "Dead_Light",
    "voted_at": 1631576779,
    "total_votes": 1
  },
  {
    "id": 218,
    "username": "Babaei",
    "voted_at": 1631588500,
    "total_votes": 6
  },
]