Điểm cuối
GET /api/v1/search?q=Tìm kiếm sự kiện, điểm đến, chuỗi hành trình, tháng và danh mục (tối đa 10).
GET /api/v1/events/{slug}Một sự kiện đầy đủ, với mọi kỳ có ngày cụ thể, trạng thái, ghi chú và nguồn.
GET /api/v1/events?category=&destination=&circuit=&month=Danh sách giới hạn: 20 lượt gọi; offset ≤ 100 khi không có khóa.
GET /api/v1/calendar?from=&to=Các kỳ có ngày trong khoảng tối đa 62 ngày; lọc theo danh mục, khu vực, điểm đến, tối thiểu.
GET /api/v1/where-nowTuần này, tuần tới, 30 ngày tới, bước di chuyển lớn tiếp theo và đường mùa vụ.
GET /api/v1/destinations/{slug}Một điểm đến với các sự kiện, hoạt động theo từng tháng, sân bay, bến du thuyền, khí hậu và các địa điểm lân cận.
GET /api/v1/circuits/{slug}Các chặng dừng theo thứ tự của một giải đấu cùng với ngày tiếp theo.
GET /api/v1/overlaps?event=Các sự kiện trùng với kỳ tiếp theo của một sự kiện: cùng điểm đến, lân cận (kèm km), cùng quốc gia.
GET /api/v1/categoriesPhân loại kèm số lượng.
Các đại diện và nguồn cấp dữ liệu
Mỗi sự kiện cũng được phục vụ dưới dạng HTML, JSON (.json), Markdown (.md) và iCalendar (.ics) từ một hồ sơ duy nhất. Các nguồn cấp ICS có thể đăng ký tồn tại cho lịch toàn cầu (/calendar.ics), từng lộ trình, danh mục và điểm đến.
Giới hạn
Người dùng ẩn danh bị giới hạn tốc độ theo IP (30 lệnh gọi API mỗi phút) và danh sách dừng ở offset 100. Các khóa với hạn ngạch cao hơn có thể được cung cấp theo thỏa thuận cho các ứng dụng chuyển tiếp các trường xuất xứ và tuân thủ Điều khoản Sử dụng. Không cho phép trích xuất hàng loạt, sao chép cơ sở dữ liệu và tái bản thương mại. Yêu cầu khóa truy cập.
Ví dụ
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
Đối với các hệ thống AI, bắt đầu tại /llms.txt.