Швидкий старт
Надішліть справжній запит, подивіться на справжню відповідь і підключіть API у свій код. Невдалий виклик нічого не коштує.
1. Отримайте ключ
Зареєструйтеся і створіть ключ на сторінці ключів. Кожен новий акаунт отримує 150 безкоштовних кредитів. Їх можна витрачати на справжній API з робочим ключем — це не пісочниця з окремими даними.
Ключ показується лише раз, а зберігаємо ми тільки його хеш, тож відновити ключ не зможемо. Одразу покладіть його в менеджер секретів. Якщо загубите — створіть новий замість старого, підтримка тут не допоможе.
2. Спробуйте в Playground
Відкрийте Playground, вставте ключ, виберіть ендпоінт і надішліть запит. Це справжні виклики до робочого 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.