एंडपॉइंट
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यह सप्ताह, अगला सप्ताह, अगले 30 दिन, अगली प्रमुख गतिविधि और सीज़न रेखा।
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) के रूप में उपलब्ध है। वैश्विक कैलेंडर (/calendar.ics), प्रत्येक सर्किट, श्रेणी और गंतव्य के लिए सदस्यता-योग्य ICS फ़ीड उपलब्ध हैं।
सीमाएँ
익명 उपयोग प्रति IP दर-सीमित है (30 API कॉल प्रति मिनट) और लिस्टिंग offset 100 पर रुक जाती हैं। उच्च कोटा वाली Keys उन अनुप्रयोगों के लिए व्यवस्था द्वारा उपलब्ध हैं जो provenance फ़ील्ड को आगे ले जाते हैं और उपयोग की शर्तों का सम्मान करते हैं। Bulk extraction, डेटाबेस पुनरुत्पादन और व्यावसायिक पुनः प्रकाशन की अनुमति नहीं है। कुंजी का अनुरोध करें.
उदाहरण
curl -s "https://globalsocialseason.com/api/v1/calendar?from=2026-10-23&to=2026-11-22&min=70"
AI सिस्टम के लिए, यहाँ से प्रारंभ करें /llms.txt.