POST/api/astro/planet-positions/1 क्रेडिट

ग्रह स्थितियाँ

किसी क्षण और स्थान के लिए नौ ग्रहों की निरयन स्थितियाँ: हर ग्रह का भोगांश, राशि, नक्षत्र, पद और भाव, और साथ में लग्न व वास्तव में लागू किया गया अयनांश। ग्रह किसी कुंडली नाम के नीचे, ग्रह-नाम वाली keys में नेस्टेड होकर नहीं आते, बल्कि पारंपरिक क्रम में एक सूची के रूप में आते हैं, जिसकी हर प्रविष्टि में `name` होता है — ताकि आप सीधे लूप चला सकें या तालिका बना सकें। यह /api/astro/chart/ से बना है, जिसमें हर कॉल पर chart_name, notation, ayanamsa और ascendant_pos ज़रूरी हैं। यहाँ इनके डिफ़ॉल्ट RashiChart, degree, LAHIRI और cusp हैं - बस तारीख़ और स्थान भेजें, और कुछ नहीं। फिर भी `ayanamsa` सोच-समझकर चुनें: यह उत्तर के हर भोगांश को खिसका देता है, और Lahiri व Raman में लगभग एक अंश का अंतर है, जो किसी ग्रह को दूसरे नक्षत्र में पहुँचाने के लिए काफ़ी है। chart एंडपॉइंट जिन 48 अयनांशों का समर्थन करता है, वे सभी यहाँ भी स्वीकार किए जाते हैं।

https://api.occultapi.com/api/astro/planet-positions/

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

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

ऑथेंटिकेशन

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

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

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

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
chart_name	string	ज़रूरी
datetime	string (date-time)	ज़रूरी	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है। इसका अर्थ date_time जैसा ही है; दूसरे एंडपॉइंट इसी चीज़ को दूसरे नाम से लेते हैं।
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
aberration	boolean	वैकल्पिक
apply_correction	boolean	वैकल्पिक
ascendant_pos	string	वैकल्पिक	`cuspstartend`
ayanamsa	string	वैकल्पिक
background_color	string	वैकल्पिक	SVG की पृष्ठभूमि का हेक्स रंग।
chart_style	string	वैकल्पिक	render='svg' होने पर चार्ट की शैली। 'north' हीरे के आकार वाला लेआउट है, जिसमें भाव अपनी जगह रहते हैं और राशियाँ घूमती हैं; 'south' ग्रिड वाला लेआउट है, जिसमें राशियाँ अपनी जगह रहती हैं और भाव घूमते हैं। `northsouth`
correction_deg	integer	वैकल्पिक	min 0
correction_direction	string	वैकल्पिक	`addsubtract`
correction_min	integer	वैकल्पिक	min 0 · max 59
correction_sec	integer	वैकल्पिक	min 0 · max 59
extended_bodies	array	वैकल्पिक	किन पिंड-समूहों को शामिल करना है: 'asteroids', 'planetary_moons', 'fictitious_bodies'।
label_style	string	वैकल्पिक	ग्रहों के लेबल किस रूप में हों: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) या 'symbol' (☉, ☽, ...)। `englishsanskritsymbol`
line_color	string	वैकल्पिक	चार्ट की ग्रिड रेखाओं का हेक्स रंग।
notation	string	वैकल्पिक	`astrologicaldegree`
nutation	boolean	वैकल्पिक
planet_color	string	वैकल्पिक	ग्रहों के लेबल का हेक्स रंग, जैसे '#111827'। डिफ़ॉल्ट रूप से थीम का अपना रंग।
rahu	string	वैकल्पिक	कौन-सा पात शामिल करना है। 'true' देने पर केवल स्पष्ट पात, 'mean' पर केवल मध्यम पात, और 'both' पर दोनों मिलते हैं। `truemeanboth`
refraction	boolean	वैकल्पिक
render	string	वैकल्पिक	'svg' दें, तो साथ में रेंडर किया हुआ चार्ट डायग्राम (chart_style देखें) और उसकी ज्यामिति भी मिलती है। इसे न भेजें, तो उत्तर में कोई बदलाव नहीं होता। `nonesvg`
show_degrees	boolean	वैकल्पिक	हर पिंड के लेबल के पास, उसकी राशि में उसका अंश भी दिखाएँ।
sign_color	string	वैकल्पिक	राशि संख्याओं/संक्षिप्त नामों का हेक्स रंग।
svg_size	integer	वैकल्पिक	वर्गाकार SVG viewBox की चौड़ाई और ऊँचाई, पिक्सेल में। min 100 · max 2000
theme	string	वैकल्पिक	`lightdark`
true_mean	string	वैकल्पिक	`TrueMean`
use_28_nakshatras	boolean	वैकल्पिक

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

curl -X POST https://api.occultapi.com/api/astro/planet-positions/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'

उत्तर

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 134.381,
        "latitude": 0,
        "nakshatra": "Poorva Phalguni",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "moon",
        "longitude": 1.478,
        "latitude": 4.37,
        "nakshatra": "Ashwini",
        "pada": 1,
        "kakshya": "saturn",
        "zodiac_name": "Aries",
        "house": 9
      },
      {
        "name": "mars",
        "longitude": 79.175,
        "latitude": 0.535,
        "nakshatra": "Aardra",
        "pada": 4,
        "kakshya": "Mercury",
        "zodiac_name": "Gemini",
        "house": 11
      },
      {
        "name": "mercury",
        "longitude": 138.508,
        "latitude": 1.574,
        "nakshatra": "Poorva Phalguni",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "jupiter",
        "longitude": 109.472,
        "latitude": 0.529,
        "nakshatra": "Aasresha",
        "pada": 1,
        "kakshya": "Mercury",
        "zodiac_name": "Cancer",
        "house": 12
      },
      {
        "name": "venus",
        "longitude": 178.956,
        "latitude": -3.391,
        "nakshatra": "Chitra",
        "pada": 2,
        "kakshya": "ascendant",
        "zodiac_name": "Virgo",
        "house": 2
      },
      {
        "name": "saturn",
        "longitude": 349.447,
        "latitude": -2.651,
        "nakshatra": "Revati",
        "pada": 1,
        "kakshya": "Mercury",
        "zodiac_name": "Pisces",
        "house": 8
      },
      {
        "name": "northtruenode",
        "longitude": 305.566,
        "latitude": 0,
        "nakshatra": "Dhanishtha",
        "pada": 4,
        "kakshya": "jupiter",
        "zodiac_name": "Aquarius",
        "house": 7
      },
      {
        "name": "southtruenode",
        "longitude": 125.56599999999996,
        "latitude": 0,
        "nakshatra": "Makha",
        "pada": 2,
        "kakshya": "jupiter",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "uranus",
        "longitude": 41.424,
        "latitude": -0.154,
        "nakshatra": "Rohini",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Taurus",
        "house": 10
      },
      {
        "name": "neptune",
        "longitude": 339.433,
        "latitude": -1.412,
        "nakshatra": "Uttaraabhaadra",
        "pada": 2,
        "kakshya": "mars",
        "zodiac_name": "Pisces",
        "house": 8
      },
      {
        "name": "pluto",
        "longitude": 279.279,
        "latitude": -4.3,
        "nakshatra": "Uttaraashaadha",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Capricorn",
        "house": 6
      }
    ],
    "ascendant": {
      "longitude": 132.1878846274937,
      "zodiac_name": "Leo",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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