Endpoints
GET /api/v1/search?q=Pesquise eventos, destinos, circuitos, meses e categorias (máx. 10).
GET /api/v1/events/{slug}Um evento completo, com todas as edições datadas, o seu estado, nota e fonte.
GET /api/v1/events?category=&destination=&circuit=&month=Listagem limitada: 20 por chamada; offset ≤ 100 sem chave.
GET /api/v1/calendar?from=&to=Edições datadas numa janela de no máximo 62 dias; filtros por categoria, região, destino, mín.
GET /api/v1/where-nowEsta semana, a próxima semana, os próximos 30 dias, o próximo movimento principal e a linha da temporada.
GET /api/v1/destinations/{slug}Um destino com os seus eventos, atividade mês a mês, aeroportos, marinas, clima e lugares próximos.
GET /api/v1/circuits/{slug}As paragens ordenadas de um circuito com as respetivas próximas datas.
GET /api/v1/overlaps?event=Eventos que se sobrepõem à próxima edição de um evento: mesmo destino, proximidade (com km), mesmo país.
GET /api/v1/categoriesA taxonomia com contagens.
Representações e feeds
Cada evento é também disponibilizado em HTML, JSON (.json), Markdown (.md) e iCalendar (.ics) a partir de um único registo. Existem feeds ICS subscricionáveis para o calendário global (/calendar.ics), cada circuito, categoria e destino.
Limites
A utilização anónima está sujeita a limitação de taxa por IP (30 chamadas de API por minuto) e os resultados cessam no offset 100. Chaves com quotas superiores estão disponíveis mediante acordo para aplicações que transmitam os campos de proveniência e respeitem as Condições de Utilização. A extracção em massa, a reprodução em base de dados e a republicação comercial não são permitidas. Solicitar uma chave.
Exemplo
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
Para sistemas de IA, começar em /llms.txt.