MineVote
Login

Developer

API Documentation

Uses the same parameters and protocol as Minecraft-MP. VoteMe, Votifier, and other vote reward plugins work out of the box. Retrieve your server key from the dashboard on the API Keys page.

Base URL

http://minevote.net/api/

Vote Claim Status

Checks if a player has voted in the last 24 hours and whether the vote reward has been claimed.

GET http://minevote.net/api/?object=votes&element=claim&key={ServerKey}&username={Username}
ResponseMeaning
0No vote recorded / found
1Voted, not claimed yet / Successfully claimed
2Voted, already claimed (VoteMe compatibility)

Claim Vote

Marks an unclaimed vote in the last 24 hours as claimed. GET with action=post or POST is supported for Minecraft-MP compatibility.

GET http://minevote.net/api/?action=post&object=votes&element=claim&key={ServerKey}&username={Username}POST http://minevote.net/api/?object=votes&element=claim&key={ServerKey}&username={Username}
ResponseMeaning
0No vote recorded / found
1Voted, not claimed yet / Successfully claimed
2Voted, already claimed (VoteMe compatibility)

Voter List

Top voters by month. Cached ~3 minutes.

GET http://minevote.net/api/?object=servers&element=voters&key={ServerKey}&month=current|previous&format=json|html&limit=100

Recent Votes

Up to 500 recent vote records. Cached ~3 minutes.

GET http://minevote.net/api/?object=servers&element=votes&key={ServerKey}&format=json|html&limit=100

Server Detail

JSON endpoint for server status pages and widgets.

GET http://minevote.net/api/?object=servers&element=detail&key={ServerKey}

Rate Limits & Throttling

To ensure high availability and prevent abuse, all API endpoints are limited to 10 requests per minute per IP address.

VoteMe Configuration Example

minecraft-mp:
  api-key: "YOUR_API_KEY"
  name: "MineVote"
  url: "http://minevote.net/server/SERVER_ID"

The claim endpoint is fully compatible with VoteMe's standard Minecraft-MP protocol workflow.

Manage your API key under Dashboard → API Keys. Regenerating will invalidate any previous key immediately.