MineVote
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
1Voted, not claimed yet
2Voted, already claimed

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 found
1Successfully claimed
2Already 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.

Exceeding this threshold returns HTTP 429 Too Many Requests along with standard headers:

  • X-RateLimit-Limit: Max allowed requests per window (10)
  • X-RateLimit-Remaining: Remaining requests in current window
  • X-RateLimit-Reset: UTC timestamp (seconds) when window resets
  • Retry-After: Number of seconds to wait before retrying

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.