POST/api/astro/dosha/1 क्रेडिट

दोष

दोष जन्म कुंडली का कोई ख़ास कष्टकारी योग है — ग्रहों की ऐसी नामित स्थिति, जिसे शास्त्रीय ग्रंथ नुक़सानदेह मानते हैं, ज़्यादातर विवाह, स्वास्थ्य या वंश के लिए। यह एंडपॉइंट जन्म के क्षण और स्थान से ऐसे आठ दोषों की जाँच करता है, और चाहें तो केवल नतीजे लौटाता है, चाहें तो सीधे दिखाने लायक लिखी हुई व्याख्याएँ। इसे दो तरह से इस्तेमाल किया जा सकता है। अलग-अलग keys (`kala_sarpa`, `manglik`, `pitru_dosha` आदि) संरचित नतीजे लौटाती हैं, जिन्हें कोड में सीधे इस्तेमाल किया जा सकता है। `get_dosha_details` पूरा सेट फ़ॉर्मैट किए हुए HTML पैराग्राफ़ों के रूप में लौटाती है, जिनकी keys दोषों के अंग्रेज़ी नाम हैं; रिपोर्ट दिखानी हो, तो यही चाहिए। इसमें काल सर्प, मांगलिक, पितृ, गुरु चांडाल, कलत्र, घात और श्रापित दोष हैं, पर गंड मूल नहीं। अपना पाठ ख़ुद तैयार करना चाहें, तो `get_dosha_resources` पूरा मूल पाठ-संग्रह देती है। serializer सभी बूलियन और संरचित अनुरोध फ़ील्ड को ज़रूरी मानता है, उन keys के लिए भी जो उन्हें इस्तेमाल नहीं करतीं। `manglik_reference_planet` ग्रह इंडेक्स है (0 सूर्य, 1 चंद्रमा, 2 मंगल, 3 बुध, 4 बृहस्पति, 5 शुक्र, 6 शनि, 7 राहु, 8 केतु); इंजन का अपना डिफ़ॉल्ट, यानी लग्न से मापना, API से नहीं चुना जा सकता, क्योंकि फ़ील्ड पूर्णांक प्रकार का है। इस एंडपॉइंट पर UTC ऑफ़सेट वाले फ़ील्ड का नाम `timezone` है, `timezone_as_float` नहीं।

https://api.occultapi.com/api/astro/dosha/

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

ऑथेंटिकेशन

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

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

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

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
apply_exceptions	boolean	ज़रूरी
date_time	string (date-time)	ज़रूरी	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। फ़ॉर्मैट की शर्त। DRF DateTimeField: केवल ISO-8601 (DRF के डिफ़ॉल्ट इनपुट फ़ॉर्मैट), जैसे "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" या "2026-09-01 06:00:00" (समय क्षेत्र न हो, तो UTC माना जाता है)।
include_2nd_house	boolean	ज़रूरी
include_lagna_house	boolean	ज़रूरी
keys	array	ज़रूरी	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। `get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_details` स्ट्रिंग का ऐरे। 'manglik' के लिए manglik_reference_planet, include_lagna_house, include_2nd_house और apply_exceptions ज़रूरी हैं; 'ganda_moola' के लिए moon_star; और 'get_dosha_details' के लिए date_time और geopos।
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
manglik_reference_planet	integer	ज़रूरी
moon_star	string	ज़रूरी	अर्थ के हिसाब से यह 1-27 के बीच की नक्षत्र संख्या है (गंड मूल नक्षत्र हैं: 1 अश्विनी, 9 आश्लेषा, 10 मघा, 18 ज्येष्ठा, 19 मूल, 27 रेवती)। जब तक प्रकार का यह बेमेल ठीक नहीं होता, तब तक स्वीकार होने वाली वैल्यू की कोई ऐसी सूची नहीं दी जा सकती जो सच में काम करे।
timezone	number (double)	ज़रूरी	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30)। इसका अर्थ timezone_as_float जैसा ही है; दूसरे एंडपॉइंट इसी चीज़ को दूसरे नाम से लेते हैं।

उपलब्ध keys (10)

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

