Muhurta API - selectie van gunstige data (vedische elektieve astrologie)
Muhurta is Vedische electieve astrologie: de keuze van een gunstig moment voor een belangrijke gebeurtenis. De API scant elke dag in je zoekvenster, beoordeelt deze op basis van de Panchanga bij zonsopgang (Tithi · Vara · Nakshatra · Yoga · Karana) voor een specifieke activiteit en retourneert de top-N beste dagen met uitleg.
Hoe het werkt
Section titled “Hoe het werkt”- Kies een activiteit (één van de 12: lijst via
/muhurta/types), een zoekvenster (tot 90 dagen) en een locatie (zonsopgang is gekoppeld aan coördinaten) - De API berekent de Panchanga bij zonsopgang voor elke dag en beoordeelt deze volgens de klassieke activiteitsregels (Muhurta Chintamani + B.V. Raman)
- Antwoord: top-N dagen, gesorteerd op score, met Panchanga, het subvenster Abhijit Muhurat en beoordelingsfactoren (
why)
Endpoints
Section titled “Endpoints”| Endpoint | Methode | Kredieten | Doel |
|---|---|---|---|
/v1/muhurta/types | GET | 0 | Catalogus van 12 activiteiten (sleutel + Sanskriet + beschrijving) |
/v1/vedic/muhurat/{activity} | POST | Tier 3 | Scan van het venster voor één activiteit → top-N dagen (JSON) |
/v1/reports/muhurta | POST | Tier 7 | Klaar rapport met gunstige data - PDF (standaard), HTML of Markdown (format) |
12 activiteiten
Section titled “12 activiteiten”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.
Rapport
Section titled “Rapport”POST /v1/reports/muhurta retourneert een standaard A4-rapport op dezelfde manier als de rest van /v1/reports/* - een synchrone render in de respons: PDF standaard, format: "html" levert een zelfstandige HTML, format: "markdown" hetzelfde document in Markdown, beide zonder opslag. Topaanbeveling, een gerangschikte lijst van dagen, de Panchanga van elke dag, Abhijit Muhurat en beoordelingsfactoren als onderbouwing. Ondersteunt white-label (logo/kleuren/lettertype) voor sleutels die aan een account zijn gekoppeld.
Voorbeeld
Section titled “Voorbeeld”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)