POST/api/festivals/1 क्रेडिट

त्योहार कैलेंडर (पहले से गणना किया गया)

चार परंपराओं के त्योहारों की पहले से गणना की गई तारीख़ें। ये अनुरोध पर गणना नहीं की जातीं, सीधे तालिका से पढ़ी जाती हैं, इसलिए पूरा वर्ष एक इंडेक्स वाली क्वेरी में मिल जाता है। `keys` से चुनें कि कौन-सी सूचियाँ चाहिए: `festivals` मुख्य हिंदू कैलेंडर है, `ekadashis` वर्ष की चौबीस या छब्बीस नाम वाली एकादशियाँ, और `jain_festivals`, `sikh_festivals` व `christian_festivals` इन्हीं नामों वाले कैलेंडर। `year` ज़रूरी है और `month` (1-12) वैकल्पिक; पूरा वर्ष चाहिए तो महीना न भेजें। उत्तर `{data}` है, जिसकी keys माँगी गई श्रेणियाँ हैं, और हर श्रेणी में घटनाओं की समय-क्रम वाली सूची है। हर घटना में `name`, `name_hi` (हिंदी नाम, जो अभी केवल मुख्य हिंदू श्रेणी में भरा है और बाकी में null है), `month` (चांद्र मास का नाम), `paksha`, `tithi` (सिख सूची में इस्तेमाल होता है), `date` (जहाँ पर्व किसी तय कैलेंडर तारीख़ पर होता है, जैसे ईसाई त्योहार) और `start_time`/`end_time` होते हैं, जो संबंधित तिथि के शुरू और ख़त्म होने के सटीक क्षण हैं। तारीख़ें वर्ष 2006 से 2046 तक (दोनों शामिल) पहले से निकाली गई हैं। इस सीमा से बाहर के वर्ष पर त्रुटि नहीं, खाली सूचियाँ मिलती हैं। चूँकि पंक्तियाँ हर अनुरोध पर निकाली नहीं जातीं, पहले से सहेजी हुई हैं, इसलिए यह एंडपॉइंट कोई निर्देशांक नहीं लेता; अगर स्थान के हिसाब से पर्व का दिन चाहिए, तो क्षेत्रीय कैलेंडर वाले एंडपॉइंट इस्तेमाल करें, जो स्थानीय सूर्योदय और सूर्यास्त से हर त्योहार का कैलेंडर दिन तय करते हैं।

https://api.occultapi.com/api/festivals/

अनुरोध आज़माएँ

त्योहार कैलेंडर (पहले से गणना किया गया) का नतीजा, एक इंटरफ़ेस में — इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड टाइप ज़रूरी टिप्पणी

keys

array

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
keys	array	ज़रूरी	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। `festivalsekadashisjain_festivalssikh_festivalschristian_festivals` कौन-से त्योहार कैलेंडर चाहिए। 'festivals' मुख्य हिंदू कैलेंडर है; बाकी अलग-अलग परंपराओं के हैं। एक ही कॉल में कई कैलेंडर माँग सकते हैं - उत्तर में हर श्रेणी अपनी key में आती है और शुल्क उतना ही रहता है।
year	integer	ज़रूरी	जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। चार अंकों का वर्ष। तारीख़ें 2006 से 2046 तक पहले से निकाली गई हैं; इस सीमा से बाहर उत्तर खाली आता है।
month	integer	वैकल्पिक	जन्म का महीना, संख्या के रूप में (1-12)। जनवरी 1 है। वैकल्पिक, 1-12। पूरे वर्ष के लिए इसे न भेजें। min 1 · max 12

ज़रूरी

कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।

festivalsekadashisjain_festivalssikh_festivalschristian_festivals

कौन-से त्योहार कैलेंडर चाहिए। 'festivals' मुख्य हिंदू कैलेंडर है; बाकी अलग-अलग परंपराओं के हैं। एक ही कॉल में कई कैलेंडर माँग सकते हैं - उत्तर में हर श्रेणी अपनी key में आती है और शुल्क उतना ही रहता है।

year

integer

ज़रूरी

जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।

चार अंकों का वर्ष। तारीख़ें 2006 से 2046 तक पहले से निकाली गई हैं; इस सीमा से बाहर उत्तर खाली आता है।

month

integer

वैकल्पिक

जन्म का महीना, संख्या के रूप में (1-12)। जनवरी 1 है।

