/api/astro/planet_insights/1 créditoLecturas de posiciones planetarias
Interpretaciones ya redactadas para un planeta en una posición concreta. Indica un planeta y dónde está (un signo zodiacal, una casa o un nakshatra) y obtendrás la lectura clásica de esa combinación. Es una consulta a un corpus de textos, no un cálculo: no intervienen fecha, hora ni lugar, y la misma solicitud devuelve siempre el mismo texto. Úsalo para rotular una carta que ya hayas calculado. Toma el signo, la casa y el nakshatra de Júpiter de `/api/astro/chart/` y luego llama a este endpoint para obtener el texto. Puedes pedir las tres claves en una sola llamada, pero cada una tiene su propio parámetro adicional, así que si pides las tres, el cuerpo debe incluir `planet`, `sign`, `house` y `nakshatra`. Cubre nueve planetas (los siete clásicos más Rahu y Ketu) en doce signos y doce casas. Solo hay lecturas por nakshatra para los siete planetas clásicos: Rahu y Ketu no tienen ninguna. Un planeta, signo, casa o nakshatra no reconocido devuelve una cadena explicativa con HTTP 200 en lugar de un error, así que comprueba el tipo de lo que recibes antes de mostrarlo.
https://api.occultapi.com/api/astro/planet_insights/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/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| house | integer | obligatorio | |
| keys | array | obligatorio | Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. |
| nakshatra | string | obligatorio | ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguniLa lista anterior es la que usan jupiter, mercury, venus y saturn. 'rahu' y 'ketu' no tienen ningún dato de nakshatra. Los valores que no coinciden devuelven "Invalid nakshatra: <x> for planet <p>" con HTTP 200. |
| planet | string | obligatorio | sunmoonmarsmercuryjupitervenussaturnrahuketuUn planeta desconocido devuelve la cadena "Invalid planet: <x>" con HTTP 200, no un estado de error. Ten en cuenta que rahu y ketu NO tienen datos de nakshatra (insights['rahu']['nakshatras'] is None), así que get_planet_nakshatra_insight devuelve "No nakshatra data available for rahu". |
| sign | string | obligatorio | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesERROR EN LOS DATOS que conviene documentar: para planet='sun' la clave está mal escrita como 'vigro' en lugar de 'virgo', así que sun+virgo devuelve "Invalid sign: virgo for planet sun" mientras que sun+vigro funciona. Los otros ocho planetas usan 'virgo'. |
Claves disponibles (3)
Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.
| Clave | Campos adicionales | Descripción |
|---|---|---|
| get_planet_house_insight | planet, house | La lectura de `planet` en una casa, donde `house` va de 1 a 12. Devuelve un objeto con la etiqueta de la casa, un resumen y listas de rasgos, además de `classicalTexts` (una lista de `{heading, text}` con citas de Parashara, Brihat Jataka, Saravali y Phaladipika sobre esa posición) y `houseLordVariations`, una lista de `{ascendent, aspect, result}` que indica cómo cambia la lectura para cada uno de los doce ascendentes. Algunos campos de resumen y de rasgos son null cuando solo existen las citas clásicas. |
| get_planet_nakshatra_insight | planet, nakshatra | La lectura de `planet` en `nakshatra`, como una o dos frases de texto plano y no como un objeto estructurado. Disponible para los siete planetas clásicos en los 27 nakshatras; Rahu y Ketu no tienen lecturas por nakshatra y devuelven una cadena explicativa. |
| get_planet_sign_insight | planet, sign | La lectura de `planet` en `sign`. Devuelve un objeto con `sign` (la etiqueta sánscrita de la combinación, como "Mesa Brhaspati"), un párrafo `summary` y las listas `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` y `drstiphala`; esta última recoge los efectos de los aspectos que lanza el planeta desde esa posición. Ten en cuenta el espacio en el nombre del campo `core traits`. |
Ejemplo de solicitud
curl -X POST https://api.occultapi.com/api/astro/planet_insights/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_planet_sign_insight"],"planet":"Jupiter","sign":"aries","house":0,"nakshatra":"rohini"}'Respuesta
{
"data": {
"get_planet_sign_insight": {
"sign": "Mesa Brhaspati",
"summary": "Jupiter in Aries produces a bold, authoritative, and resourceful individual with strong leadership capabilities. Aries is ruled by Mars (Maṅgala), a planet friendly to Jupiter and symbolizing courage, initiative, and battle-readiness. Jupiter here gains the spirit of a warrior-sage, combining spiritual strength with physical initiative. The placement enhances fame, wealth, power, and generational prosperity, especially through sons. However, the position also introduces difficulties like enemies, physical injuries, and excessive expenditures due to Aries being the debilitation sign for Saturn (Śani), whose tamasic qualities interfere with Jupiter's sattvic nature. The individual is splendorous, generous, and powerful, but also faces trials that temper their greatness",
"core traits": [
"Argumentative in disposition",
"Acquiring precious stones and ornaments through effort",
"Endowed with strength, sons, and wealth",
"Eminent and famous profession",
"Splendorous",
"Many enemies",
"Many expenses",
"Injured body",
"Confers severe and cruel punishments"
],
"psychologicalPhysicalTraits": [
"Argumentative in disposition",
"Acquiring precious stones and ornaments through effort",
"Endowed with strength, sons, and wealth",
"Eminent and famous profession",
"Splendorous",
"Many enemies",
"Many expenses",
"Injured body",
"Confers severe and cruel punishments",
"Love of grandeur",
"Powerful",
"Wealthy",
"Prudent",
"Many children",
"Courteous",
"Generous",
"Firm",
"Sympathetic",
"Happy marriage",
"Patient nature",
"Harmonious",
"Refined",
"High position"
],
"astrologicalReasoning": [
{
"heading": "Initiative & Argumentation",
"text": "Meṣa is ruled by Maṅgala, the god of war and action, endowing Jupiter with a strong fighting disposition and argumentative temperament."
},
{
"heading": "Wealth & Luxuries",
"text": "Sūrya, exalted in Meṣa, governs precious metals and gemstones. Jupiter, the Dhanakāraka, placed here results in acquiring valuables through effort."
},
{
"heading": "Progeny & Strength",
"text": "Meṣa is a masculine sign ruled by male planets (Sūrya and Maṅgala). Jupiter, as the Santana Kāraka, gains support here, indicating sons, strength, and vitality."
},
{
"heading": "Fame & Eminence",
"text": "As the 1st house of Kālapuruṣa, Aries governs fame. Jupiter's placement brings name, professional eminence, and public recognition."
},
{
"heading": "Drawbacks of the Sign",
"text": "Meṣa is Śani's debilitation sign. Jupiter here absorbs Śani's weaknesses, causing a rise in enemies (6H), injury-proneness, emotional detachment (due to 8H being Moon's debilitation), and heavy expenditure (12H effects)."
},
{
"heading": "Judgement & Harshness",
"text": "With Jupiter reflecting Maṅgala's and Śani's stern traits, the native may confer harsh or severe judgments lacking emotional nuance."
}
],
"drstiphala": [
{
"planet": "Sūrya",
"aspect": "positive",
"result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
},
{
"planet": "Candra",
"aspect": "positive",
"result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
},
{
"planet": "Maṅgala",
"aspect": "positive",
"result": "Belonging to a royal dynasty, fearless, fierce, endowed with political knowledge, modest, affluent, has a disobedient wife and disobedient servants."
},
{
"planet": "Budha",
"aspect": "negative",
"result": "Liar, crafty, sinful, skilful in detecting others' flaws, serves others, grateful, modest, not outspoken."
},
{
"planet": "Śukra",
"aspect": "positive",
"result": "Very happy with residences, sleeping comforts, robes, perfumes, garlands, ornaments, wife, very timid."
},
{
"planet": "Śani",
"aspect": "mixed",
"result": "Talkative, eloquent, devoid of happiness, brilliant, has mean children and a mean wife."
}
]
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data, cada uno bajo la clave que pediste.
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.