Introdução

O panchang e seus cinco elementos, o kundli e os mapas divisionais de D2 a D60, trinta sistemas de dasha, yogas e doshas, janelas de muhurat, ashtakavarga, força planetária, compatibilidade de mapas, numerologia em treze sistemas e onze calendários regionais com seus festivais.

Tudo é calculado para a data, a hora e as coordenadas da sua requisição. Não existe almanaque em cache. Quase todos os endpoints devolvem números e classificações clássicas, não interpretações por escrito. Só alguns devolvem texto: o endpoint de chat, as previsões gerais, o rashifal e os relatórios em PDF.

Quase toda a API funciona do jeito que você imagina. Estes três pontos, não — e são justamente eles que fazem as pessoas perderem tempo.

Muitos endpoints recebem um array keys com os cálculos que você quer. Uma única chamada a /api/astro/panchanga/ pode devolver qualquer um de 57 resultados diferentes, dependendo do que você pedir.

Todos custam o mesmo e único crédito. Pedir tudo o que você precisa numa chamada só é o caminho barato, não o caro — o erro é chamar o mesmo endpoint cinco vezes para cinco chaves. Cada página de endpoint lista as chaves válidas, e na referência você busca tanto por cálculo quanto por rota. Assim, encontra o recurso sem precisar saber em qual endpoint ele está.

{
  "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"]
}

Toda resposta JSON tem os mesmos quatro campos. Decida pelo is_error, leia data e, se algo der errado, mostre message — ele aponta os campos com problema, em vez de um genérico “requisição inválida”.

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

Um crédito por chamada bem-sucedida; os dois relatórios em PDF e o endpoint de chat custam 25. Um 4xx, um 5xx ou um timeout não custam nada: o crédito é reservado antes de o cálculo rodar e devolvido se ele não terminar sem erro. Uma integração com bug não consegue esvaziar seu saldo enquanto você a depura.

O acesso é por um plano mensal ou anual. A cota recomeça todo mês, e as chamadas que você não usou não passam para o mês seguinte. Não há cobrança por usuário, e você pode cancelar quando quiser. Toda resposta traz X-Credits-Charged e X-Credits-Remaining, então você acompanha o saldo sem uma segunda chamada.

As posições vêm dos dados de efemérides da NASA JPL — o conjunto completo, com 735 estrelas fixas, testado de 500 a 2999 d.C. O tempo mediano de resposta no servidor é de 62 ms, medido em todos os exemplos publicados, e não num exemplo escolhido a dedo. Os endpoints lentos são varreduras profundas, e a documentação diz isso.

As tradições indianas de fato divergem sobre o ayanamsa. Por isso a API oferece 48 deles e permite ajustar qualquer um em graus, minutos e segundos. A escolha — e a explicação para os seus usuários — fica com você. Não decidimos por você entregando um só e dizendo que é o correto.

Ela faz cálculos, não dá conselhos. Nada do que ela devolve é orientação médica, jurídica ou financeira e, fora os poucos endpoints que devolvem texto, ela não escreve interpretações. Se o seu produto faz sugestões a partir desses dados, a decisão editorial é sua — veja na licença o que você pode fazer com os resultados.

A URL base é https://api.occultapi.com. Além do HTTP puro, você tem um Playground que faz chamadas reais com a sua chave (chamada que falha não custa nada), uma coleção do Postman, uma especificação OpenAPI 3.1 para gerar um cliente e um servidor MCP para um assistente de IA chamar a API direto.