Перейти к основному содержимому
Occult API

Документация API

Здесь описан каждый эндпоинт: точное тело запроса и пример ответа, для большинства — записанный с рабочего сервера. Ключ передаётся в заголовке X-API-Key. Успешный вызов стоит один кредит, что бы вы в нём ни запросили. Исключения — два PDF-отчёта и эндпоинт чата: они стоят 25.

https://api.occultapi.com
Получить API-ключСправочник ошибокОткрыть в Postman

Что можно построить на этих эндпоинтах

Интерфейсы, сделанные на нашем API. На каждой карточке указан эндпоинт, который за ней стоит.

299 эндпоинтов, 330 расчётов в поиске

ИИ и чат

POSTАстрологический чат
/api/astro/chat/

PDF-отчёты

POSTPDF-отчёт с гороскопом
/api/astro/pdf/horoscope/
POSTPDF-отчёт «Книга года»
/api/astro/pdf/yearbook/

Панчанга

POSTТолкования панчанги рождения (ваши элементы)
/api/astro/birth-panchanga-effects/
POSTЧандрабала
/api/astro/chandrabala/
POSTПродолжительность дня и ночи
/api/astro/day-night-length/
POSTДиша шула
/api/astro/disha-shool/
POSTКарана
/api/astro/karana/
POSTСканирование каран
/api/astro/karana_scan/
POSTЛунный месяц
/api/astro/lunar-month/
POSTЛунная фаза
/api/astro/lunar-phase/
POSTСканирование лунного месяца
/api/astro/lunar_month_scan/
POSTНакшатра
/api/astro/nakshatra/
POSTНитья-йога
/api/astro/nitya-yoga/
POSTПанчак
/api/astro/panchak/
POSTПанчанга (пять элементов)
/api/astro/panchang/
POSTВлияние панчанги при рождении (справочная таблица)
/api/astro/panchang_element_birth_effect/13 расчётов
POSTНазвания элементов панчанги
/api/astro/panchanga-elements/
POSTПанчанга
/api/astro/panchanga/57 расчётов
POSTЙоги панчанги
/api/astro/panchanga_yogas/
POSTГоды самвата
/api/astro/samvat/
POSTДаты санкранти
/api/astro/sankranti/
POSTТарабала
/api/astro/tarabala/
POSTТитхи
/api/astro/tithi/
POSTПоиск титхи за год
/api/astro/tithi_scan/
POSTПоиск нитья-йоги за год
/api/astro/yoga_scan/

Мухурта и время

POSTАбхиджит-мухурта
/api/astro/abhijit-muhurat/
POSTЗанятия по дням недели
/api/astro/activities_day_of_week/2 расчёта
POSTАмрит-калам
/api/astro/amrit-kaal/
POSTБлагоприятное время
/api/astro/auspicious-timings/
POSTБрахма-мухурта
/api/astro/brahma-muhurat/
POSTЧогхадия
/api/astro/choghadiya/
POSTДурмухурта
/api/astro/durmuhurat/
POSTПланетарные часы (хора)
/api/astro/hora/
POSTНеблагоприятное время
/api/astro/inauspicious-timings/
POSTМухурты обрядов
/api/astro/muhurat/1 расчёт
POSTТаблица мухурт
/api/astro/muhurta-table/
POSTРаху-калам
/api/astro/rahu-kaal/
POSTОкна рави-йоги
/api/astro/ravi_yoga/
POSTОкна сандхьи
/api/astro/sandhya/
POSTАгни-васа и Шива-васа
/api/astro/vasa-segments/

Восход Солнца и Луны

POSTВосход и заход Луны
/api/astro/moonrise/
POSTВосход и заход Солнца
/api/astro/sunrise/

Луна

POSTЛунные стоянки
/api/astro/lunar/mansions/
POSTЛуна без курса
/api/astro/lunar/void-of-course/
POSTОсвещённость и фаза Луны
/api/astro/moon-illumination/

Календари

