सीधे सामग्री पर जाएँ
Occult API
POST/api/planetary_details/1 क्रेडिट

ग्रहों का विवरण

एक ही कॉल, जो किसी तारीख़ सीमा पर एफ़ेमेरिस के नौ अलग-अलग स्कैन चलाकर सबके नतीजे एक साथ लौटाती है। जब किसी एक क्षण का स्नैपशॉट नहीं, बल्कि दो तारीख़ों के बीच ग्रहों के साथ होने वाली हर घटना चाहिए, तब यही एंडपॉइंट काम का है: राशि और नक्षत्र परिवर्तन, वक्री अवधियाँ, क्रांति का मेल, और सीमा से बाहर (out-of-bounds) जाने की अवधियाँ। `start_date` और `end_date` अवधि तय करते हैं, `planet_name` और `sign` ग्रह वाले तीन खंडों को सीमित करते हैं, और `longitude` वह भोगांश है जिसे स्थिति वाली खोज जाँचती है। `geo_latitude` और `geo_longitude` भेजने पर लग्न प्रवेश का एक और खंड जुड़ जाता है, वरना वह नहीं आता। ध्यान दें कि पूरी अवधि स्कैन होती है, इसलिए कई वर्षों की अवधि कुछ दिनों की तुलना में काफ़ी धीमी चलती है। उत्तर में ये खंड होते हैं, जिनकी keys के नामों में स्पेस है: `sign transitions`, `planet at position` (जब दिया गया ग्रह दी गई राशि में दिए भोगांश पर हो), `planet ingress exit` (केवल दी गई राशि में दिए गए ग्रह के प्रवेश और निकलने के समय), `planet nakshatra ingress exit` (keys सभी सत्ताईस नक्षत्र, और हर एक में `{start_date, end_date}` अवधियों की सूची), `planet sankranti times` (keys हर समर्थित पिंड, यूरेनियन बिंदुओं और ग्रहों के चंद्रमाओं समेत), `planet retrogression dates` (keys ग्रह, और हर एक में `{start, end}` की सूची), `planet krantisamya dates` (`{Planet_1, Planet_2, DateTime, Alignment}` की सूची, जिसमें Alignment North-North, South-South या Opposite होता है, यानी बराबर क्रांति या उलटी दिशा में बराबर क्रांति), `abhijit nakshatra periods` और `planet oob range` (वे अवधियाँ जब पिंड सूर्य की अधिकतम क्रांति से आगे निकल जाता है)। खाली सूची का अर्थ है कि आपकी अवधि में उस तरह की कोई घटना नहीं हुई।

https://api.occultapi.com/api/planetary_details/
अनुरोध आज़माएँ

ऑथेंटिकेशन

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

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

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

फ़ील्डटाइपज़रूरीटिप्पणी
end_datestring (date-time)ज़रूरी
longitudenumber (double)ज़रूरी

स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।

min -180 · max 180

planet_namestringज़रूरी
sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutotruenodemeannode

इनमें से एक: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, truenode, meannode। छोटे अक्षरों में। दूसरे पिंडों के नाम जाँच में पास हो जाते हैं, पर उनका डेटा नहीं है, इसलिए वे विफल होंगे।

signstringज़रूरी
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

केस-संवेदी - राशियों के अंग्रेज़ी नाम Title Case में, ठीक इसी वर्तनी में; 'aries' विफल होता है। प्रवेश/निकास वाले नतीजे को माँगी गई राशि तक सीमित करने में भी इसका इस्तेमाल होता है।

start_datestring (date-time)ज़रूरी
geo_latitudenumber (double)वैकल्पिक

प्रेक्षक का भौगोलिक अक्षांश (-90 से 90)। लग्न प्रवेश डेटा के लिए ज़रूरी।

min -90 · max 90

geo_longitudenumber (double)वैकल्पिक

प्रेक्षक का भौगोलिक देशांतर (-180 से 180)। लग्न प्रवेश डेटा के लिए ज़रूरी।

min -180 · max 180

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

curl -X POST https://api.occultapi.com/api/planetary_details/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_date":"2024-11-21T08:33:35.539Z","end_date":"2024-11-22T08:33:35.539Z","longitude":76.125,"planet_name":"mercury","sign":"Taurus"}'

उत्तर

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"sign transitions\": {}, \"planet at position\": {\"mercury\": {\"positions\": []}}, \"planet ingress exit\": {\"mercury\": {}}, \"planet nakshatra ingress exit\": {\"mercury\": {\"Ashwini\": [], \"Bharani\": [], \"Krittika\": [], \"Rohini\": [], \"Mrigasira\": [], \"Aardra\": [], \"Punarvasu\": [], \"Pushyami\": [], \"Aasresha\": [], \"Makha\": [], \"Poorva Phalguni\": [], \"Uttara Phalguni\": [], \"Hasta\": [], \"Chitra\": [], \"Swaati\": [], \"Visaakha\": [], \"Anooraadha\": [], \"Jyeshtha\": [{\"start_date\": \"2024-11-21 08:33:35\", \"end_date\": \"2024-11-22 08:33:35\"}], \"Moola\": [], \"Poorvaashaadha\": [], \"Uttaraashaadha\": [], \"Sravanam\": [], \"Dhanishtha\": [], \"Satabhishak\": [], \"Poorvaabhaadra\": [], \"Uttaraabhaadra\": [], \"Revati\": []}}, \"planet sankranti times\": {\"sun\": [], \"moon\": [], \"mercury\": [], \"venus\": [], \"mars\": [], \"jupiter\": [], \"saturn\": [], \"uranus\": [], \"neptune\": [], \"pluto\": [], \"truenode\": [], \"meannode\": [], \"chiron\": [], \"pholus\": [], \"ceres\": [], \"pallas\": [], \"juno\": [], \"vesta\": [], \"cupido\": [], \"hades\": [], \"zeus\": [], \"kronos\": [], \"apollon\": [], \"admetos\": [], \"vulkanus\": [], \"poseidon\": [], \"selena\": [], \"phobos\": [], \"deimos\": [], \"io\": [], \"europa\": [], \"ganymede\": [], \"callisto\": [], \"titan\": [], \"triton\": [], \"charon\": []}, \"planet retrogression dates\": {\"jupiter\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"mars\": [], \"meannode\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"mercury\": [], \"moon\": [], \"neptune\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"pluto\": [], \"saturn\": [], \"sun\": [], \"truenode\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"uranus\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"venus\": []}, \"planet krantisamya dates\": [{\"Planet_1\": \"sun\", \"Planet_2\": \"truenode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"meannode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"zeus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"kronos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"apollon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"admetos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"vulkanus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"poseidon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"selena\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"mercury\", \"Planet_2\": \"venus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"mars\", \"Planet_2\": \"phobos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"mars\", \"Planet_2\": \"deimos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"io\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"europa\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"ganymede\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"callisto\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"saturn\", \"Planet_2\": \"titan\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"neptune\", \"Planet_2\": \"triton\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"pluto\", \"Planet_2\": \"charon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"truenode\", \"Planet_2\": \"meannode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"truenode\", \"Planet_2\": \"zeus\", \"DateTime\": \"2024-11-21 08:33"
}

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

त्रुटियाँ

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