Saltar al contenido

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=azul

Descripció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ónDevuelve
GET /v1/search?q=catanLos 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=50El catálogo, página a página. Pasa el nextCursor que recibiste como cursor para obtener la página siguiente.
GET /v1/healthSi 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/mcp

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