Key	और कौन-से फ़ील्ड चाहिए	विवरण
ganda_moola	moon_star	गंड मूल: जन्म नक्षत्र छह संधि नक्षत्रों (अश्विनी, आश्लेषा, मघा, ज्येष्ठा, मूल, रेवती) में से एक है या नहीं। इसे `moon_star` में 1–27 की नक्षत्र संख्या लेकर बूलियन लौटाना चाहिए, पर फ़ील्ड का प्रकार स्ट्रिंग है, जबकि तुलना वाली सूची में पूर्णांक हैं, इसलिए अभी यह key हर इनपुट पर false ही लौटाती है।
get_dosha_details	date_time, geopos	व्याख्या वाले सातों दोष, एक साथ जाँचे और लिखे हुए: एक ऑब्जेक्ट, जिसकी keys दोषों के अंग्रेज़ी नाम हैं — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha और Shrapit Dosha — और जिसकी वैल्यू HTML अंश हैं, जो बताते हैं कि दोष है या नहीं और उसका क्या अर्थ है। गंड मूल इसमें नहीं है। `date_time` और स्थान ज़रूरी हैं।
get_dosha_resources	—	दोषों की व्याख्या का पूरा पाठ-संग्रह: एक ऑब्जेक्ट, जिसकी keys दोषों के नाम हैं ('kala_sarpa', 'manglik', 'pitru', 'ghata' आदि), और हर नाम के नीचे अंग्रेज़ी पैराग्राफ़ों की सूची। सूची का पहला पैराग्राफ़ 'no such dosha' वाला पाठ है, और बाकी पैराग्राफ़ संबंधित भाव या प्रकार के हिसाब से हैं। पहले से तैयार HTML के बजाय अपना पाठ ख़ुद बनाना हो, तो इसे इस्तेमाल करें।
ghata	—	घात दोष: मंगल और शनि एक ही राशि में। एक बूलियन लौटाती है।
guru_chandala_dosha	—	गुरु चांडाल: बृहस्पति की राहु या केतु के साथ एक ही राशि में युति। दो आइटम वाली सूची लौटाती है: [योग है या नहीं, दोनों में बृहस्पति ज़्यादा बलवान है या नहीं]। युति न हो, तो दोनों false होते हैं।
kala_sarpa	—	काल सर्प दोष: true, जब सातों शास्त्रीय ग्रह राहु और केतु के बीच, पात-अक्ष के एक ही ओर घिरे हों। एक बूलियन लौटाती है; दोष का प्रकार (अनंत, कुलिक, वासुकि आदि) राहु के भाव से तय होता है।
kalathra	—	कलत्र दोष, यानी विवाह भाव का कष्ट। true, जब हर नैसर्गिक पाप ग्रह — सूर्य, मंगल, शनि, राहु और केतु — सातवें भाव से गिनकर 1ले, 2रे, 4थे, 7वें, 8वें या 12वें भाव में हो। एक बूलियन लौटाती है, और इसके लिए पाँचों पाप ग्रहों का शर्त पूरी करना ज़रूरी है, इसलिए यह बहुत कम ही true होती है।
manglik	manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions	मांगलिक, यानी मंगल दोष: `manglik_reference_planet` से गिनने पर मंगल विवाह को पीड़ित करने वाले भावों में से किसी में है या नहीं। तीन आइटम वाली सूची लौटाती है: [मांगलिक है या नहीं, कोई परिहार लागू होता है या नहीं, मेल खाने वाले परिहार नियमों की संख्याएँ]। जाँचे जाने वाले भाव 4था, 7वाँ, 8वाँ और 12वाँ हैं; `include_2nd_house` true हो, तो 2रा भी, और `include_lagna_house` true हो, तो 1ला भी। परिहार तभी जाँचे जाते हैं, जब `apply_exceptions` true हो।
pitru_dosha	—	पितृ दोष, यानी वंश का कष्ट। दो आइटम वाली सूची लौटाती है: [true या false, जो नियम लागू हुए उनकी संख्याएँ]। पाँच नियम क्रम से जाँचे जाते हैं: 9वें भाव में सूर्य, चंद्रमा या राहु; 4थे भाव में केतु; मंगल या शनि से पीड़ित सूर्य/चंद्रमा/राहु/केतु; 2रे, 5वें, 9वें या 12वें भाव में बुध, शुक्र और राहु का जमावड़ा; और किसी पात के साथ सूर्य या चंद्रमा की युति।
shrapit	—	श्रापित दोष: शनि और राहु एक ही राशि में। एक बूलियन लौटाती है।

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

