Endpoints
GET /api/v1/search?q=Busque eventos, destinos, circuitos, meses y categorías (máx. 10).
GET /api/v1/events/{slug}Un evento completo, con cada edición fechada, su estado, nota y fuente.
GET /api/v1/events?category=&destination=&circuit=&month=Listado acotado: 20 por llamada; desplazamiento ≤ 100 sin clave.
GET /api/v1/calendar?from=&to=Ediciones fechadas en una ventana de como máximo 62 días; filtra por categoría, región, destino y mín.
GET /api/v1/where-nowEsta semana, la próxima semana, los próximos 30 días, el próximo movimiento importante y la línea de temporada.
GET /api/v1/destinations/{slug}Un destino con sus eventos, actividad mes a mes, aeropuertos, marinas, clima y lugares cercanos.
GET /api/v1/circuits/{slug}Las paradas ordenadas de un circuito con sus próximas fechas.
GET /api/v1/overlaps?event=Eventos que se solapan con la próxima edición de un evento: mismo destino, proximidad (con km), mismo país.
GET /api/v1/categoriesLa taxonomía con recuentos.
Representaciones y feeds
Cada evento se sirve también en HTML, JSON (.json), Markdown (.md) e iCalendar (.ics) desde un único registro. Existen feeds ICS suscribibles para el calendario global (/calendar.ics), cada circuito, categoría y destino.
Límites
El uso anónimo está limitado por IP (30 llamadas a la API por minuto) y los listados se detienen en el offset 100. Se pueden obtener claves con cuotas superiores mediante acuerdo para aplicaciones que transmitan los campos de procedencia y respeten las Condiciones de uso. No se permiten la extracción masiva, la reproducción en bases de datos ni la republicación comercial. Solicitar una clave.
Ejemplo
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
Para sistemas de IA, comenzar en /llms.txt.