Planetary Weekly & Monthly Horoscope¶

The Planetary Overview Horoscope endpoint provides guidance based on planetary positions affecting your zodiac sign for a weekly or monthly period.
It helps users anticipate trends, challenges, and opportunities in work, love, and personal growth, using planetary alignments as a roadmap.

Endpoint¶

Method	Path
`GET`	`https://the-numerology-api.p.rapidapi.com/horoscope/planetary/overview`
`POST`	`https://the-numerology-api.p.rapidapi.com/horoscope/planetary/overview`

Query Parameters¶

Name	Required	Type	Example	Description
`dob`	✅	String	`1995-08-20`	User's date of birth in `YYYY-MM-DD` format
`period`	❌	String	`weekly`	Period for horoscope: `weekly` or `monthly` (defaults to `weekly`)

Note

Missing dob returns a 400 error. Both GET and POST methods are supported.

Example Requests¶

GET Request¶

curl -X GET "https://the-numerology-api.p.rapidapi.com/horoscope/planetary/overview?dob=1995-08-20&period=weekly" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

POST Request¶

curl -X POST "https://the-numerology-api.p.rapidapi.com/horoscope/planetary/overview" \
  -H "Content-Type: application/json" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -d '{
        "dob": "1995-08-20",
        "period": "weekly"
      }'

Example Response¶

{
  "period": "weekly",
  "horoscope": "October 2025\n- October kicks off with the full moon in Aries on October 6, urging us to take steps toward evolving and growing. Emotions and passions will heighten, leading us to make moves toward change.\nMercury enters Scorpio that same day, burning our hearts with positivity regarding love and relationships. We'll be blessed when it comes to romance and financial planning.\nVenus moves into Libra on the thirteenth, allowing our confidence and social life to thrive. Our romantic sentiments will heighten, urging us to partner with others or deepen existing relationships. The only issue is that we may be lazier than usual, but that can be remedied by having structure and discipline.\nTransformative planet Pluto has been retrograde since May 4 and turns direct on October 13. Through its moonwalk, Pluto has pushed us to discover the motives of others and ourselves.\nThe new moon in Libra on the twenty-first may bring passive-aggressiveness to a new level. We are ready to consider what situations and relationships we want to release and move on from.\nNeptune retrograde reenters Pisces on October 22. We'll now rethink our ideologies and focus on what satisfies us emotionally. This isn't a particularly unfortunate time. It's a great moment to use the past to dream about the future.\nThe sun swims into Scorpio on the twenty-second, giving power to our intuition and drive. Motivation, inspiration, and curiosity will push us out of our shell and into the world.\nOn October 29, Mercury enters Sagittarius, urging us to look closer at how we communicate with others. It's time to express ourselves with honesty and directness. Our words will be meaningful and intense. As the month comes to a close, we'll reflect on the positive vibes that October brought to us all.",
  "zodiac_sign": "Leo"
}

View on RapidAPI

Note

Response Fields:

zodiac_sign — Zodiac sign calculated from the date of birth
period — The requested period for the planetary horoscope (weekly or monthly)
horoscope — Text describing planetary influences on the user for that period