POST/api/astro/horoscope-match/1 crédito

Compatibilidad matrimonial

Compatibilidad matrimonial Ashtakoota completa a partir de los datos de nacimiento de dos personas, en lugar de dos números de estrella. Indica la fecha, la hora y el lugar de nacimiento de cada miembro de la pareja y el endpoint calcula por su cuenta el signo lunar, el nakshatra y el pada, puntúa los ocho kootas sobre 36, comprueba los dos doshas que bloquean la unión y devuelve un veredicto. La respuesta tiene cuatro partes. `boy` y `girl` resumen cada carta: signo lunar, nombre y número del nakshatra, pada, longitud de la Luna y signo ascendente. `gunas` es una lista de ocho objetos, uno por koota, cada uno con su `key` y su `label`, `max_points` y `obtained_points`, el `boy_value` y el `girl_value` que se comparan (el varna, el animal yoni, el gana, etc.), el `area_of_life` que rige y una `description` en inglés sencillo: basta para mostrar una tabla de resultados sin redactar ningún texto. Después vienen `total_score`, `max_score` (36) y `minimum_recommended_score` (18). Por último, `doshas`, `verdict` y `verdict_reason`. Una puntuación Nadi de cero activa el Nadi Dosha y una puntuación Bhakoot de cero activa el Bhakoot Dosha, y cualquiera de los dos hace que el veredicto sea 'Union is NOT Recommended', sea cual sea el total; si no, 28 o más es 'Union is Excellent', 18 o más es 'Union is Good', y por debajo de eso no se recomienda. Cada objeto de la pareja recibe `date_time`, `latitude`, `longitude` y `timezone_as_float`, además de las etiquetas opcionales `name` y `city`, que se devuelven sin cambios. Siempre se usa el ayanamsa Lahiri; el campo `ayanamsa` se acepta, pero no tiene efecto.

https://api.occultapi.com/api/astro/horoscope-match/

Probar solicitud

Autenticación

Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
boy	object	obligatorio	OBJETO con claves fijas: name (cadena, opcional, etiqueta de formato libre), date_time (obligatorio, ISO-8601), latitude (obligatorio, -89.9..89.9), longitude (obligatorio, -180..180), timezone_as_float (obligatorio, -12.0..14.0), city (cadena, opcional, etiqueta de formato libre). `name` y `city` no se validan y no afectan al cálculo.
girl	object	obligatorio	OBJETO: misma estructura y reglas que `boy`.
ayanamsa	string	opcional

Ejemplo de solicitud

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}}'

Respuesta

{
  "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
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.

Errores

Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.