Primeiros passos
Envie uma requisição real, veja a resposta real e depois leve isso para o seu código. Chamada que falha não custa nada.
1. Gere uma chave
Crie uma conta e gere uma chave na página de chaves. Toda conta nova começa com 150 créditos grátis para usar na API real, com uma chave de produção — nada de sandbox com dados próprios.
A chave aparece uma única vez e fica guardada só como hash, então não temos como recuperá-la para você. Coloque-a direto no seu gerenciador de segredos. Se perder, faça a rotação em vez de pedir ao suporte.
2. Teste no Playground
Abra o Playground, cole sua chave, escolha um endpoint e clique em enviar. Ele faz chamadas reais à API de produção com a sua chave; chamada que falha não custa nada. Faça isso antes de escrever qualquer código: leva segundos e mostra se a resposta tem o que o seu produto precisa.
3. Faça a chamada
Tudo é POST com corpo JSON, autenticado pelo cabeçalho X-API-Key. Esta requisição pede o panchang de hoje em Jaipur:
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. Leia a resposta
Toda resposta usa o mesmo envelope. Decida pelo is_error; o resultado fica em data, sob as chaves que você pediu.
{
"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"
}O formato dos campos muda de endpoint para endpoint. A maioria das páginas da referência mostra uma resposta real capturada, não uma inventada; as poucas ainda não verificadas avisam isso.
5. Veja quanto custou
Os cabeçalhos da resposta já dizem, sem precisar de uma segunda chamada:
X-Credits-Cost: 1
X-Credits-Charged: 1 # 0 on any error — you are billed for answers
X-Credits-Remaining: 149Peça várias keys numa só requisição em vez de fazer várias requisições. O preço é o mesmo, então uma chamada com cinco cálculos custa um quinto de cinco chamadas.
Prefere não escrever a integração na mão?
Conecte um assistente de IA ao nosso servidor MCP: ele busca os endpoints, lê o schema da requisição e faz a chamada sozinho — buscar e ler a documentação não gasta créditos. Se você trabalha com um agente de código, entregue /agents a ele antes de tudo. Para gerar um cliente tipado em qualquer linguagem, use a especificação OpenAPI.