Introducción

El panchang y sus cinco elementos, el kundli y las cartas divisionales de la D2 a la D60, treinta sistemas de dasha, yogas y doshas, franjas de muhurat, ashtakavarga, fortaleza planetaria, compatibilidad de cartas, numerología en trece sistemas y once calendarios regionales con sus festivales.

Todo se calcula para la fecha, la hora y las coordenadas de tu solicitud; no hay un almanaque guardado. Casi todos los endpoints devuelven números y clasificaciones clásicas, no interpretaciones escritas. Unos pocos sí devuelven texto: el endpoint de chat, las predicciones generales, el rashifal y los informes en PDF.

Casi toda la API funciona como esperarías. Estas tres cosas no, y son las que más tiempo hacen perder.

Muchos endpoints aceptan un array keys en el que indicas qué cálculos quieres. Una sola llamada a /api/astro/panchanga/ puede devolver cualquiera de 57 resultados distintos, según lo que pidas.

Todos cuestan lo mismo: un solo crédito. Pedir todo lo que necesitas en una sola llamada es lo barato, no lo caro; el error es llamar cinco veces al mismo endpoint para cinco claves. Cada página de endpoint muestra sus claves válidas, y en la referencia puedes buscar por cálculo además de por ruta, así que encuentras lo que buscas sin saber qué endpoint lo calcula.

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

Todas las respuestas JSON tienen los mismos cuatro campos. Comprueba is_error, lee data y, si algo falla, muestra message: dice qué campos están mal, en vez de un simple «solicitud no válida».

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

Un crédito por llamada correcta; los dos informes en PDF y el endpoint de chat cuestan 25. Un 4xx, un 5xx o un tiempo de espera agotado no cuestan nada: el crédito se reserva antes del cálculo y se libera si este no termina bien. Mientras depuras, una integración con errores no puede vaciarte el saldo.

El acceso es mediante un plan mensual o anual. Su cuota se reinicia cada mes, y las llamadas que no hayas usado no se acumulan. No hay cobro por usuario y puedes cancelar cuando quieras. Cada respuesta trae las cabeceras X-Credits-Charged y X-Credits-Remaining, así que puedes seguir tu saldo sin hacer otra llamada.

Las posiciones salen de las efemérides del JPL de la NASA: el conjunto de datos completo, con 735 estrellas fijas, probado del año 500 al 2999 d. C. La mediana del tiempo de respuesta en el servidor es de 62 ms, medida con todos los ejemplos publicados y no con uno elegido a dedo. Los endpoints lentos son búsquedas exhaustivas, y así se indica en la documentación.

Las tradiciones indias no se ponen de acuerdo sobre el ayanamsa, así que la API ofrece 48 y te deja corregir cualquiera en grados, minutos y segundos. Elegir uno, y explicárselo a tus usuarios, te corresponde a ti. No vamos a decidirlo por ti dejando uno solo y llamándolo «el correcto».

Es cálculo, no consejo. Nada de lo que devuelve es asesoramiento médico, legal ni financiero y, salvo en los pocos endpoints que devuelven texto, no redacta interpretaciones. Si tu producto hace recomendaciones a partir de estos datos, es una decisión editorial tuya. Consulta la licencia para saber qué puedes hacer con los resultados.

La URL base es https://api.occultapi.com. Además de HTTP directo, tienes el Playground, que hace llamadas reales con tu clave (las que fallan no cuestan nada), una colección de Postman, una especificación OpenAPI 3.1 para generar un cliente y un servidor MCP para que un asistente de IA llame a la API directamente.