Вступ

Панчанг і п’ять його складових, кундлі й дробові карти від D2 до D60, тридцять систем даш, йоги й доші, вікна мухурти, аштакаварга, сила планет, сумісність гороскопів, нумерологія в тринадцяти системах і одинадцять регіональних календарів зі святами.

Усе рахується для дати, часу й координат із вашого запиту — готового кешованого календаря немає. Майже всі ендпоінти повертають числа й класичні класифікації, а не готові тлумачення. Текст повертають лише кілька: ендпоінт чату, загальні прогнози, рашифал і PDF-звіти.

Здебільшого API поводиться так, як ви й очікуєте. Але ці три речі — інакше, і саме на них люди найчастіше гають час.

Багато ендпоінтів приймають масив keys — перелік потрібних розрахунків. Один виклик /api/astro/panchanga/ може повернути будь-який із 57 різних результатів, залежно від того, що ви попросите.

Усі вони разом коштують один кредит. Запитати все потрібне за один виклик — це дешевий шлях, а не дорогий. Помилка — викликати той самий ендпоінт п’ять разів заради п’яти ключів. На сторінці кожного ендпоінта є перелік його ключів, а в довіднику можна шукати і за маршрутом, і за назвою розрахунку. Тож потрібний розрахунок легко знайти, навіть не знаючи, у якому він ендпоінті.

{
  "date_time": "2026-09-16T06:00:00+05:30",
  "latitude": 26.9124,
  "longitude": 75.7873,
  "timezone_as_float": 5.5,
  "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
}

Кожна JSON-відповідь має ті самі чотири поля. Перевіряйте is_error, читайте data, а коли щось пішло не так, показуйте message: там названо поля з помилками, а не просто «некоректний запит».

{
  "data":     { ... },        // the result; shape varies by endpoint
  "status":   200,
  "is_error": false,
  "message":  "successful"
}

Успішний виклик коштує один кредит; два PDF-звіти й ендпоінт чату — 25. За 4xx, 5xx чи тайм-аут нічого не списується: кредит резервується перед розрахунком і повертається, якщо той не завершився успішно. Тож поки ви налагоджуєте інтеграцію, помилки в ній не з’їдять баланс.

Доступ надається за місячним або річним тарифом. Його квота оновлюється щомісяця, а невикористані виклики на наступний місяць не переносяться. Оплати за кожного користувача немає, а скасувати можна будь-коли. Кожна відповідь містить заголовки X-Credits-Charged і X-Credits-Remaining, тож баланс видно без окремого виклику.

Положення беруться з ефемерид NASA JPL: повний набір даних, 735 нерухомих зір, перевірено на проміжку від 500 до 2999 р. н. е. Медіанний час відповіді на сервері — 62 мс. Його виміряно на всіх опублікованих прикладах, а не на одному вдалому; повільні ендпоінти — це глибокі сканування, і в документації так і сказано.

Індійські традиції справді не сходяться щодо аянамші, тому API пропонує 48 варіантів і дає змогу підправити будь-який із точністю до градуса, хвилини й секунди. Обирати й пояснювати вибір своїм користувачам — вам. Ми не вирішуємо за вас, видаючи один варіант за єдино правильний.

Це розрахунки, а не поради. Ніщо з того, що повертає API, не є медичною, юридичною чи фінансовою консультацією, і, крім кількох ендпоінтів із текстовими відповідями, API не пише тлумачень. Якщо ваш продукт на цій основі щось радить, це ваше редакційне рішення. Що можна робити з результатами, читайте в ліцензії.

Базова URL-адреса — https://api.occultapi.com. Крім звичайного HTTP, є Playground для справжніх викликів із вашим ключем (невдалий виклик нічого не коштує), колекція Postman, специфікація OpenAPI 3.1 для генерування клієнта і MCP-сервер, через який ШІ-асистент викликає API напряму.