Public Vote API - CraftedServerlist

GET

Server vote leaderboard

Returns total votes, unique voters, and the top voters for one server. No login or API key is required.

https://craftedserverlist.net/api/v1/servers/{server-slug}/votes

Your server slug is the final part of its CSL URL, such as normal_survival in /servers/normal_survival.

Query Parameters

Parameter	Required	Description
`from`	No	First date to include, formatted as `YYYY-MM-DD`.
`to`	No	Last date to include, formatted as `YYYY-MM-DD`.
`limit`	No	Number of leaderboard users. Defaults to 10; maximum 30.

Leave both dates empty to retrieve an all-time leaderboard.

Example Request

GET /api/v1/servers/normal_survival/votes?from=2026-10-01&to=2026-10-31&limit=20

JavaScript

fetch('https://craftedserverlist.net/api/v1/servers/normal_survival/votes?limit=10')
  .then(response => response.json())
  .then(data => {
    data.leaderboard.forEach(player => {
      console.log(`#${player.rank} ${player.username}: ${player.votes} votes`);
    });
  });

Example Response

{
  "server": {
    "id": 42,
    "slug": "normal_survival",
    "name": "Normal Survival"
  },
  "period": {
    "from": null,
    "to": null,
    "timezone": "UTC"
  },
  "totals": {
    "votes": 1250,
    "unique_voters": 184
  },
  "leaderboard": [
    {
      "rank": 1,
      "username": "PlayerOne",
      "votes": 42,
      "last_vote_at": "2026-10-10T18:42:00Z"
    }
  ],
  "meta": {
    "limit": 10,
    "generated_at": "2026-10-10T20:00:00+00:00"
  }
}