API Muhurta - Séllection des dates favorables (astrologie électronique)
Muhurta est l’astrologie élective védique : le choix du moment propice pour un événement important. L’API scanne chaque jour dans ta fenêtre de recherche, l’évalue selon le Panchanga au lever du soleil (Tithi · Vara · Nakshatra · Yoga · Karana) pour une activité spécifique et renvoie les N meilleurs jours avec une explication.
Comment ça marche
Section intitulée « Comment ça marche »- Choisis une activité (une des 12 : liste via
/muhurta/types), une fenêtre de recherche (jusqu’à 90 jours) et une localisation (le lever du soleil est lié aux coordonnées) - L’API calcule le Panchanga au lever du soleil pour chaque jour et l’évalue selon les règles classiques de l’activité (Muhurta Chintamani + B.V. Raman)
- Réponse : les N meilleurs jours, triés par score, avec le Panchanga, la sous-fenêtre Abhijit Muhurat et les facteurs d’évaluation (
why)
Endpoints
Section intitulée « Endpoints »| Endpoint | Méthode | Crédits | Objectif |
|---|---|---|---|
/v1/muhurta/types | GET | 0 | Catalogue des 12 activités (clé + sanskrit + description) |
/v1/vedic/muhurat/{activity} | POST | Tier 3 | Scan de la fenêtre pour une activité → top-N jours (JSON) |
/v1/reports/muhurta | POST | Tier 7 | Rapport prêt de dates propices - PDF (par défaut), HTML ou Markdown (format) |
12 activités
Section intitulée « 12 activités »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.
POST /v1/reports/muhurta renvoie un rapport A4 standard de la même manière que les autres /v1/reports/* - un rendu synchrone dans la réponse : PDF par défaut, format: "html" renvoie un HTML autonome, format: "markdown" le même document en Markdown, les deux sans stockage. La meilleure recommandation, une liste classée des jours, le Panchanga de chaque jour, l’Abhijit Muhurat et les facteurs d’évaluation comme justification. Prend en charge le white-label (logo/couleurs/police) pour les clés liées au compte.
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)