Desarrolladores y agentes: API de BOOM Stand-Up Bar
BOOM Stand-Up Bar expone una API pública de solo lectura sobre su cartelera de stand up comedy en Colombia y México. No requiere autenticación ni clave. Los endpoints privados de la app móvil y del panel de administración no son públicos y no se documentan aquí.
Recursos
- OpenAPI 3.1 (/openapi.json): especificación completa con operationId, parámetros tipados y esquemas de respuesta, lista para function calling.
- llms.txt: resumen del sitio para modelos de lenguaje, con la sección «Cuándo usar BOOM Stand-Up Bar».
- Sitemap: todas las URLs públicas.
Autenticación
Ninguna. Los endpoints de esta página son públicos y se cachean una hora. No hay límite de uso publicado; si vas a hacer más de unas pocas peticiones por minuto, escríbenos a contacto@boomstandupbar.com.
Endpoints
GET /api/public/events
Próximos shows de stand up comedy publicados: título, fecha en ISO 8601, ciudad, país, comediantes, tipo de acceso y URL de la página del evento. Sin autenticación, cache de una hora.
curl -s "https://boomstandupbar.com/api/public/events?city=bogota&limit=5"
GET /api/public/cities
Ciudades con shows próximos, con su slug para filtrar eventos y la URL de su landing.
curl -s "https://boomstandupbar.com/api/public/cities"
GET /api/racha/top-users
Ranking público de miembros por puntos de racha (asistencia a shows). Parámetro limit entre 1 y 100.
curl -s "https://boomstandupbar.com/api/racha/top-users?limit=10"
GET /llms.txt
Resumen del sitio para modelos de lenguaje: qué es BOOM, cuándo usarlo, cartelera actual, comediantes, ciudades y enlaces clave.
curl -s "https://boomstandupbar.com/llms.txt"
GET /md/{ruta}
Versión markdown de cualquier página pública. También se obtiene pidiendo la URL normal con la cabecera Accept: text/markdown.
curl -s -H "Accept: text/markdown" "https://boomstandupbar.com/stand-up-comedy/bogota"
GET /openapi.json
Especificación OpenAPI 3.1 de esta API pública, con operationId, parámetros tipados y esquemas de respuesta.
curl -s "https://boomstandupbar.com/openapi.json"
Errores
Toda ruta bajo /api responde JSON, también cuando falla. Una ruta inexistente devuelve 404 con este formato; un parámetro inválido devuelve 400 con el mismo esquema.
{
"error": {
"code": "not_found",
"message": "No existe la ruta /api/foo.",
"hint": "La API pública está descrita en /openapi.json.",
"docs": "https://boomstandupbar.com/developers"
}
}
Páginas en markdown
Cualquier página pública se sirve en markdown pidiéndola con la cabecera Accept: text/markdown (la respuesta lleva Content-Type: text/markdown y Vary: Accept) o bajo /md/{ruta}. Una ruta inexistente devuelve un 404 en markdown con enlaces para recuperarse.
¿Algo no funciona o necesitas otro dato? Contáctanos.