/api/astro/rashifal/1 creditRashifal forecasts
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.
https://yogataraapi.prahlad.app/api/astro/rashifal/Authentication
Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonRequest fields
| 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. |
Available keys (4)
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/`. |
Example request
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"]}'Response
{
"_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\": {\"education\": \"Intellectual pursuits will be rewarding. Focus on acquiring new skills.\", \"love\": \"Give space and respect boundaries in relationships.\", \"health\": \"Regular health check-ups are advised. Prevention is better than cure.\"}, \"aspects_hi\": {\"education\": \"बौद्धिक गतिविधियां लाभदायक रहेंगी। नए कौशल सीखने पर ध्यान दें।\", \"love\": \"रिश्तों में स्थान दें और सीमाओं का सम्मान करें।\", \"health\": \"नियमित स्वास्थ्य जांच की सलाह दी जाती है। रोकथाम इलाज से बेहतर है।\"}, \"lucky\": {\"color\": \"orange\", \"number\": 9, \"time\": \"Afternoon\", \"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\": 8}}, \"get_monthly_rashifal\": {\"month\": \"September\", \"month_hi\": \"सितंबर\", \"year\": 2026, \"sign\": \"Aries\", \"sign_hi\": \"मेष\", \"overview\": \"Sun enters Vir"
}Captured from a real call using the exact request above. Results sit under data, keyed by what you requested.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.