Weekly Horoscope¶
The Weekly Horoscope endpoint provides a comprehensive astrological reading for the week based on the user's date of birth.
It automatically determines the zodiac sign and returns insights for the upcoming week.
Ideal for weekly planning, astrology apps, dashboards, or personal guidance.
Endpoint¶
| Method | Path |
|---|---|
GET | https://the-numerology-api.p.rapidapi.com/horoscope/weekly |
POST | https://the-numerology-api.p.rapidapi.com/horoscope/weekly |
Query Parameters¶
| Name | Required | Type | Example | Description |
|---|---|---|---|---|
dob | ✅ | String | 2002-02-22 | The user's date of birth (YYYY-MM-DD). Used to determine zodiac sign automatically. |
Note
Accepts both GET and POST requests.
If the dob is invalid or missing, a 400 error is returned.
Zodiac sign calculation uses the tropical astrology system.
Example Requests¶
GET Request¶
curl -X GET "https://the-numerology-api.p.rapidapi.com/horoscope/weekly?dob=2002-02-22" \
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"
POST Request¶
curl -X POST "https://the-numerology-api.p.rapidapi.com/horoscope/weekly" \
-H "Content-Type: application/json" \
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
-d '{
"dob": "2002-02-22"
}'
Example Response¶
{
"horoscope": "Oct 27, 2025 - Nov 2, 2025\n- It wouldn’t be surprising if you felt inspired and confident when it comes to pitching a creative project as the week begins. Lean in to this artistic energy and you could come away from the moment feeling truly accomplished. Later, if you’ve had to deal with setbacks and delays related to dates and opportunities to express what’s in your heart, you can now look forward to finding new ways to infuse everyday life with fun, joy, and pure magic.",
"zodiac_sign": "Pisces"
}
Note
Response Fields:
zodiac_sign— The zodiac sign automatically determined from the date of birthhoroscope— Full horoscope for the week, including dates and guidance
Related Endpoints¶
- Yesterday Daily Horoscope
- Today Daily Horoscope
- Tomorrow Daily Horoscope
- Birth Chart Report (JSON)
- Birth Chart Image (SVG)