/api/astro/horoscope-match/1 créditCompatibilité de mariage
La compatibilité de mariage Ashtakoota complète, à partir de deux fiches de naissance plutôt que de deux numéros de nakshatra. Indiquez la date, l’heure et le lieu de naissance de chaque partenaire : l’endpoint détermine lui-même le signe lunaire, le nakshatra et le pada, note les huit kootas sur 36, vérifie les deux doshas bloquants et renvoie un verdict. La réponse comporte quatre parties. `boy` et `girl` résument chaque thème : signe lunaire, nom et numéro du nakshatra, pada, longitude de la Lune et signe ascendant. `gunas` est une liste de huit objets, un par koota, chacun avec sa `key` et son `label`, `max_points` et `obtained_points`, les valeurs comparées `boy_value` et `girl_value` (le varna, l’animal de la yoni, le gana, etc.), le domaine de vie qu’il régit (`area_of_life`) et une `description` en anglais courant — de quoi produire un tableau de résultats sans rédiger le moindre texte. Viennent ensuite `total_score`, `max_score` de 36 et `minimum_recommended_score` de 18. Enfin `doshas`, `verdict` et `verdict_reason`. Un score Nadi de zéro déclenche le Nadi Dosha et un score Bhakoot de zéro le Bhakoot Dosha, et l’un ou l’autre donne le verdict 'Union is NOT Recommended' quel que soit le total ; sinon, 28 ou plus donne 'Union is Excellent', 18 ou plus 'Union is Good', et en dessous l’union n’est pas recommandée. Chaque objet partenaire prend `date_time`, `latitude`, `longitude` et `timezone_as_float`, plus les libellés facultatifs `name` et `city`, renvoyés tels quels. L’ayanamsa Lahiri est toujours utilisé ; le champ `ayanamsa` est accepté mais sans effet.
https://api.occultapi.com/api/astro/horoscope-match/Authentification
Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonChamps de la requête
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| boy | object | obligatoire | OBJET à clés fixes : name (chaîne, facultatif, libellé libre), date_time (obligatoire, ISO-8601), latitude (obligatoire, -89.9..89.9), longitude (obligatoire, -180..180), timezone_as_float (obligatoire, -12.0..14.0), city (chaîne, facultatif, libellé libre). `name` et `city` ne sont pas validés et n’ont aucun effet sur le calcul. |
| girl | object | obligatoire | OBJET - même structure et mêmes règles que `boy`. |
| ayanamsa | string | facultatif |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/horoscope-match/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"boy":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5},"girl":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}}'Réponse
{
"data": {
"boy": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"girl": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"gunas": [
{
"key": "varna",
"label": "Varna",
"max_points": 1,
"obtained_points": 1,
"boy_value": "Brahmin",
"girl_value": "Brahmin",
"area_of_life": "Obedience",
"description": "Varna Kuta is assigned 1 point. It represents mutual love, comfort and obedience - the spiritual compatibility between the couple."
},
{
"key": "vashya",
"label": "Vashya",
"max_points": 2,
"obtained_points": 2,
"boy_value": "Chatushpada",
"girl_value": "Chatushpada",
"area_of_life": "Mutual Control",
"description": "Vashya Kuta is assigned 2 points. It represents mutual control or dominance, along with friendship and amenability between the couple."
},
{
"key": "tara",
"label": "Tara",
"max_points": 3,
"obtained_points": 3,
"boy_value": "Sampat",
"girl_value": "Sampat",
"area_of_life": "Luck",
"description": "Tara Kuta is assigned 3 points. It represents luck, auspiciousness and the transmission of mutual well-being between the couple."
},
{
"key": "yoni",
"label": "Yoni",
"max_points": 4,
"obtained_points": 4,
"boy_value": "Horse",
"girl_value": "Horse",
"area_of_life": "Sexual Aspects",
"description": "Yoni Kuta is assigned 4 points. It represents sexual aspects, including compatibility of intimate temperament."
},
{
"key": "maitri",
"label": "Maitri",
"max_points": 5,
"obtained_points": 5,
"boy_value": "Mars",
"girl_value": "Mars",
"area_of_life": "Affection",
"description": "Maitri (Graha Maitri) Kuta is assigned 5 points. It represents psychological disposition, mental qualities and affection between the couple."
},
{
"key": "gana",
"label": "Gana",
"max_points": 6,
"obtained_points": 6,
"boy_value": "Deva",
"girl_value": "Deva",
"area_of_life": "Nature",
"description": "Gana Kuta is assigned 6 points. It represents nature, temperament, longevity, wealth and love."
},
{
"key": "bhakoot",
"label": "Bhakoot",
"max_points": 7,
"obtained_points": 7,
"boy_value": "Mesha",
"girl_value": "Mesha",
"area_of_life": "Love",
"description": "Bhakoot (Rashi) Kuta is assigned 7 points. It represents children, wealth, comfort, good luck and growth of the family."
},
{
"key": "nadi",
"label": "Nadi",
"max_points": 8,
"obtained_points": 0,
"boy_value": "Aadi",
"girl_value": "Aadi",
"area_of_life": "Health",
"description": "Nadi Kuta is assigned 8 points, the most important of all. It represents temperament, health, and genetic compatibility for progeny."
}
],
"total_score": 28,
"max_score": 36,
"minimum_recommended_score": 18,
"doshas": [
"Nadi Dosha"
],
"verdict": "Union is NOT Recommended",
"verdict_reason": "due to Nadi Dosha"
},
"message": "successful",
"is_error": false
}Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.
Erreurs
Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.