POSTАссамский календарь
/api/astro/assamese_calendar/
POSTБенгальский календарь
/api/astro/bengali_calendar/
POSTКалендарь гуджарати
/api/astro/gujarati_calendar/
POSTКалендарь ISKCON
/api/astro/iskcon_calendar/
POSTКалендарь каннада
/api/astro/kannada_calendar/
POSTКалендарь малаялам
/api/astro/malayalam_calendar/
POSTКалендарь маратхи
/api/astro/marathi_calendar/
POSTПанчанга на месяц
/api/astro/monthly_panchang/
POSTНепальский календарь
/api/astro/nepali_calendar/
POSTКалендарь ория
/api/astro/odia_calendar/
POSTКалендарь Онама
/api/astro/onam_calendar/
POSTТамильский календарь
/api/astro/tamil_calendar/
POSTКалендарь телугу
/api/astro/telugu_calendar/

Праздники и враты

POSTИндуистские праздники (с расчётом для места)
/api/astro/festival/1 расчёт
POSTКалендарь праздников (заранее рассчитанный)
/api/festivals/
POSTВраты и упавасы
/api/vrat-upavas/

Натальная карта и дома

POSTАтрибуты карты
/api/astro/attributes/
POSTКуспиды бхав
/api/astro/bhava-cusps/
POSTНатальная карта
/api/astro/chart/
POSTАнализ карты
/api/astro/chart_analysis/
POSTПоложения управителей домов (все 144)
/api/astro/effect_house_lord_different_house/1 расчёт
POSTКуспиды домов
/api/astro/house/7 расчётов
POSTОтношения домов
/api/astro/house_hora/29 расчётов
POSTЗначения домов
/api/astro/house_information/1 расчёт
POSTПоложение управителя дома (одна пара)
/api/astro/house_lord_particular_house/1 расчёт
POSTОсобые лагны
/api/astro/lagna/
POSTЖребий Фортуны
/api/astro/part-of-fortune/

Варги (дробные карты)

POSTРаши (D1)
/api/astro/rashi/
POSTКарта хора (D2)
/api/astro/hora-chart/
POSTДреккана (D3)
/api/astro/drekkana/
POSTЧатуртхамша (D4)
/api/astro/chaturthamsa/
POSTПанчамша (D5)
/api/astro/panchamsa/
POSTШаштхамша (D6)
/api/astro/shashthamsa/
POSTСаптамша (D7)
/api/astro/saptamsa/
POSTАштамша (D8)
/api/astro/ashtamsa/
POSTНавамша (D9)
/api/astro/navamsa/
POSTДашамша (D10)
/api/astro/dasamsa/
POSTРудрамша (D11)
/api/astro/rudramsa/
POSTДвадашамша (D12)
/api/astro/dwadasamsa/
POSTШодашамша (D16)
/api/astro/shodasamsa/
POSTВимшамша (D20)
/api/astro/vimsamsa/
POSTЧатурвимшамша (D24)
/api/astro/chaturvimsamsa/
POSTНакшатрамша (D27)
/api/astro/nakshatramsa/
POSTТримшамша (D30)
/api/astro/trimsamsa/
POSTКхаведамша (D40)
/api/astro/khavedamsa/
POSTАкшаведамша (D45)
/api/astro/akshavedamsa/
POSTШаштьямша (D60)
/api/astro/shashtyamsa/
POSTНавнавамша (D81)
/api/astro/navnavamsa/
POSTАштоттарамша (D108)
/api/astro/astottaramsa/
POSTДвадашдвадашамша (D144)
/api/astro/dwadasdwadasamsa/

Джаймини

POSTАргала и виродхаргала
/api/astro/argala/
POSTЧара-караки (Джаймини)
/api/astro/chara-karakas/
POSTКаракамша (свамша)
/api/astro/karakamsa/
POSTФакторы долголетия
/api/astro/longevity-factors/
POSTЧто аспектирует знак
/api/astro/rashi-aspects/

KP (Кришнамурти-паддхати)

POSTКарта KP (куспиды, знаки и планеты)
/api/astro/kp-chart/

Чакры

POSTСарватобхадра-чакра
/api/astro/sarvatobhadra/

Планеты и положения

