/api/astro/muhurat/1 кредитМухурты обрядов
Находит в заданном диапазоне дат время, когда можно провести один из пяти индуистских обрядов перехода. У каждого обряда свой список допустимых накшатр и дополнительные условия по титхи, дню недели или знаку Солнца, и каждый момент выборки в диапазоне проверяется по всем пяти. Это mundan (первое пострижение ребёнка), vidyarambha (начало обучения), upanayana (обряд священного шнура), graha_pravesha (вселение в новый дом) и deva_pratishtha (установка божества). Для mundan дополнительно проверяется возраст ребёнка по birth_date: допускаются только 1, 3, 5, 7, 10 и 11-й годы. Передайте start_date, end_date, birth_date, interval_hours и место. Сканирование проходит диапазон с шагом interval_hours и выдаёт каждый подходящий шаг как отдельное двухчасовое окно. Поэтому подходящий день даёт несколько перекрывающихся строк, которые обычно стоит объединить; чем меньше шаг, тем точнее границы и тем больше строк. Ограничивайте диапазон несколькими неделями: цена в любом случае один кредит, но на каждом шаге заново рассчитывается полная панчанга. Единственный ключ — find_muhurats_in_range.
https://api.occultapi.com/api/astro/muhurat/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| birth_date | string (date-time) | обязательный | |
| date_time | string (date-time) | обязательный | Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC, и может вернуть результат за предыдущий день со статусом 200. '2026-09-01T06:00:00Z' и '2026-09-01 06:00:00' — разные моменты, и ответы для них будут разными. |
| end_date | string (date-time) | обязательный | |
| interval_hours | integer | обязательный | |
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -90 · max 90 |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180 |
| start_date | string (date-time) | обязательный | |
| timezone | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30). По смыслу совпадает с timezone_as_float: другие эндпоинты называют это поле иначе. min -12 · max 14 |
Доступные ключи (1)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| find_muhurats_in_range | start_date, end_date, birth_date, interval_hours | Сканирует период от start_date до end_date с шагом interval_hours и выдаёт каждый шаг, на котором допустим один из пяти обрядов. Возвращает список {muhurat, start_time, end_time, nakshatra, tithi}, где muhurat — одно из mundan, vidyarambha, upanayana, graha_pravesha или deva_pratishtha. end_time всегда равно start_time плюс два часа. Подходящие шаги подряд не объединяются, а выдаются отдельными перекрывающимися записями, поэтому подходящий день даёт несколько строк. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/muhurat/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["find_muhurats_in_range"],"date_time":"2025-03-27T13:50:05.104Z","latitude":26.9124,"longitude":75.7873,"timezone":5.5,"start_date":"2025-02-27T13:50:05.104Z","end_date":"2025-03-27T13:50:05.104Z","birth_date":"2025-03-27T13:50:05.104Z","interval_hours":2}'Ответ
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"find_muhurats_in_range\": [{\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 01:20:05.104000+05:30\", \"end_time\": \"2025-02-28 03:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 03:20:05.104000+05:30\", \"end_time\": \"2025-02-28 05:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 05:20:05.104000+05:30\", \"end_time\": \"2025-02-28 07:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 07:20:05.104000+05:30\", \"end_time\": \"2025-02-28 09:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 09:20:05.104000+05:30\", \"end_time\": \"2025-02-28 11:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-02 01:20:05.104000+05:30\", \"end_time\": \"2025-03-02 03:20:05.104000+05:30\", \"nakshatra\": \"Uttaraabhaadra\", \"tithi\": 3}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-02 03:20:05.104000+05:30\", \"end_time\": \"2025-03-02 05:20:05.104000+05:30\", \"nakshatra\": \"Uttaraabhaadra\", \"tithi\": 3}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 13:20:05.104000+05:30\", \"end_time\": \"2025-03-03 15:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 13:20:05.104000+05:30\", \"end_time\": \"2025-03-03 15:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 15:20:05.104000+05:30\", \"end_time\": \"2025-03-03 17:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 15:20:05.104000+05:30\", \"end_time\": \"2025-03-03 17:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 17:20:05.104000+05:30\", \"end_time\": \"2025-03-03 19:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 17:20:05.104000+05:30\", \"end_time\": \"2025-03-03 19:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 19:20:05.104000+05:30\", \"end_time\": \"2025-03-03 21:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 19:20:05.104000+05:30\", \"end_time\": \"2025-03-03 21:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 21:20:05.104000+05:30\", \"end_time\": \"2025-03-03 23:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 21:20:05.104000+05:30\", \"end_time\": \"2025-03-03 23:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 23:20:05.104000+05:30\", \"end_time\": \"2025-03-04 01:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 23:20:05.104000+05:30\", \"end_time\": \"2025-03-04 01:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-05 21:20:05.104000+05:30\", \"end_time\": \"2025-03-05 23:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-05 21:20:05.104000+05:30\", \"end_time\": \"2025-03-05 23:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-05 23:20:05.104000+05:30\", \"end_time\": \"2025-03-06 01:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-05 23:20:05.104000+05:30\", \"end_time\": \"2025-03-06 01:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-06 01:20:05.104000+05:30\", \"end_time\": \"2025-03-06 03:20:05.104000+05:30\", \"nakshatra\": "
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.