API V1 · STABLE
Build with live server data
Minecraft servers, Discord servers and bots, checked by us every 1–2 minutes from five regions. Query it over REST, plug it into an AI assistant over MCP, or drop a live badge on your site.
No key needed to tryJSON · open CORSOpenAPI 3.1 spec
curl "https://lobbydex.com/api/v1/minecraft/servers?modes=skyblock&sort=players&limit=1" \
-H "Authorization: Bearer $LOBBYDEX_KEY"// 200 OK · illustrative values
{
"total": 412,
"servers": [{
"slug": "example-network",
"address": "play.example.net",
"online": true,
"players": { "online": 1234, "max": 5000 },
"version": "1.8–1.21.4"
}]
}Pick what you're building
Every product reads the same measured data. Start with the one that fits.
Quick start
Three steps from nothing to a keyed request.
- 1
Try it, no key
Every endpoint is a GET under /api/v1. Without a key you get the per-IP allowance.
curl lobbydex.com/api/v1/stats - 2
Make a key
Sign in with Discord and create one. It's shown once; we keep only a hash.
# lobbydex.com/developers/keys ldx_•••••••••••••••• - 3
Send it
Higher limits per key. Bearer, Bot and X-API-Key headers all work.
curl -H "Authorization: Bearer ldx_…" \ lobbydex.com/api/v1/stats
Every endpoint
Grouped by what they're about. New groups slot in here as the API grows.
Minecraft
GET/minecraft/serversSearch Minecraft serverssearchGET/minecraft/servers/{slug}Get a Minecraft serveritemGET/minecraft/servers/{slug}/historyA Minecraft server's player historyhistoryGET/minecraft/servers/{slug}/eventsA Minecraft server's changes and downtimeitemDiscord servers
GET/discord/serversSearch Discord serverssearchGET/discord/servers/{slug}Get a Discord serveritemGET/discord/servers/{slug}/historyA Discord server's members online over timehistoryRate limits per minute
Per key, or per IP without one. Works like Discord's buckets.
| Bucket | Key | No key |
|---|---|---|
| search | 60 | 10 |
| item | 180 | 20 |
| history | 60 | 10 |
| meta | 60 | 20 |
| lookup | 30 | 5 |
| global | 300 | 30 |
Every response carries X-RateLimit-* headers. Over a limit: 429 with retry_after. Rate limits