POSThttps://api.occultapi.com/api/astro/planet_insights/

Lecturas de posiciones planetarias

Cuerpo de la solicitudJSON

Pega una clave de API arriba para enviarla.

Fragmento de código

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

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.

Campos 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 phalguni` La 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	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Un 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	`ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces` ERROR 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`.

Referencia completa de este endpoint