Inicio rápido

Envía una solicitud real, mira la respuesta y después intégrala en tu código. Las llamadas que fallan no cuestan nada.

1. Consigue una clave

Crea una cuenta y genera una clave en la página de claves. Las cuentas nuevas empiezan con 150 créditos gratis para gastar en la API real con una clave de producción, no en un sandbox con datos de prueba.

La clave se muestra una sola vez y solo guardamos su hash, así que no podemos recuperarla por ti. Guárdala enseguida en tu gestor de secretos. Si la pierdes, rótala; no hace falta escribir a soporte.

2. Pruébala en el Playground

Abre el Playground, pega tu clave, elige un endpoint y pulsa Enviar. Hace llamadas reales a la API en producción con tu propia clave, y las que fallan no cuestan nada. Hazlo antes de escribir código: en unos segundos sabrás si la respuesta trae lo que necesita tu producto.

3. Haz la llamada

Todas las llamadas son un POST con un cuerpo JSON y se autentican con la cabecera X-API-Key. Esta pide el panchang de hoy en Jaipur:

curl

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

TypeScript

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);

Python

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. Lee la respuesta

Todas las respuestas tienen la misma estructura. Comprueba is_error; el resultado está en data, con una entrada por cada cosa que pediste.

Respuesta

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

Los campos cambian según el endpoint. En la referencia, la mayoría de las páginas muestran una respuesta real capturada, no una inventada; las pocas que aún no están verificadas lo indican.

5. Mira cuánto te ha costado

Te lo dicen las cabeceras de la respuesta, sin necesidad de otra llamada:

X-Credits-Cost:      1
X-Credits-Charged:   1     # 0 on any error — you are billed for answers
X-Credits-Remaining: 149

Pide varias keys en una sola solicitud en lugar de hacer varias solicitudes. El precio es el mismo, así que una llamada con cinco cálculos cuesta la quinta parte que cinco llamadas.

¿Prefieres no programar la integración?

Conecta un asistente de IA a nuestro servidor MCP: podrá buscar endpoints, leer el esquema de una solicitud y hacer la llamada por su cuenta. Buscar y leer la documentación no cuesta créditos. Si trabajas con un agente de programación, pásale primero /agents. Para generar un cliente tipado en cualquier lenguaje, usa la especificación OpenAPI.