curl -X POST https://yogataraapi.prahlad.app/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 is the sign-based horoscope column: a forecast written for everyone born under one of the twelve Moon signs, with no birth chart involved. This endpoint produces four of them — daily, weekly, monthly and yearly — each in English and Hindi in the same response. The astronomy underneath is real, and differs by timescale. The daily and weekly readings are driven by the Moon's actual transit through the houses counted from your sign, plus any genuine Mercury, Venus or Mars station falling inside the week. The monthly reading uses the Sun's sankranti, Mercury and Venus stations and Mars sign changes across the month; the yearly one uses Jupiter, Saturn and Rahu-Ketu transits plus a simplified sign-only Sade Sati flag taken from Saturn's house relative to your sign. The wording laid over those events, and the lucky colour and number, are selected from prewritten sets. Send `rashi` as a sign name and `date` as `YYYY-MM-DD`; the date is optional and defaults to today. Which part of the date matters depends on the key — the weekly reading treats it as the first day of the week, the monthly one takes only the month and year, and the yearly one only the year. Every text field has a `_hi` twin holding the Hindi rendering. Because this is sign-level, treat it as a content feed rather than a chart reading. For anything personalised, compute the chart and use the transit endpoints.
| Field | Type | Required | Notes |
|---|---|---|---|
| keys | array | required | Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls. |
| date | string (date) | optional | |
| rashi | string | optional | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesValidated in the constructor, so a bad value fails the whole request. |
Ask for exactly the calculations you want by listing them in keys. An unknown key rejects the whole request, and you are charged 1 credit however many you ask for — so batch them.
| Key | Extra fields needed | Description | |
|---|---|---|---|
| get_daily_rashifal | rashi | One day's forecast for a Moon sign, driven by the Moon's real transit through the houses counted from that sign. Returns an object with `date`, `sign`, `element`, a `general_prediction` paragraph, an `aspects` object holding three or four life areas (family, health, travel, career and so on) mapped to a sentence each, a `lucky` object of `{color, number, time}`, and a `moon_transit` object of `{house, classification, benefic_support, malefic_pressure}` where `classification` is favorable, neutral or challenging. Every text field has a `_hi` twin carrying the Hindi version. | |
| get_monthly_rashifal | rashi | A calendar-month forecast — only the month and year of `date` are used, the day is ignored. Driven by the Sun's sankranti, Mercury and Venus stations and Mars sign changes across the month. Returns `month`, `year`, `sign`, an `overview` paragraph, `planetary_transits` and `aspects` objects, `special_days` mapping up to five favourable dates to a reason, and `remedies` as a list of two suggestions. Each has a `_hi` twin. | |
| get_weekly_rashifal | rashi | A seven-day forecast starting from `date`, built by walking each of the seven days through the Moon's real transit and flagging any genuine Mercury, Venus or Mars station inside the week. Returns `week_start`, `week_end`, `sign`, `element`, an `overview` paragraph, an `aspects` object keyed by "Weekday (date)" with a sentence for each of the seven days, `best_days` and `challenging_days` as lists of dates, `planetary_alerts` as a list of station notices, and `lucky` as `{color, number}`. Each has a `_hi` twin. | |
| get_yearly_rashifal | rashi | A calendar-year forecast — only the year of `date` is used. Driven by Jupiter, Saturn and Rahu-Ketu transits, plus a sign-only Sade Sati and Ashtama Shani flag taken from Saturn's house relative to the sign (12th, 1st or 2nd for Sade Sati, 4th or 8th for Ashtama and Kantaka). Returns `year`, `sign`, an `overview` paragraph, `planetary_movements`, a `quarterly_forecast` broken into four parts, `yearly_aspects`, `lucky_elements` and `remedies`. Each text field has a `_hi` twin. Because this is a sign-level approximation and not a birth-chart reading, the Sade Sati flag here is coarser than `/api/astro/shani_analysis/`. |