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

मेदिनी ज्योतिष

मेदिनी ज्योतिष किसी व्यक्ति का नहीं, किसी देश का वर्षफल देखता है। इसका मुख्य आधार संवत्सर मंत्रिमंडल है: वर्ष के दस 'अधिकारी', और हर अधिकारी एक ग्रह। हर अधिकारी उस स्थानीय वार से तय होता है जिस दिन कोई खास सौर घटना पड़ती है (वार दिए गए स्थान पर एक सूर्योदय से अगले सूर्योदय तक गिना जाता है) — राजा चांद्र नववर्ष से, मंत्री सूर्य के मेष में प्रवेश से, मेघेश सूर्य के आर्द्रा में प्रवेश से, और इसी तरह अनाज, कोष और फलों के स्वामियों तक। जिस वर्ष शनि राजा हो, उसका फलादेश बृहस्पति वाले वर्ष से बहुत अलग होता है। वह ग्रेगोरियन वर्ष भेजें जिसमें संवत शुरू होता है, साथ में स्थान और UTC ऑफ़सेट; मंत्रिमंडल उस वर्ष की चैत्र शुक्ल प्रतिपदा से अगली चैत्र शुक्ल प्रतिपदा तक चलता है। das_adhikari पूरा मंत्रिमंडल एक ऑब्जेक्ट में लौटाती है, इसलिए शुरुआत इसी key से करें; अलग-अलग keys — king_of_year, mantri_of_year, meghesha_of_year आदि — वही ग्रह एक-एक करके लौटाती हैं। vaahan_of_samvat वर्ष का प्रतीकात्मक वाहन देती है, जो राजा से तय होता है। मंत्रिमंडल के साथ यह एंडपॉइंट वर्ष का खगोलीय ढाँचा भी लौटाता है — विषुव, अयनांत, छह ऋतुओं के लिए indian_ritus (असली तारीख़ सीमाओं के रूप में), chaitra_shukla_pratipada और ardra_entry — और खास प्रवेशों के लिए बनी चार कुंडलियाँ: सूर्य के मेष में प्रवेश पर jagat_lagna_chart, मानसून के लिए ardra_pravesh_chart, और शीत व ग्रीष्म फ़सलों के लिए sharatsasya_chart और greeshmasasya_chart। sapta_nadi_chakra और samvatsara_purusha_chakra स्टैटिक संदर्भ तालिकाएँ हैं, जो हर वर्ष एक जैसी रहती हैं, और nakshatra_lord_effects इनमें से पहली तालिका में एक नक्षत्र खोजती है। उस key का nakshatra फ़ील्ड पुराना लिप्यंतरण इस्तेमाल करता है और उसमें केवल छब्बीस नाम हैं — आधुनिक वर्तनियाँ मानकर न चलें, फ़ील्ड की सूची देखें।

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

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

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

ऑथेंटिकेशन

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

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

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

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
keys	array	ज़रूरी	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
nakshatra	string	ज़रूरी	`KrittikaVisaakhaAnooraadhaBharaniRohiniSwaatiJyeshthaAshwiniMrigasiraChitraMoolaRevati` केवल 'nakshatra_lord_effects' key इसे इस्तेमाल करती है। सप्त नाड़ी चक्र तालिका से हूबहू, केस-संवेदी मिलान होता है - ये पुराने लिप्यंतरण हैं, आधुनिक वर्तनियाँ नहीं; ध्यान दें: 'Aardra' (Ardra नहीं), 'Aasresha' (Ashlesha नहीं), 'Makha' (Magha नहीं), 'Sravanam' (Shravana नहीं), 'Visaakha', 'Anooraadha', 'Mrigasira', 'Pushyami', 'Satabhishak', 'Poorvaabhaadra', 'Uttaraashaadha'। 28 में से केवल 26 नक्षत्र नाम इसमें हैं - 'Poorvaashaadha' और 'Uttaraabhaadra' तालिका में नहीं हैं। मेल न खाने वाले नाम पर त्रुटि नहीं मिलती: मेथड null लौटाता है।
timezone_as_float	number (double)	ज़रूरी	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14
year	integer	ज़रूरी	जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।

उपलब्ध keys (24)

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

