Public endpoints, no authentication, JSON responses. Please stay under one request per second β responses are cached server-side.
Server statistics: votes this month, total, rank, players online.
GET https://topmoddedservers.com/api/v1/servers/votre-serveur
{
"slug": "votre-serveur",
"name": "Votre Serveur",
"version": "1.20.1",
"loader": "neoforge",
"online": true,
"playersOnline": 42,
"playersMax": 100,
"votesMonth": 830,
"votesTotal": 12408,
"rank": 3,
"monthStart": 1785535200,
"votePageUrl": "https://topmoddedservers.com/serveur/votre-serveur/vote"
}
Verification by username: a player's votes this month and over the last 24 h for your server β ideal to catch up on a missed vote (server offline when it happened) or validate a reward plugin-side.
GET https://topmoddedservers.com/api/v1/servers/votre-serveur/voters/Steve_2024
{
"username": "Steve_2024",
"votesMonth": 22,
"votes24h": 1,
"lastVoteAt": 1786929671,
"votedLast24h": true,
"monthStart": 1785535200
}
Your server's top voters of the month: perfect for an end-of-month reward (counters reset on the 1st).
GET https://topmoddedservers.com/api/v1/servers/votre-serveur/top-voters
{
"monthStart": 1785535200,
"voters": [
{ "username": "Steve_2024", "votes": 27, "lastVoteAt": 1786929671 },
{ "username": "Alex_Craft", "votes": 25, "lastVoteAt": 1786901234 }
]
}
lastVoteAt and monthStart are UNIX timestamps in seconds.