نقاط النهاية
GET /api/v1/search?q=ابحث في الفعاليات والوجهات والدورات والأشهر والفئات (10 كحد أقصى).
GET /api/v1/events/{slug}فعالية واحدة بالتفصيل الكامل، مع كل دوراتها المؤرَّخة وحالتها وملاحظتها ومصدرها.
GET /api/v1/events?category=&destination=&circuit=&month=قائمة محدودة: 20 إدخالاً لكل استدعاء؛ الإزاحة ≤ 100 بدون مفتاح.
GET /api/v1/calendar?from=&to=دورات مؤرَّخة ضمن نافذة لا تتجاوز 62 يوماً؛ مرشَّحة حسب الفئة والمنطقة والوجهة والحد الأدنى.
GET /api/v1/where-nowهذا الأسبوع، الأسبوع القادم، الثلاثون يوماً التالية، التحرك الرئيسي التالي وخط الموسم.
GET /api/v1/destinations/{slug}وجهة بفعالياتها ونشاطها الشهري والمطارات والمراسي والمناخ والأماكن المجاورة.
GET /api/v1/circuits/{slug}محطات الدائرة المرتّبة مع مواعيدها القادمة.
GET /api/v1/overlaps?event=الفعاليات المتزامنة مع الدورة التالية لفعالية ما: في الوجهة نفسها، أو قريباً منها (بالكيلومترات)، أو في البلد ذاته.
GET /api/v1/categoriesالتصنيف مع الأعداد.
التمثيلات والخلاصات
تُقدَّم كل فعالية أيضًا بصيغ HTML وJSON (.json) وMarkdown (.md) وiCalendar (.ics) من سجل واحد. تتوفر تغذيات ICS قابلة للاشتراك للروزنامة العالمية (/calendar.ics) ولكل سيركيت وتصنيف ووجهة.
الحدود
الاستخدام المجهول مقيَّد بالسرعة عبر عنوان IP (30 استدعاء API في الدقيقة) وتتوقف القوائم عند الإزاحة 100. تتوفر مفاتيح بحصص أعلى بالتنسيق للتطبيقات التي تنقل حقول المصدر وتلتزم بشروط الاستخدام. لا يُسمح بالاستخراج الجماعي أو استنساخ قواعد البيانات أو إعادة النشر التجاري. طلب مفتاح.
مثال
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
لأنظمة الذكاء الاصطناعي، ابدأ من /llms.txt.