/api/astro/planet_insights/1 créditoLeituras de posicionamento planetário
Interpretações pré-escritas para um único planeta em uma única posição. Informe um planeta e onde ele está — um signo do zodíaco, uma casa ou um nakshatra — e o endpoint retorna a leitura clássica dessa combinação. É uma consulta a um corpus de textos, não um cálculo: não há data, hora nem local envolvidos, e a mesma requisição sempre retorna o mesmo texto. Use-o para gerar os textos de um mapa que você já calculou. Pegue o signo, a casa e o nakshatra de Júpiter em `/api/astro/chart/` e depois chame este endpoint para obter o texto. As três chaves podem ser pedidas em uma única chamada, mas cada uma tem seu próprio parâmetro extra, então `planet`, `sign`, `house` e `nakshatra` precisam estar todos no corpo da requisição quando você pedir as três. A cobertura é de nove planetas (os sete mais Rahu e Ketu) em doze signos e doze casas. As leituras por nakshatra existem apenas para os sete planetas clássicos — Rahu e Ketu não têm nenhuma. Um planeta, signo, casa ou nakshatra não reconhecido volta como uma string explicativa com HTTP 200, e não como erro, então verifique o tipo que você recebeu antes de renderizá-lo.
https://api.occultapi.com/api/astro/planet_insights/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 |
|---|---|---|---|
| house | integer | obrigatório | |
| keys | array | obrigatório | Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas. |
| nakshatra | string | obrigatório | ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguniA lista acima é a usada por jupiter, mercury, venus e saturn. 'rahu' e 'ketu' não têm nenhum dado de nakshatra. Valores sem correspondência retornam "Invalid nakshatra: <x> for planet <p>" com HTTP 200. |
| planet | string | obrigatório | sunmoonmarsmercuryjupitervenussaturnrahuketuUm planeta desconhecido retorna a string "Invalid planet: <x>" com HTTP 200, não um status de erro. Observe que rahu e ketu NÃO têm dados de nakshatra (insights['rahu']['nakshatras'] é None), então get_planet_nakshatra_insight retorna "No nakshatra data available for rahu". |
| sign | string | obrigatório | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesBUG NOS DADOS que vale a pena documentar: para planet='sun', a chave está grafada incorretamente como 'vigro' em vez de 'virgo', então sun+virgo retorna "Invalid sign: virgo for planet sun", enquanto sun+vigro funciona. Todos os outros oito planetas usam 'virgo'. |
Chaves disponíveis (3)
Liste em keys só os cálculos que você quer. Uma chave desconhecida faz a requisição inteira ser rejeitada. O custo é 1 crédito, não importa quantas chaves você peça — então agrupe tudo numa chamada só.
| Chave | Campos extras exigidos | Descrição |
|---|---|---|
| get_planet_house_insight | planet, house | A leitura para `planet` posicionado em uma casa, sendo `house` de 1 a 12. Retorna um objeto com o rótulo da casa, um resumo e listas de características, além de `classicalTexts` — uma lista de `{heading, text}` que cita Parashara, Brihat Jataka, Saravali e Phaladipika sobre esse posicionamento — e `houseLordVariations`, uma lista de `{ascendent, aspect, result}` que mostra como a leitura muda para cada um dos doze ascendentes. Alguns dos campos de resumo e de características são null quando existem apenas as citações clássicas. |
| get_planet_nakshatra_insight | planet, nakshatra | A leitura para `planet` posicionado em `nakshatra`, retornada como uma ou duas frases de texto simples em vez de um objeto estruturado. Disponível para os sete planetas clássicos em todos os 27 nakshatras; Rahu e Ketu não têm leituras por nakshatra e, em vez disso, retornam uma string explicativa. |
| get_planet_sign_insight | planet, sign | A leitura para `planet` posicionado em `sign`. Retorna um objeto com `sign` (o rótulo em sânscrito para a combinação, como "Mesa Brhaspati"), um parágrafo `summary` e as listas `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` e `drstiphala`, esta última abrangendo os efeitos dos aspectos desse planeta a partir dali. Observe o espaço no nome do campo `core traits`. |
Exemplo de requisição
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"}'Resposta
{
"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"
}Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data, sob cada chave que você pediu.
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.