Añadir servidor
ServidoresNuevosEstadísticasGuíasAñadir servidorPreguntas
English

API pública de servidores de Minecraft

Datos de estado de servidores de Minecraft, gratis y sin clave. Úsalos en un bot de Discord, una página de estado, una hoja de cálculo o un script de investigación. Todos los endpoints son anónimos, aceptan CORS y van por HTTPS.

Antes de empezar

  • Gratis y sin clave. No hay registro, ni API key, ni obligación de atribución — aunque se agradece un enlace.
  • Solo lectura. Todo lo documentado aquí es GET; las escrituras (votos, reclamaciones, boosts) necesitan sesión y no forman parte de la API pública.
  • Sé amable: los endpoints del catálogo se cachean de 15 a 30 segundos y tienen un límite de 60 peticiones por minuto por IP. Cachea en tu lado y no consultes más de una vez por minuto.
  • Las lecturas entre orígenes están permitidas desde cualquier origen, así que puedes llamarla directamente desde JavaScript del navegador.
  • `checked_at` es la última vez que hicimos ping al servidor. Un servidor que lleva tiempo sin responder se devuelve con `online: false` en vez de omitirse.

Endpoints

GET /api/servers

El catálogo de servidores, paginado y filtrable. Empieza por aquí.

page integer, default 1
limit integer 1–500, default 12
tags comma-separated tag slugs, AND logic
exclude_tags comma-separated tag slugs, NOT logic
version version substring, e.g. 1.21
min_players integer
max_players integer
search name, IP or description substring
sort default | players | votes | newest | copies
https://www.mc-monitor.app/api/servers?limit=2&sort=players
GET /api/servers/{slug}

Un servidor, con descripción, etiquetas, contactos, redes, votos y su último estado.

slug the server identifier, e.g. hypixel.net
https://www.mc-monitor.app/api/servers/hypixel.net
GET /api/servers/{slug}/widget

La carga compacta que hay detrás de la insignia: nombre, jugadores, versión y disponibilidad.

slug the server identifier
https://www.mc-monitor.app/api/servers/hypixel.net/widget
GET /api/servers/{slug}/badge

Devuelve una insignia PNG plana (28px de alto, apta para READMEs) en vez de JSON. Útil donde un iframe no se renderiza.

slug the server identifier
theme dark (default) | light
https://www.mc-monitor.app/api/servers/hypixel.net/badge?theme=dark
GET /api/servers/{slug}/history

Historial de jugadores de un servidor en las últimas 24 horas, 7 días o 30 días.

slug the server identifier
period 24h | 7d | 30d, default 24h
https://www.mc-monitor.app/api/servers/hypixel.net/history?period=24h
GET /api/stats

Totales del catálogo: cuántos servidores rastreamos y cuántos jugadores hay en línea ahora.

https://www.mc-monitor.app/api/stats
GET /api/tags

Las etiquetas de juego que usan los filtros, con sus slugs.

https://www.mc-monitor.app/api/tags

Ejemplo

curl "https://www.mc-monitor.app/api/servers?limit=2&sort=players"
{ "servers": [ { "id": 20724, "name": "Vanilla Hardcore", "identifier": "mhc.serveminecraft.net", "ip": "mhc.serveminecraft.net", "online": true, "players_online": 38800, "players_max": 50000, "version": "26.3", "vote_count": 0, "checked_at": "2026-10-23T15:47:13.362338+00:00", "tags": ["hardcore"] }, { "id": 2764, "name": "DonutSMP", "identifier": "donutsmp.net", "ip": "donutsmp.com", "online": true, "players_online": 32229, "players_max": 50000, "version": "1.7.2-26.1", "vote_count": 16, "checked_at": "2026-10-23T15:53:52.808772+00:00", "tags": ["smp", "survival", "anarchy", "vanilla", "economy"] } ], "total": 6850, "page": 1, "limit": 2, "pages": 3425 }

¿Prefieres no construirlo tú?

La insignia de la página de tu servidor son los mismos datos, ya renderizados. Pega un iframe en tu web y se mantiene actualizado solo.

Ver la insignia Lista tu servidor