API Muhurta - selezione delle date favorevoli (elettrificazione astrale)

Last updated 7 nov 2026 Apri come Markdown Configurazione agente

Muhurta è l’astrologia elettiva vedica: la scelta del momento propizio per un evento importante. L’API scansiona ogni giorno nella tua finestra di ricerca, lo valuta in base al Panchanga all’alba (Tithi · Vara · Nakshatra · Yoga · Karana) per una specifica attività e restituisce i top-N giorni migliori con una spiegazione.

Come funziona

Scegli l’attività (una delle 12: elenco tramite /muhurta/types), la finestra di ricerca (fino a 90 giorni) e la località (l’alba è legata alle coordinate)
L’API calcola il Panchanga all’alba per ogni giorno e lo valuta secondo le regole classiche dell’attività (Muhurta Chintamani + B.V. Raman)
Risposta: top-N giorni, ordinati per score, con Panchanga, sotto-finestra Abhijit Muhurat e fattori di valutazione (why)

Endpoint

Endpoint	Metodo	Crediti	Scopo
`/v1/muhurta/types`	GET	0	Catalogo delle 12 attività (chiave + sanscrito + descrizione)
`/v1/vedic/muhurat/{activity}`	POST	Tier 3	Scansione della finestra per una singola attività → top-N giorni (JSON)
`/v1/reports/muhurta`	POST	Tier 7	Report pronto di date propizie - PDF (predefinito), HTML o Markdown (`format`)

12 attività

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.

Report

POST /v1/reports/muhurta restituisce un report A4 standard nello stesso modo degli altri /v1/reports/* - un rendering sincrono nella risposta: PDF per impostazione predefinita, format: "html" restituisce un HTML autonomo, format: "markdown" lo stesso documento in Markdown, entrambi senza archiviazione. La raccomandazione principale, un elenco classificato di giorni, il Panchanga di ogni giorno, Abhijit Muhurat e i fattori di valutazione come giustificazione. Supporta il white-label (logo/colori/font) per le chiavi associate all’account.

Esempio

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" or "markdown" returns the document itself)

Dating & Compatibility