GETЗначение аянамши
/api/astro/ayanamsa_value/
POSTПоложения небесных тел
/api/astro/celestial/31 расчёт
POSTЧто аспектирует планета
/api/astro/planet-aspects/
POSTЭкваториальные координаты планет
/api/astro/planet-equatorial/
POSTЕстественная дружба планет
/api/astro/planet-friendships/
POSTГоризонтальные координаты планет
/api/astro/planet-horizon/
POSTПозиции планет
/api/astro/planet-positions/
POSTТолкования положений планет
/api/astro/planet_insights/3 расчёта
POSTНеподвижные звёзды
/api/astro/star/10 расчётов
POSTУпаграхи
/api/astro/upagraha/
POSTПодробные данные о планетах
/api/planetary_details/

Сила планет (бала)

POSTИшта-пхала
/api/astro/ishta-kashta-phala/
POSTСоставляющие кала-балы
/api/astro/kaala-bala-components/
POSTШадбала и сила планет
/api/astro/strength/50 расчётов
POSTСила по варгам и позиционная сила
/api/astro/varga-bala/

Аштакаварга

POSTАштакаварга
/api/astro/ashtakvarga/8 расчётов
POSTПрастара-аштакаварга
/api/astro/ashtakvarga/prastara/
POSTШодхана и пинды аштакаварги
/api/astro/ashtakvarga/sodhana/
POSTБхиннаштакаварга
/api/astro/bhinnashtakavarga/
POSTСарваштакаварга
/api/astro/sarvashtakavarga/

Даши — накшатровые (по планетам)

POSTДаша Аштоттари
/api/astro/dasha/ashtottari/
POSTДаша Будхи-гати
/api/astro/dasha/budhi-gati/
POSTДаша Чатурашити-сама
/api/astro/dasha/chaturaseeti-sama/
POSTДаша Двадашоттари
/api/astro/dasha/dwadashottari/
POSTДаша Двисаптати-сама
/api/astro/dasha/dwisaptati/
POSTНакшатра-даша (любая система)
/api/astro/dasha/nakshatra/
POSTДаша Панчоттари
/api/astro/dasha/panchottari/
POSTДаша Шатабдика
/api/astro/dasha/sataabdika/
POSTДаша Шаттримша-сама
/api/astro/dasha/shattrimsa-sama/
POSTДаша Шодашоттари
/api/astro/dasha/shodashottari/
POSTДаша Вимшоттари
/api/astro/dasha/vimshottari/
POSTДаша Йогини
/api/astro/dasha/yogini/

Даши — по раши (Джаймини)

POSTДаша Брахма
/api/astro/dasha/brahma/
POSTДаша Чакра
/api/astro/dasha/chakra/
POSTДаша Чара
/api/astro/dasha/chara/
POSTДаша Дриг
/api/astro/dasha/drig/
POSTДаша Калачакра
/api/astro/dasha/kalachakra/
POSTДаша Кендради
/api/astro/dasha/kendradhi/
POSTДаша Лагнамшака
/api/astro/dasha/lagnamsaka/
POSTДаша Мандука
/api/astro/dasha/mandooka/
POSTДаша Нараяна
/api/astro/dasha/narayana/
POSTДаша Навамша
/api/astro/dasha/navamsa/
POSTДаша Нираяна-шула
/api/astro/dasha/nirayana-shoola/
POSTДаша Парьяя
/api/astro/dasha/paryaaya/
POSTРаши-даша (любая система)
/api/astro/dasha/rashi/
POSTДаша Сандхья
/api/astro/dasha/sandhya/
POSTДаша Шула
/api/astro/dasha/shoola/
POSTДаша Стхира
/api/astro/dasha/sthira/
POSTДаша Судаша
/api/astro/dasha/sudasa/
POSTДаша Тара-лагна
/api/astro/dasha/tara-lagna/
POSTДаша Трикона
/api/astro/dasha/trikona/
POSTДаша Йогардха
/api/astro/dasha/yogardha/

Инструменты для даш

POSTТекущая даша
/api/astro/dasha/current/
POSTДетализация даши
/api/astro/dasha/drill/
POSTУказатель систем даш
/api/astro/dasha/systems/
POSTПрименимость даш
/api/astro/dasha_applicability/1 расчёт