curl -X POST https://api.occultapi.com/api/astro/dosha/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'

उत्तर

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"get_dosha_resources\": {\"kala_sarpa\": [\"There is no Kala Sarpa Dosha in this horoscope.\", \"Ananta Kala Sarpa Dosha- Rahu in 1st House and Ketu in 7th House. In this Dosha, Rahu is placed in the 1st house and Ketu in the 7th house in the horoscope. All planets are placed between Rahu-Ketu from the 1st house to the 7th house. This alignment can make a person ill-tempered and bring health issues. There would be problems in marital relationships, and, if in business, there would be a lack of support from partners.\", \"Kulik Kala Sarpa Dosha- Rahu in 2nd House and Ketu in 8th House. This Dosha is formed when Rahu is in the 2nd house and Ketu is in the 8th house, and all planets are between them. The individual afflicted may be vile-tongued and lead a life without the support of relatives. Monetary problems might surface, and savings might not be possible. The afflicted native may undergo surgery or accidents. There may be a possibility of unnatural death.\", \"Vasuki Kala Sarpa Dosha- Rahu in 3rd House and Ketu in 9th House. This Dosha is formed in the horoscope when Rahu and Ketu are in the 3rd, and 9th houses, respectively, and the remaining planets are hemmed between them. The afflicted individual may be timid in disposition and unable to fight for self-esteem. Relationships with younger siblings might not be good. Tide will go against the individual who may be unable to overcome adversity. The native can lack interest in religion, and luck may not favor them.\", \"Shankapal Kala Sarpa Dosha- Rahu in 4th House and Ketu in 10th House. This Dosha is formed when all planets are between Rahu and Ketu, which are placed from the 4th house to the 10th house. This alignment causes the native to have a bad relationship with the mother. The individual might not have mental peace and face professional problems.\", \"Padma Kala Sarpa Dosha- Rahu in 5th House and Ketu in 11th House. The axis of Rahu-Ketu from the 5th house to the 11th house and all planets within this axis cause this Dosha. The afflicted individual can face an issue with childbirth and education. They may have problems earning and may get into conflict with elder siblings.\", \"Mahapadma Kala Sarpa Dosha- Rahu in 6th House and Ketu in 12th House. The alignment of all planets in the Rahu-Ketu axis of the 6th house to the 12th house causes this Dosha. The afflicted individual can be dominated by enemies and lose money and property. The native could waste money, be unpopular, and have conflicts with in-laws.\", \"Takshak Kala Sarpa Dosha- Rahu in 7th House and Ketu in 1st House. The placement of all planets in the axis of Rahu-Ketu from the 7th house to the 1st house cause this Dosha. The afflicted may not go through marriage. If married, then the marriage might not go well. This Dosha can create a rift between the couple, leading to separation.\", \"Karakotak Kala Sarpa Dosha- Rahu in 8th House and Ketu in 2nd House. The placement of Rahu in the 8th house and Ketu in the 2nd house and the remaining planets in between them can cause this Dosha. The afflicted native might be ill-tempered and befriend anti-social elements. The native might have enemies and not be granted paternal wealth.\", \"Shankachood Kala Sarpa Dosha- Rahu in 9th House and Ketu in 3rd House. When Rahu is placed in the 9th house, Ketu in the 3rd house and all planets are between Rahu and Ketu; this Dosha is created in the horoscope. An afflicted individual might struggle a lot in life, and luck may never favor them. The individual may develop a habit of lying constantly and could be short-tempered.\", \"Ghatak Kala Sarpa Dosha- Rahu in 10th House and Ketu in 4th House. This Dosha is formed when Rahu is placed in the 10th house, Ketu in the 4th house, and all the planets are between the 10th to 4th houses. The afflicted individual may face many hurdles in his profession and conflicts with superiors at work. The individual may lack focus and face criticism. Relationships with family members may be poor. There may be de"
}

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

त्रुटियाँ

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