/api/astro/horoscope-match/1 кредитСовместимость для брака
Полная оценка совместимости для брака по ашта-куте по данным рождения двух партнёров, а не по двум номерам накшатр. Передайте дату, время и место рождения каждого партнёра, и эндпоинт сам определит лунный знак, накшатру и паду, подсчитает баллы по восьми кутам (максимум 36), проверит две блокирующие доши и вынесет вердикт. Ответ состоит из четырёх частей. `boy` и `girl` кратко описывают каждую карту: лунный знак, название и номер накшатры, пада, долгота Луны и знак асцендента. `gunas` — список из восьми объектов, по одному на куту; у каждого есть `key` и `label`, `max_points` и `obtained_points`, сравниваемые `boy_value` и `girl_value` (варна, животное йони, гана и т. д.), сфера жизни `area_of_life`, за которую отвечает кута, и понятное описание на английском `description`. Этого достаточно, чтобы вывести таблицу результатов, не сочиняя текст. Затем идут `total_score`, `max_score` (36) и `minimum_recommended_score` (18). Наконец, `doshas`, `verdict` и `verdict_reason`. Ноль баллов по нади даёт нади-дошу, ноль по бхакуту — бхакут-дошу, и любая из них делает вердикт 'Union is NOT Recommended' независимо от суммы; в остальных случаях 28 и больше — 'Union is Excellent', 18 и больше — 'Union is Good', а ниже брак не рекомендуется. Каждый объект партнёра принимает `date_time`, `latitude`, `longitude` и `timezone_as_float`, а также необязательные метки `name` и `city`, которые возвращаются в ответе без изменений. Всегда используется аянамша Lahiri; поле `ayanamsa` принимается, но ни на что не влияет.
https://api.occultapi.com/api/astro/horoscope-match/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| boy | object | обязательный | ОБЪЕКТ с фиксированными ключами: name (строка, необязательно, произвольная метка), date_time (обязательно, ISO-8601), latitude (обязательно, -89.9..89.9), longitude (обязательно, -180..180), timezone_as_float (обязательно, -12.0..14.0), city (строка, необязательно, произвольная метка). `name` и `city` не проверяются и не влияют на расчёт. |
| girl | object | обязательный | ОБЪЕКТ — та же структура и те же правила, что у `boy`. |
| ayanamsa | string | необязательный |
Пример запроса
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}}'Ответ
{
"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
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.