Endpunkte
GET /api/v1/search?q=Veranstaltungen, Reiseziele, Circuits, Monate und Kategorien durchsuchen (max. 10).
GET /api/v1/events/{slug}Eine Veranstaltung vollständig, mit allen terminierten Ausgaben, Status, Hinweis und Quelle.
GET /api/v1/events?category=&destination=&circuit=&month=Begrenzte Ausgabe: 20 Einträge pro Aufruf; Offset ≤ 100 ohne Schlüssel.
GET /api/v1/calendar?from=&to=Terminierte Ausgaben in einem Fenster von höchstens 62 Tagen; Filter nach Kategorie, Region, Reiseziel, Min.
GET /api/v1/where-nowDiese Woche, nächste Woche, die nächsten 30 Tage, der nächste bedeutende Ortswechsel und die Saisonlinie.
GET /api/v1/destinations/{slug}Ein Reiseziel mit seinen Veranstaltungen, monatlicher Aktivität, Flughäfen, Marinas, Klima und umliegenden Orten.
GET /api/v1/circuits/{slug}Die geordneten Stationen eines Circuits mit ihren nächsten Terminen.
GET /api/v1/overlaps?event=Veranstaltungen, die sich mit der nächsten Ausgabe einer Veranstaltung überschneiden: gleiches Reiseziel, in der Nähe (mit km-Angabe), gleiches Land.
GET /api/v1/categoriesDie Taxonomie mit Anzahlen.
Darstellungen und Feeds
Jede Veranstaltung steht aus einem einzigen Eintrag als HTML, JSON (.json), Markdown (.md) und iCalendar (.ics) zur Verfügung. Abonnierbare ICS-Feeds gibt es für den globalen Kalender (/calendar.ics) sowie für jeden Circuit, jede Kategorie und jedes Reiseziel.
Limits
Anonyme Nutzung ist je IP-Adresse ratenbegrenzt (30 API-Aufrufe pro Minute), und Listeneinträge enden bei Offset 100. Schlüssel mit höheren Kontingenten sind für Anwendungen, die die Herkunftsfelder weiterführen und die Nutzungsbedingungen einhalten, nach Vereinbarung erhältlich. Massenextraktion, Datenbankreplikation und kommerzielle Weiterveröffentlichung sind nicht gestattet. Schlüssel anfordern.
Beispiel
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
Für KI-Systeme, beginnen Sie unter /llms.txt.