Skip to content

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

Example
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.

Full guide
  1. 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. 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. 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.

openapi.json