/api/astro/horoscope-match/1 créditoCompatibilidade para casamento
Compatibilidade Ashtakoota completa para casamento a partir de dois registros de nascimento, e não de dois números de estrela. Informe a data, a hora e o local de cada parceiro, e o endpoint calcula sozinho o signo lunar, o nakshatra e o pada, pontua os oito kootas em um total de 36, verifica os dois doshas impeditivos e retorna um veredito. A resposta tem quatro partes. `boy` e `girl` resumem cada mapa: signo lunar, nome e número do nakshatra, pada, longitude da Lua e signo ascendente. `gunas` é uma lista de oito objetos, um por koota, cada um com `key` e `label`, `max_points` e `obtained_points`, o `boy_value` e o `girl_value` comparados (o varna, o animal yoni, o gana e assim por diante), a `area_of_life` que ele rege e uma `description` em inglês simples — o suficiente para montar uma tabela de resultados sem escrever nenhum texto. Depois vêm `total_score`, `max_score` igual a 36 e `minimum_recommended_score` igual a 18. Por fim, `doshas`, `verdict` e `verdict_reason`. Uma pontuação zero em Nadi gera o Nadi Dosha, e uma pontuação zero em Bhakoot gera o Bhakoot Dosha; qualquer um dos dois torna o veredito 'Union is NOT Recommended', seja qual for o total. Fora isso, 28 ou mais é 'Union is Excellent', 18 ou mais é 'Union is Good', e abaixo disso a união não é recomendada. Cada objeto de parceiro recebe `date_time`, `latitude`, `longitude` e `timezone_as_float`, além dos rótulos opcionais `name` e `city`, que voltam na resposta sem alterações. O ayanamsa Lahiri é sempre usado; o campo `ayanamsa` é aceito, mas não tem efeito.
https://api.occultapi.com/api/astro/horoscope-match/Autenticação
Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos da requisição
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| boy | object | obrigatório | OBJETO com chaves fixas: name (string, opcional, rótulo em formato livre), date_time (obrigatório, ISO-8601), latitude (obrigatório, -89.9..89.9), longitude (obrigatório, -180..180), timezone_as_float (obrigatório, -12.0..14.0), city (string, opcional, rótulo em formato livre). `name` e `city` não são validados e não afetam o cálculo. |
| girl | object | obrigatório | OBJETO - mesmo formato e mesmas regras de `boy`. |
| ayanamsa | string | opcional |
Exemplo de requisição
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}}'Resposta
{
"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
}Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.
Erros
Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.