Йоги и доши

POSTКомбинационные йоги
/api/astro/combination_yoga/
POSTДоши
/api/astro/dosha/10 расчётов
POSTКала-сарпа-йога
/api/astro/kalsarp/
POSTРаджа-йоги
/api/astro/raja_yoga/1 расчёт

Лал Китаб

POSTКарта Лал Китаб
/api/astro/lal-kitab/chart/
POSTСхема карты Лал Китаб
/api/astro/lal-kitab/horoscope/
POSTДома Лал Китаб
/api/astro/lal-kitab/houses/
POSTПланеты Лал Китаб
/api/astro/lal-kitab/planets/
POSTВаршапхала Лал Китаб
/api/astro/lal-kitab/varshphal/

Совместимость

POSTСовместимость по ашта-куте (гун-милан)
/api/astro/ashtakoota/25 расчётов
POSTПоиск накшатр партнёра
/api/astro/compatibility_match/
POSTСовместимость для брака
/api/astro/horoscope-match/
POSTБрачные йоги нади
/api/astro/naadi_marriage_prediction/1 расчёт
POSTПорутам (южноиндийская совместимость)
/api/astro/porutham/

Транзиты и годовые карты

POSTТранзит по натальной планете
/api/astro/planet_transit_natal_planets/1 расчёт
POSTТранзит через дом
/api/astro/planet_transit_over_house/1 расчёт
POSTФазы транзита Сатурна
/api/astro/shani_analysis/
POSTТранзитные пересечения
/api/astro/transit/8 расчётов
POSTСнимок транзита
/api/astro/transit/details/
POSTПересечение долготы Луной
/api/astro/transit/moon-crossing/
POSTПересечение лунного узла
/api/astro/transit/node-crossing/
POSTПланета на градусе
/api/astro/transit/planet-at-degree/
POSTСолнечная ингрессия
/api/astro/transit/solar-ingress/

Таджика и варшапхала

POSTХарша-бала (таджика)
/api/astro/harsha-bala/
POSTДаша Мудда (варша-вимшоттари)
/api/astro/mudda-dasha/
POSTМунтха (варшапхала)
/api/astro/muntha/
POSTПанча-варгия-бала
/api/astro/pancha-vargeeya-bala/
POSTДаша Патьяйини
/api/astro/patyayini_dasha/1 расчёт
POSTСахамы (арабские жребии)
/api/astro/sahams/
POSTГодовые карты таджики
/api/astro/tajika/
POSTАспекты таджики
/api/astro/tajika/aspects/
POSTЙоги таджики
/api/astro/tajika/yogas/

Поиск событий и переходов

POSTПериоды сожжения
/api/astro/combustion/
POSTПереходы по накшатрам
/api/astro/nakshatra_transitions/
POSTПериоды ретроградности
/api/astro/retrograde/
POSTПереходы по знакам
/api/astro/sign_transitions/

Прогнозы и толкования

POSTОбщие предсказания
/api/astro/general_prediction/1 расчёт
POSTТолкования знака в доме
/api/astro/rashi_in_house_insights/1 расчёт
POSTПрогнозы рашифала
/api/astro/rashifal/4 расчёта
POSTРашифал на сегодня
/api/astro/rashifal/daily/
POSTРашифал на этот месяц
/api/astro/rashifal/monthly/
POSTРашифал на завтра
/api/astro/rashifal/tomorrow/
POSTРашифал на эту неделю
/api/astro/rashifal/weekly/
POSTРашифал на этот год
/api/astro/rashifal/yearly/
POSTРашифал на вчера
/api/astro/rashifal/yesterday/

Прашна

GETПанчашалака-чакра
/api/astro/panchashalaka_chakra/
GETПоиск ведхи в панчашалака-чакре
/api/astro/panchashalaka_vedha/
POSTЧувствительные точки прашны
/api/astro/prashna/
POSTАштамангала-прашна
/api/astro/prashna/ashtamangala/
POSTКарта джамаккол-прашны
/api/astro/prashna/jamakkol/
GETСапташалака-чакра
/api/astro/saptashalaka_chakra/
GETВедха в сапташалака-чакре
/api/astro/saptashalaka_vedha/