Key	और कौन-से फ़ील्ड चाहिए	विवरण
ardra_entry	—	वह सटीक क्षण जब सूर्य 66°40' पर पहुँचता है, यानी आर्द्रा नक्षत्र का आरंभ — मानसून की गणना का पारंपरिक चिह्न। एक टाइमस्टैम्प।
ardra_pravesh_chart	—	कुंडली का वही ढाँचा, उस क्षण के लिए जब सूर्य आर्द्रा नक्षत्र में प्रवेश करता है; मानसून का फलादेश इसी कुंडली से होता है। {entry_time, chart, house_planets} लौटाती है।
chaitra_shukla_pratipada	—	हिंदू चांद्र नववर्ष: माँगे गए वर्ष में चैत्र शुक्ल प्रतिपदा का दिन शुरू करने वाला स्थानीय सूर्योदय। चैत्र मास उस अंतिम अमावस्या से शुरू होता है जो सूर्य के निरयन मेष में प्रवेश से पहले पड़ती है; प्रतिपदा का दिन वह पहला दिन है जिसका सूर्योदय शुक्ल पक्ष की पहली तिथि में पड़े, या, अगर यह तिथि किसी भी सूर्योदय को न छुए, तो वह दिन जिसमें यह तिथि शुरू होती है। एक टाइमस्टैम्प।
das_adhikari	—	वर्ष का पूरा मंत्रिमंडल एक ऑब्जेक्ट में, जिसकी keys King, Minister, Lord of Clouds, Lord of Summer Crops, Lord of Defence, Lord of Treasury, Lord of Juicy Products, Lord of Food Grains, Lord of Metals, Lord of Fruits और Vehicle of Year हैं। पहली दस वैल्यू ग्रहों के नाम हैं और अंतिम वैल्यू वाहन है। दस अलग-अलग keys माँगने के बजाय यहीं से शुरू करें।
dhaanyesha_of_year	—	धान्येश, अनाज का स्वामी: सूर्य के धनु में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम।
dhanesha_of_year	—	धनेश, कोष का स्वामी: सूर्य के कन्या में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम।
durgesha_of_year	—	दुर्गेश, दुर्गों और रक्षा का स्वामी: सूर्य के सिंह में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम।
equinoxes	—	वर्ष के दोनों विषुव क्षण, जो सूर्य के सायन 0 और 180 अंश पार करने से निकाले जाते हैं। दो आइटम वाली सूची: पहले वसंत विषुव, फिर शरद विषुव।
greeshmasasya_chart	—	ग्रीष्म फ़सल की कुंडली, सूर्य के मीन में प्रवेश के क्षण के लिए। {entry_time, chart, house_planets} लौटाती है।
indian_ritus	—	छह भारतीय ऋतुएँ, असली तारीख़ सीमाओं के रूप में। हर ऋतु सूर्य के सायन भोगांश का साठ अंश का चाप है, और चाप इस तरह रखे गए हैं कि हर विषुव और अयनांत किसी ऋतु के बीच में या किनारे पर पड़े। छह ऑब्जेक्ट की सूची लौटाती है — {ritu, name, subtitle, begins, ends, tropical_zodiac, note, image_url} — इस क्रम में: वसंत, ग्रीष्म, वर्षा, शरद, हेमंत, शिशिर।
jagat_lagna_chart	—	विश्व कुंडली, सूर्य के मेष में प्रवेश के सटीक क्षण के लिए। {ingress_time, chart, house_planets} लौटाती है: chart राशि-और-अंश वाले रूप में पूरी राशि कुंडली है, जिसमें celestial, houses और ascendant खंड हैं, और house_planets बताता है कि किस भाव में कौन-से ग्रह बैठे हैं।
king_of_year	—	वर्ष का राजा — उस स्थानीय वार का स्वामी ग्रह जिस दिन चैत्र शुक्ल प्रतिपदा पड़ती है। ग्रह का एक अंग्रेज़ी नाम। मेदिनी पद्धति में इसी ग्रह का स्वभाव पूरे वर्ष के फलादेश का स्वर तय करता है।
mantri_of_year	—	मंत्री, यानी वर्ष का मंत्री: सूर्य के मेष में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम।
meghesha_of_year	—	मेघेश, बादलों का स्वामी: सूर्य के आर्द्रा में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम; इससे वर्ष की वर्षा देखी जाती है।
nakshatra_lord_effects	nakshatra	आपके भेजे गए नक्षत्र को सप्त नाड़ी चक्र में खोजती है और {lord, nadi, means, effect} लौटाती है: स्वामी ग्रह, नाड़ी का नाम, वह नाड़ी क्या दर्शाती है, और उससे किस मौसम का फलादेश होता है। जो नाम तालिका में नहीं है, उसके लिए null लौटाती है; तालिका में पुराने लिप्यंतरण हैं, केवल छब्बीस नाम हैं, और Poorvaashaadha व Uttaraabhaadra नहीं हैं।
neersesha_of_year	—	सूर्य के मकर में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम। शास्त्रों में यह पद जल के स्वामी का है; यह API das_adhikari में इसे Lord of Metals कहता है, और यह विवरण शास्त्रीय प्रयोग के बजाय कोड के अनुसार है।
phalesha_of_year	—	फलेश, फलों का स्वामी: संवत के अंत में, अगले ग्रेगोरियन वर्ष के मार्च में, सूर्य के मीन में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम।
rasesha_of_year	—	रसेश, रसों और तरल उपज का स्वामी: सूर्य के तुला में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम।
samvatsara_purusha_chakra	—	वर्ष-पुरुष (संवत्सर पुरुष) के शरीर के अंगों से नक्षत्रों का संबंध। एक स्टैटिक ऑब्जेक्ट लौटाती है, जिसकी keys शरीर के अंग हैं — 'Entire body', 'Navel', 'Heart' और 'Vitality' — हर एक के साथ nakshatras सूची, और अंतिम के साथ significance नोट। यह तालिका अधूरी है: इसमें सभी सत्ताईस नहीं, केवल छह नक्षत्र हैं।
sapta_nadi_chakra	—	सात नाड़ियों वाली पूरी मौसम तालिका, जिसमें nakshatra_lord_effects खोज करती है: ऐसा ऑब्जेक्ट जिसकी keys सात ग्रह हैं, और हर ग्रह के लिए {nakshatras, nadi, means, effect}। यह स्टैटिक संदर्भ डेटा है, हर अनुरोध के लिए एक जैसा। ध्यान दें कि कुछ नक्षत्र एक से ज़्यादा ग्रहों के नीचे आते हैं, और खोज पहला मिलान लौटाती है।
sashyesha_of_year	—	सस्येश, फ़सलों का स्वामी: सूर्य के कर्क में प्रवेश वाले दिन के स्थानीय वार (सूर्योदय से सूर्योदय) का स्वामी ग्रह। ग्रह का एक अंग्रेज़ी नाम; das_adhikari में यह Lord of Summer Crops के नाम से आता है।
sharatsasya_chart	—	शीत फ़सल की कुंडली, सूर्य के कन्या में प्रवेश के क्षण के लिए। {entry_time, chart, house_planets} लौटाती है, यानी बाकी मेदिनी कुंडलियों जैसा ही ढाँचा।
solstices	—	वर्ष के दोनों अयनांत क्षण। दो आइटम वाली सूची — ध्यान दें कि क्रम कालक्रम के अनुसार नहीं है: पहले शीत अयनांत (सूर्य 270 अंश पर, माँगे गए वर्ष के दिसंबर में) और फिर ग्रीष्म अयनांत (सूर्य 90 अंश पर, जून में)।
vaahan_of_samvat	—	वर्ष का प्रतीकात्मक वाहन, जो वर्ष के राजा से तय होता है — सूर्य के लिए Horse, चंद्रमा के लिए Elephant, मंगल के लिए Ox/boat, बुध के लिए Swing, बृहस्पति के लिए Boat, शुक्र के लिए Elephant/Frog, शनि के लिए Horse/Buffalo। एक स्ट्रिंग।

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

curl -X POST https://api.occultapi.com/api/astro/mundane/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["nakshatra_lord_effects"],"year":2025,"date_time":"2025-02-13T05:00:37.682Z","nakshatra":"Krittika","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

उत्तर

{
  "data": {
    "nakshatra_lord_effects": {
      "lord": "Saturn",
      "nadi": "Chandaa",
      "means": "Aggressive",
      "effect": "Heat, Wind"
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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