curl -X POST https://api.occultapi.com/api/astro/rashifal/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-09-01","rashi":"aries","keys":["get_daily_rashifal","get_weekly_rashifal","get_monthly_rashifal"]}'Rashifal é a coluna de horóscopo por signo: uma previsão escrita para todos os nascidos sob um dos doze signos lunares, sem nenhum mapa natal envolvido. Este endpoint gera quatro delas — diária, semanal, mensal e anual —, cada uma em inglês e em hindi na mesma resposta. A astronomia por trás é real e muda conforme a escala de tempo. As leituras diária e semanal seguem o trânsito real da Lua pelas casas contadas a partir do seu signo, além de qualquer estação real de Mercúrio, Vênus ou Marte que caia dentro da semana. A leitura mensal usa o sankranti do Sol, as estações de Mercúrio e Vênus e as mudanças de signo de Marte ao longo do mês; a anual usa os trânsitos de Júpiter, Saturno e Rahu-Ketu, além de uma flag simplificada de Sade Sati, só por signo, tirada da casa de Saturno em relação ao seu signo. Os textos associados a esses eventos, assim como a cor e o número da sorte, são escolhidos de conjuntos pré-escritos. Envie `rashi` como nome de signo e `date` como `YYYY-MM-DD`; a data é opcional e o padrão é hoje. A parte da data que conta depende da chave: a leitura semanal a trata como o primeiro dia da semana, a mensal usa só o mês e o ano, e a anual, só o ano. Todo campo de texto tem um gêmeo `_hi` com a versão em hindi. Como o cálculo é feito por signo, trate o resultado como um feed de conteúdo, e não como a leitura de um mapa. Para algo personalizado, calcule o mapa e use os endpoints de trânsito.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| 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. |
| date | string (date) | opcional | |
| rashi | string | opcional | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesValidado no construtor, então um valor inválido faz a requisição inteira falhar. |
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_daily_rashifal | rashi | A previsão de um dia para um signo lunar, determinada pelo trânsito real da Lua pelas casas contadas a partir desse signo. Retorna um objeto com `date`, `sign`, `element`, um parágrafo `general_prediction`, um objeto `aspects` com três ou quatro áreas da vida (família, saúde, viagens, carreira etc.), cada uma associada a uma frase, um objeto `lucky` no formato `{color, number, time}` e um objeto `moon_transit` no formato `{house, classification, benefic_support, malefic_pressure}`, em que `classification` é favorable, neutral ou challenging. Todo campo de texto tem um campo gêmeo `_hi` com a versão em hindi. | |
| get_monthly_rashifal | rashi | Uma previsão para o mês do calendário — apenas o mês e o ano de `date` são usados; o dia é ignorado. Determinada pelo sankranti do Sol, pelas estações de Mercúrio e Vênus e pelas mudanças de signo de Marte ao longo do mês. Retorna `month`, `year`, `sign`, um parágrafo `overview`, os objetos `planetary_transits` e `aspects`, `special_days`, que associa até cinco datas favoráveis a um motivo, e `remedies` como uma lista de duas sugestões. Cada um tem um campo gêmeo `_hi`. | |
| get_weekly_rashifal | rashi | Uma previsão de sete dias a partir de `date`, montada acompanhando o trânsito real da Lua em cada um dos sete dias e sinalizando qualquer estação real de Mercúrio, Vênus ou Marte dentro da semana. Retorna `week_start`, `week_end`, `sign`, `element`, um parágrafo `overview`, um objeto `aspects` indexado por "Weekday (date)" com uma frase para cada um dos sete dias, `best_days` e `challenging_days` como listas de datas, `planetary_alerts` como uma lista de avisos de estação e `lucky` como `{color, number}`. Cada um tem um campo gêmeo `_hi`. | |
| get_yearly_rashifal | rashi | Uma previsão para o ano civil — apenas o ano de `date` é usado. Determinada pelos trânsitos de Júpiter, Saturno e Rahu-Ketu, além de uma flag de Sade Sati e de Ashtama Shani, apenas por signo, obtida da casa de Saturno em relação ao signo (a 12ª, a 1ª ou a 2ª para Sade Sati, a 4ª ou a 8ª para Ashtama e Kantaka). Retorna `year`, `sign`, um parágrafo `overview`, `planetary_movements`, um `quarterly_forecast` dividido em quatro partes, `yearly_aspects`, `lucky_elements` e `remedies`. Cada campo de texto tem um campo gêmeo `_hi`. Como esta é uma aproximação no nível do signo, e não a leitura de um mapa natal, a flag de Sade Sati aqui é menos precisa que a de `/api/astro/shani_analysis/`. |