वैकल्पिक, 1-12। पूरे वर्ष के लिए इसे न भेजें।

min 1 · max 12

उदाहरण अनुरोध

curl -X POST https://api.occultapi.com/api/festivals/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":9,"keys":["festivals","ekadashis"]}'

उत्तर

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"festivals\": [{\"name\": \"Janmashtami\", \"name_hi\": \"जन्माष्टमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-04T02:26:25+05:30\", \"end_time\": \"2026-09-05T00:14:34+05:30\"}, {\"name\": \"Gugga Navmi\", \"name_hi\": \"गूगा नवमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-05T00:14:34+05:30\", \"end_time\": \"2026-09-05T21:54:40+05:30\"}, {\"name\": \"Vatsa Dvadashi\", \"name_hi\": \"वत्स द्वादशी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-07T17:05:07+05:30\", \"end_time\": \"2026-09-08T14:43:55+05:30\"}, {\"name\": \"Kushotpaatini Ama\", \"name_hi\": \"कुशोत्पाटिनी अमावस्या\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-09T12:31:45+05:30\", \"end_time\": \"2026-09-10T10:34:16+05:30\"}, {\"name\": \"Hartalika Teej\", \"name_hi\": \"हरतालिका तीज\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-13T07:09:27+05:30\", \"end_time\": \"2026-09-14T07:08:00+05:30\"}, {\"name\": \"Varaha Jayanti\", \"name_hi\": \"वराह जयंती\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-13T07:09:27+05:30\", \"end_time\": \"2026-09-14T07:08:00+05:30\"}, {\"name\": \"Rishi Tarpana (Samvedic)\", \"name_hi\": \"ऋषि तर्पण (सामवेदिक)\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-13T07:09:27+05:30\", \"end_time\": \"2026-09-14T07:08:00+05:30\"}, {\"name\": \"Siddhi Vinayaka Vrata\", \"name_hi\": \"सिद्धि विनायक व्रत\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-14T07:08:00+05:30\", \"end_time\": \"2026-09-15T07:45:17+05:30\"}, {\"name\": \"Ganesh Chaturthi\", \"name_hi\": \"गणेश चतुर्थी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-14T07:08:00+05:30\", \"end_time\": \"2026-09-15T07:45:17+05:30\"}, {\"name\": \"Rishi Panchami\", \"name_hi\": \"ऋषि पंचमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-15T07:45:17+05:30\", \"end_time\": \"2026-09-16T09:00:28+05:30\"}, {\"name\": \"Balarama Jayanti\", \"name_hi\": \"बलराम जयंती\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-16T09:00:28+05:30\", \"end_time\": \"2026-09-17T10:49:00+05:30\"}, {\"name\": \"Radhashtami\", \"name_hi\": \"राधाष्टमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-18T13:02:12+05:30\", \"end_time\": \"2026-09-19T15:28:04+05:30\"}, {\"name\": \"Radha Ashtami\", \"name_hi\": \"राधा अष्टमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-18T13:02:12+05:30\", \"end_time\": \"2026-09-19T15:28:04+05:30\"}, {\"name\": \"Mahaluxmi Vrata begins\", \"name_hi\": \"महालक्ष्मी व्रत प्रारंभ\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-18T13:02:12+05:30\", \"end_time\": \"2026-09-19T15:28:04+05:30\"}, {\"name\": \"Vishnu Parivartanotsava\", \"name_hi\": \"विष्णु परिवर्तनोत्सव\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-22T21:44:20+05:30\", \"end_time\": \"2026-09-23T22:51:32+05:30\"}, {\"name\": \"Vamana Jayanti\", \"name_hi\": \"वामन जयंती\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-22T21:44:20+05:30\", \"end_time\": \"2026-09-23T22:51:32+05:30\"}, {\"name\": \"Anant Chaturdashi\", \"name_hi\": \"अनंत चतुर्दशी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-24T23:19:27+05:30\", \"end_time\": \"2026-09-25T23:07:49+05:30\"}, {\"name\": \"Ganesh Visarjan\", \"name_hi\": \"गणेश विसर्जन\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-24T23:19:27+05:30\", \"end_time\": \"2026-09-25T23:07:49+05:30\"}, {\"name\": \"Pitrupaksha Begins\", \"name_hi\": \"पितृपक्ष प्रारंभ\", \"month\": \"Ashwin\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-26T22:19:32+05:30\", \"end_time\": \"2026-09"
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।