API Muhurta - Selección de fechas favorables (astrología electiva vedica)
Muhurta es una astrología electiva védica: la elección del momento propicio para un evento importante. La API escanea cada día en tu ventana de búsqueda, lo evalúa según la Pañcanga al amanecer (Tithi · Vara · Nakshatra · Yoga · Karana) para la actividad concreta y devuelve los top‑N mejores días con explicación.
Cómo funciona
Sección titulada «Cómo funciona»- Elige actividad (una de las 12: lista a través de
/muhurta/types), ventana de búsqueda (hasta 90 días) y ubicación (el amanecer vinculado a coordenadas) - La API calcula la Pañcanga al amanecer para cada día y lo evalúa según las reglas clásicas de la actividad (Muhurta Chintamani + B.V. Raman)
- Respuesta: top‑N días, ordenados por score, con la Pañcanga, sub‑ventana Abhijit Muhurat y los factores de evaluación (
why)
Endpoints
Sección titulada «Endpoints»| Endpoint | Method | Credits | Purpose |
|---|---|---|---|
/v1/muhurta/types | GET | 0 | Catálogo de 12 actividades (clave + sánscrito + descripción) |
/v1/vedic/muhurat/{activity} | POST | Tier 3 | Escaneo de ventana para una actividad → top‑N días (JSON) |
/v1/reports/muhurta | POST | Tier 7 | Informe listo de fechas favorables - PDF (por defecto) o HTML (?format=html) |
12 actividades
Sección titulada «12 actividades»marriage (Vivah) · vehicle-purchase (Vahana) · business-start (Vyapara) · travel (Yatra) · naming-ceremony (Namkaran) · surgery (Shastrakarma) · education-start (Vidyarambha) · investment (Dhana Sthapana) · property-purchase (Griha Pravesh) · journey-long · name-change · general-auspicious.
Informe
Sección titulada «Informe»POST /v1/reports/muhurta devuelve informe estándar A4 de la misma manera que el resto de /v1/reports/* - renderizado síncrono en la respuesta: PDF por defecto, ?format=html entrega HTML sin renderizado. Recomendación principal, lista ordenada de días, Pañcanga de cada día, Abhijit Muhurat y factores de evaluación como justificación. Soporta white‑label (logotipo/colores/fuente) para claves vinculadas a la cuenta.
Ejemplo
Sección titulada «Ejemplo»curl -X POST https://api.astroway.info/v1/reports/muhurta \ -H "X-Api-Key: aw_live_..." \ -H "Content-Type: application/json" \ -d '{ "activity": "marriage", "search_window_start": "2026-07-01", "search_window_end": "2026-07-31", "latitude": 28.61, "longitude": 77.21, "timezoneOffset": 5.5, "topN": 5 }'# → { "url": "https://api.astroway.info/reports/…-muhurta.pdf", "page_count": 3, "expires_at": "…" }# (?format=html повертає HTML напряму)