/api/astro/dosha/1 créditoDoshas
Um dosha é uma aflição específica em um mapa natal — uma configuração planetária com nome próprio que os textos clássicos tratam como um fator de risco, quase sempre para casamento, saúde ou a linhagem ancestral. Este endpoint testa oito deles a partir do momento e do local do nascimento e pode retornar tanto os resultados brutos quanto explicações escritas prontas para exibição. Há duas formas de usá-lo. As chaves individuais (`kala_sarpa`, `manglik`, `pitru_dosha` e as demais) retornam resultados estruturados que você pode tratar no código. `get_dosha_details` retorna o conjunto inteiro como parágrafos HTML formatados, indexados pelo nome do dosha em inglês — ideal se você estiver renderizando um relatório; abrange Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata e Shrapit, mas não Ganda Moola. `get_dosha_resources` fornece o corpus de texto subjacente, caso você prefira montar o seu próprio texto. O serializador exige todos os campos booleanos e estruturados da requisição, mesmo para chaves que os ignoram. `manglik_reference_planet` é um índice de planeta (0 Sol, 1 Lua, 2 Marte, 3 Mercúrio, 4 Júpiter, 5 Vênus, 6 Saturno, 7 Rahu, 8 Ketu); o padrão do próprio motor, que mede a partir do ascendente, não pode ser selecionado pela API, porque o campo é tipado como inteiro. Neste endpoint, o campo de deslocamento UTC se chama `timezone`, e não `timezone_as_float`.
https://api.occultapi.com/api/astro/dosha/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 |
|---|---|---|---|
| apply_exceptions | boolean | obrigatório | |
| date_time | string (date-time) | obrigatório | O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes. Restrição de FORMATO. DRF DateTimeField: apenas ISO-8601 (formatos de entrada padrão do DRF), por exemplo "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sem fuso horário = assume-se UTC). |
| include_2nd_house | boolean | obrigatório | |
| include_lagna_house | boolean | 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. get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsArray de strings. 'manglik' requer manglik_reference_planet, include_lagna_house, include_2nd_house e apply_exceptions; 'ganda_moola' requer moon_star; 'get_dosha_details' requer date_time e geopos. |
| latitude | number (double) | obrigatório | Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -90 · max 90 |
| longitude | number (double) | obrigatório | Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180 |
| manglik_reference_planet | integer | obrigatório | |
| moon_star | string | obrigatório | Semanticamente, um NÚMERO de nakshatra no intervalo 1-27 (os nakshatras Ganda Moola são 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). Não é possível publicar uma lista funcional de valores aceitos enquanto essa incompatibilidade de tipos não for corrigida. |
| timezone | number (double) | obrigatório | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30). Equivale a timezone_as_float, nome que outros endpoints usam para o mesmo valor. |
Chaves disponíveis (10)
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 |
|---|---|---|
| ganda_moola | moon_star | Ganda Moola: indica se a estrela de nascimento é um dos seis nakshatras de junção (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). A ideia é receber o número do nakshatra, de 1–27, em `moon_star` e retornar um booleano, mas o campo é tipado como string, enquanto a lista de comparação contém inteiros; por isso, do jeito que está, a chave retorna false para qualquer entrada. |
| get_dosha_details | date_time, geopos | Todos os sete doshas narrativos, avaliados e redigidos de uma só vez: um objeto indexado pelo nome do dosha em inglês — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha e Shrapit Dosha —, cujos valores são fragmentos HTML que dizem se o dosha está presente e o que ele significa. O Ganda Moola não está incluído. Requer `date_time` e o local. |
| get_dosha_resources | — | O corpus completo dos textos explicativos dos doshas, como um objeto indexado pelo nome do dosha ('kala_sarpa', 'manglik', 'pitru', 'ghata' e assim por diante), com uma lista de parágrafos em inglês em cada um. A primeira entrada de cada lista é o texto para quando o dosha não existe, e as seguintes correspondem à casa ou à variedade envolvida. Use-o para montar o seu próprio texto em vez do HTML pronto. |
| ghata | — | Ghata Dosha: Marte e Saturno juntos no mesmo signo. Retorna um único booleano. |
| guru_chandala_dosha | — | Guru Chandala: Júpiter em conjunção com Rahu ou Ketu no mesmo signo. Retorna uma lista de dois elementos [se a combinação está presente, se Júpiter é o mais forte dos dois]. Ambos são false quando não há conjunção. |
| kala_sarpa | — | Kala Sarpa Dosha: true quando todos os sete planetas clássicos estão cercados entre Rahu e Ketu, de um mesmo lado do eixo nodal. Retorna um único booleano; a variedade (Ananta, Kulika, Vasuki e assim por diante) decorre da casa que Rahu ocupa. |
| kalathra | — | Kalathra Dosha, a aflição da casa do casamento. É true quando todos os maléficos naturais — Sol, Marte, Saturno, Rahu e Ketu — caem na 1ª, na 2ª, na 4ª, na 7ª, na 8ª ou na 12ª, contando a partir da sétima casa. Retorna um único booleano e, como exige que os cinco maléficos atendam à condição, raramente é true. |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Manglik, ou Mangal Dosha: se Marte cai em uma das casas que afligem o casamento, contadas a partir de `manglik_reference_planet`. Retorna uma lista de três elementos [se é manglik, se um cancelamento se aplica, os números das regras de cancelamento satisfeitas]. As casas testadas são a 4ª, a 7ª, a 8ª e a 12ª, mais a 2ª quando `include_2nd_house` é true e a 1ª quando `include_lagna_house` é true; os cancelamentos só são avaliados quando `apply_exceptions` é true. |
| pitru_dosha | — | Pitru Dosha, a aflição da linhagem ancestral. Retorna uma lista de dois elementos [true ou false, os números das regras que foram acionadas]. Cinco regras são testadas, nesta ordem: um luminar ou Rahu na 9ª, Ketu na 4ª, Sol/Lua/Rahu/Ketu aflitos por Marte ou Saturno, uma aglomeração de Mercúrio, Vênus e Rahu na 2ª, na 5ª, na 9ª ou na 12ª, e o Sol ou a Lua em conjunção com um nodo. |
| shrapit | — | Shrapit Dosha: Saturno e Rahu juntos no mesmo signo. Retorna um único booleano. |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_dosha_resources\": {\"kala_sarpa\": [\"There is no Kala Sarpa Dosha in this horoscope.\", \"Ananta Kala Sarpa Dosha- Rahu in 1st House and Ketu in 7th House. In this Dosha, Rahu is placed in the 1st house and Ketu in the 7th house in the horoscope. All planets are placed between Rahu-Ketu from the 1st house to the 7th house. This alignment can make a person ill-tempered and bring health issues. There would be problems in marital relationships, and, if in business, there would be a lack of support from partners.\", \"Kulik Kala Sarpa Dosha- Rahu in 2nd House and Ketu in 8th House. This Dosha is formed when Rahu is in the 2nd house and Ketu is in the 8th house, and all planets are between them. The individual afflicted may be vile-tongued and lead a life without the support of relatives. Monetary problems might surface, and savings might not be possible. The afflicted native may undergo surgery or accidents. There may be a possibility of unnatural death.\", \"Vasuki Kala Sarpa Dosha- Rahu in 3rd House and Ketu in 9th House. This Dosha is formed in the horoscope when Rahu and Ketu are in the 3rd, and 9th houses, respectively, and the remaining planets are hemmed between them. The afflicted individual may be timid in disposition and unable to fight for self-esteem. Relationships with younger siblings might not be good. Tide will go against the individual who may be unable to overcome adversity. The native can lack interest in religion, and luck may not favor them.\", \"Shankapal Kala Sarpa Dosha- Rahu in 4th House and Ketu in 10th House. This Dosha is formed when all planets are between Rahu and Ketu, which are placed from the 4th house to the 10th house. This alignment causes the native to have a bad relationship with the mother. The individual might not have mental peace and face professional problems.\", \"Padma Kala Sarpa Dosha- Rahu in 5th House and Ketu in 11th House. The axis of Rahu-Ketu from the 5th house to the 11th house and all planets within this axis cause this Dosha. The afflicted individual can face an issue with childbirth and education. They may have problems earning and may get into conflict with elder siblings.\", \"Mahapadma Kala Sarpa Dosha- Rahu in 6th House and Ketu in 12th House. The alignment of all planets in the Rahu-Ketu axis of the 6th house to the 12th house causes this Dosha. The afflicted individual can be dominated by enemies and lose money and property. The native could waste money, be unpopular, and have conflicts with in-laws.\", \"Takshak Kala Sarpa Dosha- Rahu in 7th House and Ketu in 1st House. The placement of all planets in the axis of Rahu-Ketu from the 7th house to the 1st house cause this Dosha. The afflicted may not go through marriage. If married, then the marriage might not go well. This Dosha can create a rift between the couple, leading to separation.\", \"Karakotak Kala Sarpa Dosha- Rahu in 8th House and Ketu in 2nd House. The placement of Rahu in the 8th house and Ketu in the 2nd house and the remaining planets in between them can cause this Dosha. The afflicted native might be ill-tempered and befriend anti-social elements. The native might have enemies and not be granted paternal wealth.\", \"Shankachood Kala Sarpa Dosha- Rahu in 9th House and Ketu in 3rd House. When Rahu is placed in the 9th house, Ketu in the 3rd house and all planets are between Rahu and Ketu; this Dosha is created in the horoscope. An afflicted individual might struggle a lot in life, and luck may never favor them. The individual may develop a habit of lying constantly and could be short-tempered.\", \"Ghatak Kala Sarpa Dosha- Rahu in 10th House and Ketu in 4th House. This Dosha is formed when Rahu is placed in the 10th house, Ketu in the 4th house, and all the planets are between the 10th to 4th houses. The afflicted individual may face many hurdles in his profession and conflicts with superiors at work. The individual may lack focus and face criticism. Relationships with family members may be poor. There may be de"
}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.