Endpoint
GET /api/v1/search?q=Cerca eventi, destinazioni, circuiti, mesi e categorie (max 10).
GET /api/v1/events/{slug}Un evento nel dettaglio, con ogni edizione datata, il suo stato, la nota e la fonte.
GET /api/v1/events?category=&destination=&circuit=&month=Elenco limitato: 20 risultati per chiamata; offset ≤ 100 senza chiave.
GET /api/v1/calendar?from=&to=Edizioni datate in una finestra di al massimo 62 giorni; filtri per categoria, regione, destinazione, min.
GET /api/v1/where-nowQuesta settimana, la settimana prossima, i prossimi 30 giorni, il prossimo spostamento principale e la linea stagionale.
GET /api/v1/destinations/{slug}Una destinazione con i suoi eventi, l'attività mese per mese, gli aeroporti, i porti turistici, il clima e le località vicine.
GET /api/v1/circuits/{slug}Le tappe ordinate di un circuito con le relative prossime date.
GET /api/v1/overlaps?event=Eventi sovrapposti alla prossima edizione di un evento: stessa destinazione, nelle vicinanze (con km), stesso paese.
GET /api/v1/categoriesLa tassonomia con i conteggi.
Rappresentazioni e feed
Ogni evento è disponibile anche in HTML, JSON (.json), Markdown (.md) e iCalendar (.ics) da un unico record. Esistono feed ICS a cui è possibile abbonarsi per il calendario globale (/calendar.ics), ciascun circuito, categoria e destinazione.
Limiti
L'utilizzo anonimo è soggetto a rate limiting per IP (30 chiamate API al minuto) e i risultati si interrompono all'offset 100. Chiavi con quote più elevate sono disponibili su accordo per applicazioni che trasmettono i campi di provenienza e rispettano le Condizioni d'uso. L'estrazione massiva, la riproduzione in banche dati e la ripubblicazione commerciale non sono consentite. Richiedi una chiave.
Esempio
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
Per i sistemi di IA, iniziare da /llms.txt.