/api/astro/karana_scan/1 créditoEscaneo de karanas
Un karana es medio tithi: seis grados de separación entre la Luna y el Sol, es decir, entre once y trece horas aproximadamente. Hay once: siete móviles, que se repiten ocho veces cada uno a lo largo del mes lunar, y cuatro fijos, que aparecen una sola vez. Vishti, normalmente llamado Bhadra, es el que se evita. Este endpoint encuentra todas las apariciones de un karana concreto a lo largo de un año del calendario, para que puedas crear una lista de «cuándo cae el próximo Vishti» sin recorrer el año día a día. Pasa karana_name escrito exactamente como en la lista del campo (distingue mayúsculas y minúsculas), year y timezone_as_float; la diferencia horaria marca dónde empieza y termina el año local. No hacen falta latitud ni longitud, porque el karana es una magnitud puramente lunar. La respuesta es {year, karana_name, rows}, donde rows es una lista cronológica de marcas de tiempo {start, end} en UTC. Un karana fijo da unas doce filas al año y uno móvil, cerca de cien. Para los karanas de un solo día, usa la clave karana_segments de /api/astro/panchanga/.
https://api.occultapi.com/api/astro/karana_scan/Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| karana_name | string | obligatorio | KimstughnaBavaBalavaKaulavaTaitulaGarajaVanijaVishtiShakuniChatushpadaNaga |
| timezone_as_float | number (double) | obligatorio | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. |
| year | integer | obligatorio | Año de nacimiento como número, p. ej., 1990. Cuatro dígitos. min 1800 · max 2400 |
Ejemplo de solicitud
curl -X POST https://api.occultapi.com/api/astro/karana_scan/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"karana_name":"Kimstughna","timezone_as_float":5.5,"year":2026}'Respuesta
{
"data": {
"year": 2026,
"karana_name": "Kimstughna",
"rows": [
{
"start": "2026-01-18T19:52:39+00:00",
"end": "2026-01-19T08:22:04+00:00"
},
{
"start": "2026-02-17T12:01:47+00:00",
"end": "2026-02-17T23:48:42+00:00"
},
{
"start": "2026-03-19T01:24:05+00:00",
"end": "2026-03-19T12:26:49+00:00"
},
{
"start": "2026-04-17T11:52:21+00:00",
"end": "2026-04-17T22:18:56+00:00"
},
{
"start": "2026-05-16T20:01:32+00:00",
"end": "2026-05-17T06:07:05+00:00"
},
{
"start": "2026-06-15T02:54:39+00:00",
"end": "2026-06-15T12:57:08+00:00"
},
{
"start": "2026-07-14T09:44:04+00:00",
"end": "2026-07-14T20:00:36+00:00"
},
{
"start": "2026-08-12T17:37:11+00:00",
"end": "2026-08-13T04:21:33+00:00"
},
{
"start": "2026-09-11T03:27:28+00:00",
"end": "2026-09-11T14:48:43+00:00"
},
{
"start": "2026-10-10T15:50:36+00:00",
"end": "2026-10-11T03:52:40+00:00"
},
{
"start": "2026-11-09T07:02:42+00:00",
"end": "2026-11-09T19:43:50+00:00"
},
{
"start": "2026-12-09T00:52:31+00:00",
"end": "2026-12-09T14:03:05+00:00"
}
]
},
"message": "successful",
"is_error": false
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.