API access for developers
The bedrockinfo.com API reports the live status of Minecraft Bedrock Edition servers (players, version, map, game mode) plus history and uptime. Access requires an x-api-key header; keys have a daily request quota.
Getting a key
- Sign in with your GitHub or Google account on the My keys page.
- Create a key and give it a label (e.g. the name of your app or bot).
- Copy the raw key immediately — it is only shown once.
Each key is limited to a daily request quota. Revoked keys stop working instantly.
Authentication
Send the key in the x-api-key header on every request:
x-api-key: bki_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
| 401 | missing or invalid key |
|---|---|
| 403 | key revoked, or origin not allowed for this key |
| 429 | daily quota exceeded |
Endpoints
GET https://bedrockinfo-api.bedrockinfo.workers.dev/v1/status
GET https://bedrockinfo-api.bedrockinfo.workers.dev/v2/status
| Parameter | Required | Description |
|---|---|---|
server | yes | Server address, optionally with port, e.g. play.example.com:19132 (default port 19132) |
history | no | Days of history to include (v2 only, max 30, default 0) |
Examples
Basic status (v1)
curl -H "x-api-key: YOUR_KEY" \ "https://bedrockinfo-api.bedrockinfo.workers.dev/v1/status?server=play.nethergames.org:19132"
Returns a compact status payload. 404 when the server is offline.
Status + 7-day history (v2)
curl -H "x-api-key: YOUR_KEY" \ "https://bedrockinfo-api.bedrockinfo.workers.dev/v2/status?server=play.nethergames.org:19132&history=7"
Adds a History array of [timestamp, playerCount] samples (-1 = offline) and Uptime %.
Fair use
- Responses may be cached for up to 60 seconds — please cache client-side too.
- The API is rate-limited per key per day; do not share keys.
- This service queries third-party status infrastructure; occasional latency is normal.