Таро

POSTСправочник колоды таро
/api/astro/tarot/deck/
POSTВытягивание карт таро
/api/astro/tarot/draw/
POSTРасклад таро
/api/astro/tarot/spread/
POSTТаро «да или нет»
/api/astro/tarot/yes-no/

Панча-пакши

POSTПанча-пакши (активность птиц по хорам)
/api/astro/pancha_pakshi_hora/4 расчёта
POSTПанча-пакши (сутки из десяти ям)
/api/panchpakshi/

Возвращения планет

POSTЛунное возвращение
/api/astro/return/lunar/
POSTВозвращение планеты
/api/astro/return/planet/
POSTВозвращение Сатурна
/api/astro/return/saturn/
POSTСолнечное возвращение
/api/astro/return/solar/
POSTВозвращение на градус
/api/astro/return/to-degree/

Затмения

POSTПараметры затмения на момент
/api/astro/eclipse/attributes/
POSTМестная видимость затмения
/api/astro/eclipse/local/
POSTБлижайшее лунное затмение
/api/astro/eclipse/next-lunar/
POSTБлижайшее солнечное затмение
/api/astro/eclipse/next-solar/
POSTЗатмения в диапазоне дат
/api/astro/eclipse/range/
POSTПредстоящие затмения
/api/astro/eclipse/upcoming/
POSTПолоса видимости затмения
/api/astro/eclipse/visibility-path/

Мунданная астрология

POSTМунданные карты ингрессий
/api/astro/mundane-charts/
POSTМунданная астрология
/api/astro/mundane/24 расчёта
POSTСоединения планет
/api/astro/mundane/conjunctions/
POSTВременная шкала небесных событий
/api/astro/mundane/events/
POSTИнгрессии в знаки
/api/astro/mundane/ingresses/
POSTНоволуния и полнолуния
/api/astro/mundane/lunations/
POSTРетроградные стационарные точки
/api/astro/mundane/stations/
POSTМунданные чакры накшатр
/api/astro/nakshatra-chakras/
POSTУправители индуистского года
/api/astro/samvatsara/
POSTРавноденствия, солнцестояния и риту
/api/astro/seasons/

Неподвижные звёзды

POSTКаталог неподвижных звёзд
/api/astro/fixed-star/catalog/
POSTЗвёзды на вашей карте
/api/astro/fixed-star/conjunctions/
POSTПараны звёзд и планет
/api/astro/fixed-star/parans/
POSTПоложения неподвижных звёзд
/api/astro/fixed-star/positions/

Традиционная и эллинистическая

POSTКазими, сожжение и пребывание под лучами Солнца
/api/astro/cazimi/
POSTАльмутен
/api/astro/traditional/almuten/
POSTЭссенциальные достоинства
/api/astro/traditional/dignities/
POSTПрофекции
/api/astro/traditional/profections/
POSTСекта
/api/astro/traditional/sect/

Западная астрология

POSTАнтиции и контрантиции
/api/astro/western/antiscia/
POSTКомпозитная карта
/api/astro/western/composite/
POSTКарта отношений Дэвисона
/api/astro/western/davison/
POSTДраконическая карта
/api/astro/western/draconic/
POSTГармоническая карта
/api/astro/western/harmonic/
POSTГелиоцентрическая карта
/api/astro/western/heliocentric/
POSTЗападные куспиды домов
/api/astro/western/house-cusps/
POSTЗападная натальная карта
/api/astro/western/natal-chart/
POSTЗападные планеты (тропические)
/api/astro/western/planets/
POSTВторичные прогрессии
/api/astro/western/progressions/
POSTСинастрия
/api/astro/western/synastry/
POSTТранзиты к натальной карте
/api/astro/western/transits/

Нумерология

