/api/astro/rashifal/1 créditoPrevisões do 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.
https://api.occultapi.com/api/astro/rashifal/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 |
|---|---|---|---|
| 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. |
Chaves disponíveis (4)
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/`. |
Exemplo de requisição
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"]}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_daily_rashifal\": {\"date\": \"01 September 2026\", \"date_hi\": \"1 सितंबर 2026\", \"sign\": \"Aries\", \"sign_hi\": \"मेष\", \"element\": \"Fire\", \"element_hi\": \"अग्नि\", \"general_prediction\": \"The Moon transits your 1st house today, bringing a mixed focus on your personality and overall energy.\", \"general_prediction_hi\": \"आज चंद्रमा आपके पहले भाव में गोचर कर रहा है, जिससे आपके व्यक्तित्व और समग्र ऊर्जा पर मिश्रित प्रभाव पड़ रहा है।\", \"aspects\": {\"love\": \"Avoid making major relationship decisions based on temporary emotions.\", \"career\": \"Routine work might feel monotonous. Find creative ways to stay engaged.\", \"health\": \"Moderate exercise will help maintain energy levels.\"}, \"aspects_hi\": {\"love\": \"क्षणिक भावनाओं के आधार पर बड़े रिश्ते संबंधी निर्णय लेने से बचें।\", \"career\": \"नियमित कार्य नीरस लग सकता है। जुड़े रहने के लिए रचनात्मक तरीके खोजें।\", \"health\": \"मध्यम व्यायाम ऊर्जा स्तर बनाए रखने में मदद करेगा।\"}, \"lucky\": {\"color\": \"red\", \"number\": 8, \"time\": \"Morning\", \"time_hi\": \"सुबह\"}, \"moon_transit\": {\"house\": 1, \"classification\": \"neutral\", \"classification_hi\": \"मिश्रित\", \"benefic_support\": [], \"malefic_pressure\": []}}, \"get_weekly_rashifal\": {\"week_start\": \"01 September 2026\", \"week_start_hi\": \"1 सितंबर 2026\", \"week_end\": \"07 September 2026\", \"week_end_hi\": \"7 सितंबर 2026\", \"sign\": \"Aries\", \"sign_hi\": \"मेष\", \"element\": \"Fire\", \"element_hi\": \"अग्नि\", \"overview\": \"Your best day(s) this week: Saturday (05 September), Sunday (06 September), with the Moon in favorable houses for courage, communication and short journeys. Be a little more careful on Monday (07 September) — the Moon moves through a more challenging house those days.\", \"overview_hi\": \"इस सप्ताह आपके सर्वश्रेष्ठ दिन: शनिवार (5 सितंबर), रविवार (6 सितंबर), जब चंद्रमा साहस, संचार और छोटी यात्राओं के लिए अनुकूल भावों में रहेगा। सोमवार (7 सितंबर) को थोड़ी अधिक सावधानी बरतें — इन दिनों चंद्रमा एक चुनौतीपूर्ण भाव से गोचर करेगा।\", \"aspects\": {\"Tuesday (01 September 2026)\": \"Mixed — Moon in your 1st house, focus on your personality and overall energy.\", \"Wednesday (02 September 2026)\": \"Mixed — Moon in your 1st house, focus on your personality and overall energy.\", \"Thursday (03 September 2026)\": \"Mixed — Moon in your 2nd house, focus on finances and family matters.\", \"Friday (04 September 2026)\": \"Mixed — Moon in your 2nd house, focus on finances and family matters.\", \"Saturday (05 September 2026)\": \"Favorable — Moon in your 3rd house, focus on courage, communication and short journeys.\", \"Sunday (06 September 2026)\": \"Favorable — Moon in your 3rd house, focus on courage, communication and short journeys.\", \"Monday (07 September 2026)\": \"Challenging — Moon in your 4th house, focus on home and emotional wellbeing.\"}, \"aspects_hi\": {\"मंगलवार (1 सितंबर 2026)\": \"मिश्रित — चंद्रमा आपके पहले भाव में, ध्यान केंद्रित रहेगा आपके व्यक्तित्व और समग्र ऊर्जा पर।\", \"बुधवार (2 सितंबर 2026)\": \"मिश्रित — चंद्रमा आपके पहले भाव में, ध्यान केंद्रित रहेगा आपके व्यक्तित्व और समग्र ऊर्जा पर।\", \"गुरुवार (3 सितंबर 2026)\": \"मिश्रित — चंद्रमा आपके दूसरे भाव में, ध्यान केंद्रित रहेगा धन और पारिवारिक मामलों पर।\", \"शुक्रवार (4 सितंबर 2026)\": \"मिश्रित — चंद्रमा आपके दूसरे भाव में, ध्यान केंद्रित रहेगा धन और पारिवारिक मामलों पर।\", \"शनिवार (5 सितंबर 2026)\": \"अनुकूल — चंद्रमा आपके तीसरे भाव में, ध्यान केंद्रित रहेगा साहस, संचार और छोटी यात्राओं पर।\", \"रविवार (6 सितंबर 2026)\": \"अनुकूल — चंद्रमा आपके तीसरे भाव में, ध्यान केंद्रित रहेगा साहस, संचार और छोटी यात्राओं पर।\", \"सोमवार (7 सितंबर 2026)\": \"चुनौतीपूर्ण — चंद्रमा आपके चौथे भाव में, ध्यान केंद्रित रहेगा घर और भावनात्मक कल्याण पर।\"}, \"best_days\": [\"05 September 2026\", \"06 September 2026\"], \"best_days_hi\": [\"5 सितंबर 2026\", \"6 सितंबर 2026\"], \"challenging_days\": [\"07 September 2026\"], \"challenging_days_hi\": [\"7 सितंबर 2026\"], \"planetary_alerts\": [], \"planetary_alerts_hi\": [], \"lucky\": {\"color\": \"red\", \"number\": 1}}, \"get_monthly_rashifal\": {\"month\": \"September\", \"month_hi\": \"सितंबर\", \"year\": 2026, \"sign\": \"Aries\", \"sign_hi\": \"मेष\", \"overview\": \"Sun enters Virgo "
}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.