curl -X POST https://api.occultapi.com/api/astro/rashifal/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-09-01","rashi":"aries","keys":["get_daily_rashifal","get_weekly_rashifal","get_monthly_rashifal"]}'राशिफल राशि पर आधारित भविष्यफल का कॉलम है: बारह चंद्र राशियों में से किसी एक में जन्मे सभी लोगों के लिए लिखा गया पूर्वानुमान, जिसमें जन्म कुंडली की ज़रूरत नहीं होती। यह एंडपॉइंट ऐसे चार पूर्वानुमान देता है — दैनिक, साप्ताहिक, मासिक और वार्षिक — हर एक अंग्रेज़ी और हिंदी दोनों में, एक ही उत्तर में। इसके पीछे की खगोलीय गणना असली है, और हर अवधि के लिए अलग है। दैनिक और साप्ताहिक फल आपकी राशि से गिने गए भावों में चंद्रमा के वास्तविक गोचर पर, और सप्ताह के भीतर बुध, शुक्र या मंगल के किसी वास्तविक स्तंभन पर आधारित हैं। मासिक फल में महीने भर की सूर्य संक्रांति, बुध और शुक्र के स्तंभन और मंगल के राशि परिवर्तन देखे जाते हैं; वार्षिक फल में बृहस्पति, शनि और राहु-केतु का गोचर, और साथ में साढ़े साती का एक सरल फ़्लैग, जो केवल आपकी राशि से शनि के भाव पर आधारित है। इन घटनाओं पर लिखे शब्द, और शुभ रंग व शुभ अंक, पहले से लिखे सेटों में से चुने जाते हैं। `rashi` में राशि का नाम और `date` में `YYYY-MM-DD` भेजें; तारीख़ वैकल्पिक है और डिफ़ॉल्ट आज की तारीख़ है। तारीख़ का कौन-सा हिस्सा काम आता है, यह key पर निर्भर है — साप्ताहिक फल इसे सप्ताह का पहला दिन मानता है, मासिक केवल महीना और वर्ष लेता है, और वार्षिक केवल वर्ष। हर टेक्स्ट फ़ील्ड के साथ एक `_hi` फ़ील्ड भी होता है, जिसमें उसका हिंदी रूप है। यह राशि-स्तर का फल है, इसलिए इसे कुंडली का फलादेश नहीं, कंटेंट फ़ीड समझें। व्यक्तिगत फल के लिए कुंडली की गणना करें और गोचर वाले एंडपॉइंट इस्तेमाल करें।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| date | string (date) | वैकल्पिक | |
| rashi | string | वैकल्पिक | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesकंस्ट्रक्टर में ही जाँचा जाता है, इसलिए गलत वैल्यू होने पर पूरा अनुरोध विफल हो जाता है। |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| get_daily_rashifal | rashi | किसी चंद्र राशि का एक दिन का पूर्वानुमान, जो उस राशि से गिने गए भावों में चंद्रमा के वास्तविक गोचर पर आधारित है। एक ऑब्जेक्ट लौटाती है: `date`, `sign`, `element`, `general_prediction` पैराग्राफ़, `aspects` ऑब्जेक्ट, जिसमें जीवन के तीन या चार पहलू (परिवार, स्वास्थ्य, यात्रा, करियर आदि) हैं और हर पहलू के लिए एक वाक्य, `{color, number, time}` वाला `lucky` ऑब्जेक्ट, और `{house, classification, benefic_support, malefic_pressure}` वाला `moon_transit` ऑब्जेक्ट, जिसमें `classification` favorable, neutral या challenging होता है। हर टेक्स्ट फ़ील्ड का हिंदी रूप उसके `_hi` फ़ील्ड में भी मिलता है। | |
| get_monthly_rashifal | rashi | कैलेंडर महीने का पूर्वानुमान — `date` से केवल महीना और वर्ष लिया जाता है, दिन अनदेखा होता है। महीने भर की सूर्य संक्रांति, बुध और शुक्र के स्तंभन और मंगल के राशि परिवर्तन पर आधारित है। लौटाती है: `month`, `year`, `sign`, `overview` पैराग्राफ़, `planetary_transits` और `aspects` ऑब्जेक्ट, `special_days`, जिसमें अधिकतम पाँच शुभ तारीख़ें और हर एक का कारण है, और `remedies`, दो उपायों की सूची। हर फ़ील्ड का `_hi` रूप भी मिलता है। | |
| get_weekly_rashifal | rashi | `date` से शुरू होने वाले सात दिनों का पूर्वानुमान। सातों दिनों के लिए चंद्रमा का वास्तविक गोचर देखा जाता है, और सप्ताह के भीतर बुध, शुक्र या मंगल का कोई वास्तविक स्तंभन हो तो उसे चिह्नित किया जाता है। लौटाती है: `week_start`, `week_end`, `sign`, `element`, `overview` पैराग्राफ़, `aspects` ऑब्जेक्ट, जिसकी keys "Weekday (date)" हैं और जिसमें सातों दिनों के लिए एक-एक वाक्य है, तारीख़ों की सूची के रूप में `best_days` और `challenging_days`, स्तंभन की सूचनाओं की सूची `planetary_alerts`, और `{color, number}` के रूप में `lucky`। हर फ़ील्ड का `_hi` रूप भी मिलता है। | |
| get_yearly_rashifal | rashi | कैलेंडर वर्ष का पूर्वानुमान — `date` से केवल वर्ष लिया जाता है। बृहस्पति, शनि और राहु-केतु के गोचर पर आधारित है, साथ में साढ़े साती और अष्टम शनि का फ़्लैग, जो केवल राशि से शनि के भाव पर आधारित है (साढ़े साती के लिए 12वाँ, 1ला या 2रा भाव; अष्टम और कंटक शनि के लिए 4था या 8वाँ)। लौटाती है: `year`, `sign`, `overview` पैराग्राफ़, `planetary_movements`, चार हिस्सों में बँटा `quarterly_forecast`, `yearly_aspects`, `lucky_elements` और `remedies`। हर टेक्स्ट फ़ील्ड का `_hi` रूप भी मिलता है। यह राशि-स्तर का अनुमान है, जन्म कुंडली का फलादेश नहीं, इसलिए यहाँ का साढ़े साती फ़्लैग `/api/astro/shani_analysis/` जितना सटीक नहीं है। |