Быстрый старт
Отправьте настоящий запрос, разберите настоящий ответ, а затем подключите API к своему коду. Неудачный вызов ничего не стоит.
1. Получите ключ
Зарегистрируйтесь и создайте ключ на странице ключей. Новым аккаунтам сразу начисляется 150 бесплатных кредитов. Их можно тратить на настоящий API с рабочим ключом — это не тестовая среда с выдуманными данными.
Ключ показывается один раз и хранится только в виде хеша, поэтому восстановить его мы не сможем — сразу сохраните его в менеджер секретов. Если потеряете, просто перевыпустите ключ, писать в поддержку не нужно.
2. Попробуйте в песочнице
Откройте песочницу, вставьте ключ, выберите эндпоинт и нажмите «Отправить». Это настоящие вызовы к рабочему API с вашим ключом; неудачный вызов ничего не стоит. Сделайте это до того, как писать код: уйдёт несколько секунд, и вы сразу увидите, есть ли в ответе то, что нужно вашему продукту.
3. Сделайте вызов
Все запросы — это POST с телом в JSON и заголовком X-API-Key для аутентификации. Вот запрос сегодняшней панчанги для Джайпура:
curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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"]
}'const response = await fetch(
"https://api.occultapi.com/api/astro/panchanga/",
{
method: "POST",
headers: {
"X-API-Key": process.env.OCCULT_API_KEY!,
"Content-Type": "application/json",
},
body: JSON.stringify({
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"],
}),
},
);
const body = await response.json();
if (body.is_error) throw new Error(body.message);
console.log(body.data);import os, requests
response = requests.post(
"https://api.occultapi.com/api/astro/panchanga/",
headers={"X-API-Key": os.environ["OCCULT_API_KEY"]},
json={
"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"],
},
)
body = response.json()
if body["is_error"]:
raise RuntimeError(body["message"])
print(body["data"])4. Разберите ответ
Все ответы приходят в одном формате. Проверяйте is_error; результат лежит в data под теми ключами, которые вы запросили.
{
"data": {
"tithi": {
"paksha": "Shukla",
"name": "Panchami",
"number": 5,
"start_time": "2026-09-15T02:15:17Z",
"end_time": "2026-09-16T03:30:28Z",
"remaining_time": { "hours": 3, "minutes": 0, "seconds": 28 }
},
"nakshatra_segments": [
{ "name": "Vishakha", "start_time": "2026-09-15T09:51:13.999999Z", "end_time": "2026-09-16T11:52:46.999999Z" },
{ "name": "Anuradha", "start_time": "2026-09-16T11:52:46.999999Z", "end_time": "2026-09-17T14:23:53.999999Z" }
],
"yogam": "Vaidhriti",
"karana": "Balava",
"vaara": "Mangalavara"
},
"status": 200,
"is_error": false,
"message": "successful"
}Структура полей у эндпоинтов разная. На большинстве страниц справочника показан реальный записанный ответ, а не придуманный; те немногие, что ещё не проверены, прямо об этом говорят.
5. Проверьте, сколько это стоило
Это видно в заголовках ответа — второй вызов не нужен:
X-Credits-Cost: 1
X-Credits-Charged: 1 # 0 on any error — you are billed for answers
X-Credits-Remaining: 149Запрашивайте несколько keys в одном запросе вместо нескольких запросов. Цена одна и та же, так что один вызов с пятью расчётами стоит в пять раз меньше, чем пять вызовов.
Не хотите писать обвязку?
Подключите ИИ-ассистента к нашему MCP-серверу: он сам найдёт эндпоинт, прочитает схему запроса и сделает вызов. Поиск и чтение документации кредитов не стоят. Если вы работаете с ИИ-агентом для кода, сначала дайте ему /agents. Чтобы сгенерировать типизированный клиент на любом языке, возьмите спецификацию OpenAPI.