Eindpunten
GET /api/v1/search?q=Zoek op evenementen, bestemmingen, circuits, maanden en categorieën (max. 10).
GET /api/v1/events/{slug}Één evenement volledig weergegeven, met elke gedateerde editie, de status, de noot en de bron.
GET /api/v1/events?category=&destination=&circuit=&month=Begrensde lijst: 20 per aanroep; offset ≤ 100 zonder sleutel.
GET /api/v1/calendar?from=&to=Gedateerde edities in een venster van maximaal 62 dagen; filters op categorie, regio, bestemming, min.
GET /api/v1/where-nowDeze week, volgende week, de komende 30 dagen, de eerstvolgende grote verplaatsing en de seizoenslijn.
GET /api/v1/destinations/{slug}Een bestemming met haar evenementen, maandelijkse activiteit, luchthavens, jachthavens, klimaat en nabijgelegen plaatsen.
GET /api/v1/circuits/{slug}De geordende haltes van een circuit met hun volgende data.
GET /api/v1/overlaps?event=Evenementen die overlappen met de eerstvolgende editie van een evenement: zelfde bestemming, nabijgelegen (met km), zelfde land.
GET /api/v1/categoriesDe taxonomie met aantallen.
Representaties en feeds
Elk evenement is beschikbaar als HTML, JSON (.json), Markdown (.md) en iCalendar (.ics) vanuit één record. Abonneerbare ICS-feeds bestaan voor de globale kalender (/calendar.ics), elk circuit, elke categorie en elke bestemming.
Limieten
Anoniem gebruik is tariefbeperkt per IP (30 API-aanroepen per minuut) en lijsten stoppen bij offset 100. Sleutels met hogere quota zijn op afspraak beschikbaar voor toepassingen die de herkomstvelden doorgeven en de Gebruiksvoorwaarden respecteren. Bulkextractie, databasereproductie en commerciële herpublicatie zijn niet toegestaan. Sleutel aanvragen.
Voorbeeld
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
Voor AI-systemen, begin bij /llms.txt.