Usar la API
La API es gratuita y de solo lectura. No hay clave ni registro. Todas las respuestas son JSON.
curl https://api.thebgdb.org/v1/search?q=azulDescripción OpenAPI
La descripción completa, legible por máquinas, de cada ruta, parámetro y respuesta se publica con cada versión en api.thebgdb.org/v1/openapi.json. Cárgala en cualquier herramienta OpenAPI para explorar la API o generar un cliente. También cubre las cuentas, las fotos y las listas.
La misma descripción se puede leer como página: la referencia de la API.
Las peticiones principales
| Petición | Devuelve |
|---|---|
GET /v1/search?q=catan | Los juegos cuyo nombre contiene todas las palabras de q. No distingue mayúsculas ni acentos; no corrige erratas. q necesita al menos dos caracteres. |
GET /v1/games/{id} | Un juego, por el id que lleva cada objeto de juego: descripción, jugadores, duración, créditos y fotos. |
GET /v1/games?limit=50 | El catálogo, página a página. Pasa el nextCursor que recibiste como cursor para obtener la página siguiente. |
GET /v1/health | Si la API está en funcionamiento. |
Conectar un asistente de IA (MCP)
Los asistentes que usan el Model Context Protocol pueden consultar el catálogo directamente. Añade esta dirección de servidor a tu asistente:
https://mcp.thebgdb.org/mcpNo requiere iniciar sesión. Para que un asistente pueda ver y editar tus listas, usa https://mcp.thebgdb.org/member en su lugar: antes te pide que inicies sesión y des tu aprobación. Un token de la API de la página de tu cuenta también funciona con la primera dirección.
Límites
Sin token: 300 peticiones por minuto por dirección. Con un token de la API de la página de tu cuenta: 1200 por minuto, o 6000 con el plan de pago. Si superas el límite, la API responde 429; espera un minuto y continúa. Las respuestas se guardan en caché hasta cinco minutos, así que un cambio puede tardar ese tiempo en verse.