/api/astro/planet-positions/1 кредитПоложення планет
Сидеричні положення дев’яти грах для моменту й місця: довгота, знак, накшатра, пада й дім для кожної, а також асцендент і фактично застосована аянамша. Планети повертаються СПИСКОМ у традиційному порядку з `name` у кожному записі, а не вкладеними під назвою карти з ключами за планетами, тож їх можна одразу перебирати або виводити таблицею. Ендпоінт побудовано на основі /api/astro/chart/, який вимагає chart_name, notation, ayanamsa і ascendant_pos у кожному виклику. Тут вони мають значення за замовчуванням RashiChart, degree, LAHIRI і cusp — досить надіслати дату й місце. `ayanamsa` усе ж варто задавати свідомо: вона зсуває кожну довготу у відповіді, а Лахірі й Раман відрізняються приблизно на градус — цього досить, щоб планета опинилася в іншій накшатрі. Тут приймаються всі 48 аянамш, які підтримує ендпоінт карти.
https://api.occultapi.com/api/astro/planet-positions/
Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| chart_name | string | обов’язковий | |
| datetime | string (date-time) | обов’язковий | Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC. Те саме значення, що й 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 у форматі hex. |
| 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 | необов’язковий | Колір ліній сітки карти у форматі hex. |
| notation | string | необов’язковий | astrologicaldegree |
| nutation | boolean | необов’язковий | |
| planet_color | string | необов’язковий | Колір підписів планет у форматі hex, напр. '#111827'. За замовчуванням — власний колір теми. |
| rahu | string | необов’язковий | Які вузли додати: 'true' — лише істинні, 'mean' — лише середні, 'both' — обидва типи. truemeanboth |
| refraction | boolean | необов’язковий | |
| render | string | необов’язковий | Передайте 'svg', щоб разом із даними отримати готову діаграму карти (див. chart_style) і геометрію, за якою її побудовано. Якщо параметр не передавати зовсім, відповідь не зміниться. nonesvg |
| show_degrees | boolean | необов’язковий | Показувати біля підпису кожного тіла його градус у знаку. |
| sign_color | string | необов’язковий | Колір номерів і скорочень знаків у форматі hex. |
| 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. Детальніше — у довіднику помилок.