POSTНумерология
/api/astro/numerology/34 расчёта
POSTЧисла абджад
/api/astro/numerology/abjad/
POSTЧисла ангелов
/api/astro/numerology/angel/
POSTНумерология ауры
/api/astro/numerology/aura/
POSTХалдейская нумерология
/api/astro/numerology/chaldean/
POSTНумерология Хейро
/api/astro/numerology/cheiro/
POSTКитайская нумерология
/api/astro/numerology/chinese/
POSTЕврейская гематрия
/api/astro/numerology/gematria/
POSTНумерология И цзин
/api/astro/numerology/iching/
POSTГреческая изопсефия
/api/astro/numerology/isopsephy/
POSTНумерология каббалы
/api/astro/numerology/kabbalah/
POSTПифагорейская нумерология
/api/astro/numerology/pythagorean/
POSTНумерология Сефариала
/api/astro/numerology/sepharial/
POSTНумерология таро
/api/astro/numerology/tarot/
POSTВедическая нумерология
/api/astro/numerology/vedic/

Китайская астрология

POSTКарта BaZi с десятью божествами
/api/astro/chinese/bazi/
POSTКитайские четыре столпа (BaZi)
/api/astro/chinese/four-pillars/
POSTКитайские такты удачи (да юнь)
/api/astro/chinese/luck-pillars/
POSTЗнак китайского зодиака
/api/astro/chinese/zodiac/

Астрокартография

POSTЛинии астрокартографии
/api/astro/astrocartography/lines/
POSTЛинии локального пространства
/api/astro/astrocartography/local-space/
POSTПересечения паранов
/api/astro/astrocartography/parans/
POSTЛинии вблизи места
/api/astro/astrocartography/relocate/

Human Design

POSTБодиграф Human Design
/api/astro/human-design/chart/
POSTКарта связи
/api/astro/human-design/connection/
POSTТип, стратегия и авторитет
/api/astro/human-design/properties/

Катастрофы и бедствия

GETЗемлетрясения
/api/hazard/earthquake/
GETЛесные пожары
/api/hazard/forest-fires/
GETАвиакатастрофы
/api/hazard/plane-crashes/
GETТеракты смертников
/api/hazard/suicide-attacks/
GETЦунами
/api/hazard/tsunami/events/

Утилиты

POSTОпределение часового пояса
/api/astro/date_time/
GETПоиск места
/api/astro/geocode/
POSTПеревод текста
/api/astro/translate/

Астрология

POSTКалькулятор асцендента (восходящий знак / лагна)
/api/astro/ascendant/

Прашнавали

POSTХануман-прашнавали
/api/astro/prashnavali/hanuman/
POSTМавджи Махарадж прашнавали
/api/astro/prashnavali/mavji/
POSTРам-шалака-прашнавали
/api/astro/prashnavali/ram-shalaka/
POSTСаи прашнавали
/api/astro/prashnavali/sai/

Справочник ошибок

СтатусКодЧто это значитЧто делать
401invalid_api_keyКлюч неверный, отозван или просрочен.Проверьте заголовок X-API-Key. Если вы меняли ключ, разверните новый.
402insufficient_creditsКлюч в порядке — закончились кредиты.Повысьте тариф или дождитесь ежемесячного обновления квоты. Это не ошибка аутентификации, перевыпускать ключ не нужно.
403endpoint_not_allowedЭтот маршрут недоступен для API-ключей: неверный путь или метод либо эндпоинт выведен из работы.Сверьте маршрут и метод со справочником. Повторный запрос не поможет.
403scope_not_allowedУ ключа нет прав (scope), нужных этому эндпоинту.Создайте ключ с нужными правами или оставьте список прав пустым — тогда доступно всё.
403ip_not_allowedДля ключа задан список разрешённых IP, а запрос пришёл с другого адреса.Отправляйте запросы с разрешённого IP или создайте ключ с нужными адресами.
403account_suspendedАккаунт заблокирован, поэтому все его ключи отклоняются.Напишите в поддержку. Новый ключ не поможет.
429api_key_rate_limitedСлишком много запросов за минуту.Сделайте паузу и повторите запрос через столько секунд, сколько указано в Retry-After.
400(ошибки в полях)Ошибка в теле запроса.Прочитайте message — там названо каждое поле. Кредиты не списываются.