परिचय

पंचांग और उसके पाँचों अंग, कुंडली और D2 से D60 तक की वर्ग कुंडलियाँ, तीस दशा पद्धतियाँ, योग और दोष, मुहूर्त, अष्टकवर्ग, ग्रह बल, कुंडली मिलान, तेरह पद्धतियों में अंक ज्योतिष, और ग्यारह क्षेत्रीय कैलेंडर उनके त्योहारों के साथ।

सब कुछ आपके अनुरोध में दी गई तारीख़, समय और निर्देशांकों के लिए गणना होता है। पहले से बना कोई पंचांग नहीं रखा जाता। लगभग हर एंडपॉइंट अंक और शास्त्रीय वर्गीकरण लौटाता है, लिखा हुआ फलादेश नहीं। कुछ एंडपॉइंट ज़रूर लिखा हुआ पाठ लौटाते हैं: चैट एंडपॉइंट, सामान्य भविष्यवाणी, राशिफल और PDF रिपोर्ट।

API का ज़्यादातर हिस्सा वैसे ही चलता है जैसी आप उम्मीद करेंगे। ये तीन बातें अलग हैं, और लोगों का सबसे ज़्यादा समय इन्हीं में जाता है।

कई एंडपॉइंट एक keys सूची लेते हैं, जिसमें लिखा होता है कि आपको कौन-सी गणनाएँ चाहिए। /api/astro/panchanga/ पर एक कॉल, आपकी माँग के हिसाब से, 57 अलग-अलग नतीजों में से कोई भी लौटा सकती है।

इन सबका शुल्क एक ही क्रेडिट है। जो कुछ चाहिए, सब एक ही कॉल में माँगना सस्ता पड़ता है, महँगा नहीं। गलती यह होती है कि लोग पाँच keys के लिए एक ही एंडपॉइंट को पाँच बार कॉल करते हैं। हर एंडपॉइंट के पेज पर उसकी मान्य keys दी हैं, और संदर्भ में रूट के साथ-साथ गणना के नाम से भी खोज सकते हैं। यानी फ़ीचर ढूँढने के लिए यह जानना ज़रूरी नहीं कि वह किस एंडपॉइंट में है।

{
  "date_time": "2026-09-16T06:00:00+05:30",
  "latitude": 26.9124,
  "longitude": 75.7873,
  "timezone_as_float": 5.5,
  "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
}

हर JSON उत्तर में यही चार फ़ील्ड होते हैं। is_error देखकर आगे का रास्ता चुनें, नतीजा data से पढ़ें, और कुछ गड़बड़ हो तो message दिखाएँ — उसमें सिर्फ़ “गलत अनुरोध” नहीं, गलत फ़ील्ड के नाम लिखे होते हैं।

{
  "data":     { ... },        // the result; shape varies by endpoint
  "status":   200,
  "is_error": false,
  "message":  "successful"
}

हर सफल कॉल पर एक क्रेडिट; दो PDF रिपोर्ट और चैट एंडपॉइंट पर 25। 4xx, 5xx या टाइमआउट पर कुछ नहीं लगता — गणना शुरू होने से पहले क्रेडिट अलग रख लिया जाता है, और ठीक से जवाब न मिले तो लौटा दिया जाता है। इसलिए डिबग करते समय गलत इंटीग्रेशन आपका बैलेंस ख़ाली नहीं कर सकता।

सेवा मासिक या सालाना प्लान से मिलती है। उसका कोटा हर महीने रीसेट होता है, और जो कॉल आपने इस्तेमाल नहीं कीं, वे अगले महीने में नहीं जुड़तीं। प्रति उपयोगकर्ता कोई शुल्क नहीं, और आप जब चाहें रद्द कर सकते हैं। हर उत्तर में X-Credits-Charged और X-Credits-Remaining होते हैं, ताकि बैलेंस देखने के लिए दूसरी कॉल न करनी पड़े।

ग्रहों की स्थिति NASA JPL के एफ़ेमेरिस डेटा से आती है — पूरा डेटा, 735 स्थिर तारे, और 500 से 2999 ई. तक जाँचा हुआ। सर्वर पर मीडियन उत्तर समय 62 ms है। यह किसी चुने हुए उदाहरण पर नहीं, सभी प्रकाशित उदाहरणों पर मापा गया है। जो एंडपॉइंट धीमे हैं, वे गहरी खोज करते हैं, और डॉक्स में यह साफ़ लिखा है।

अयनांश को लेकर भारतीय परंपराओं में सचमुच मतभेद है। इसलिए API 48 अयनांश देता है, और हर एक को अंश, कला और विकला तक ठीक करने देता है। कौन-सा अयनांश लेना है, यह आप तय करते हैं, और अपने उपयोगकर्ताओं को इसकी वजह भी आप ही बताते हैं। हम किसी एक को सही बताकर आप पर नहीं थोपते।

यह गणना है, सलाह नहीं। इसका कोई भी नतीजा चिकित्सा, क़ानूनी या वित्तीय सलाह नहीं है, और लिखा हुआ पाठ लौटाने वाले कुछ एंडपॉइंट छोड़कर यह कोई व्याख्या नहीं लिखता। अगर आपका प्रोडक्ट इसके आधार पर सुझाव देता है, तो वह आपका संपादकीय फ़ैसला है — नतीजों के साथ आप क्या कर सकते हैं, यह लाइसेंस में लिखा है।

बेस URL https://api.occultapi.com है। सीधे HTTP के अलावा ये रास्ते भी हैं: प्लेग्राउंड, जहाँ आपकी अपनी कुंजी से असली कॉल चलती हैं (विफल कॉल पर कुछ नहीं लगता); Postman कलेक्शन; क्लाइंट बनाने के लिए OpenAPI 3.1 स्पेक; और MCP सर्वर, ताकि AI असिस्टेंट सीधे API को कॉल कर सके।