Global Social SeasonLà où le monde se rassemble ★

API

Une API JSON délimitée et en lecture seule pour les événements, les dates, les destinations, les circuits, les chevauchements et la vue « où se trouve la saison ». Chaque réponse comporte la provenance et les conditions de réutilisation. Il n'existe aucun point d'accès renvoyant l'intégralité des données.

Points de terminaison

GET /api/v1/search?q=Rechercher des événements, destinations, circuits, mois et catégories (max 10).
GET /api/v1/events/{slug}Un événement en détail, avec chaque édition datée, son statut, sa note et sa source.
GET /api/v1/events?category=&destination=&circuit=&month=Résultats limités : 20 par appel ; décalage ≤ 100 sans clé.
GET /api/v1/calendar?from=&to=Éditions datées dans une fenêtre d'au plus 62 jours ; filtres par catégorie, région, destination, min.
GET /api/v1/where-nowCette semaine, la semaine prochaine, les 30 prochains jours, le prochain déplacement majeur et la ligne de saison.
GET /api/v1/destinations/{slug}Une destination avec ses événements, son activité mois par mois, ses aéroports, ses marinas, son climat et les lieux proches.
GET /api/v1/circuits/{slug}Les étapes ordonnées d'un circuit avec leurs prochaines dates.
GET /api/v1/overlaps?event=Événements chevauchant la prochaine édition d'un événement : même destination, à proximité (en km), même pays.
GET /api/v1/categoriesLa taxonomie avec les effectifs.

Représentations et flux

Chaque événement est également accessible en HTML, JSON (.json), Markdown (.md) et iCalendar (.ics) à partir d'un seul enregistrement. Des flux ICS par abonnement existent pour le calendrier global (/calendar.ics), chaque circuit, chaque catégorie et chaque destination.

Limites

L'utilisation anonyme est limitée en débit par adresse IP (30 appels API par minute) et les résultats s'arrêtent à l'offset 100. Des clés avec des quotas plus élevés sont disponibles sur arrangement pour les applications qui transmettent les champs de provenance et respectent les Conditions d'utilisation. L'extraction en masse, la reproduction en base de données et la republication commerciale ne sont pas autorisées. Demander une clé.

Exemple

curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"

Pour les systèmes d'IA, commencer par /llms.txt.