Planets Horoscope¶

The Planets Horoscope endpoint provides comprehensive information about each planet in astrology.
It includes retrograde periods, rulerships, personality traits, positive/negative keywords, and an astrological overview.

Perfect for understanding planetary influences on personality, life events, and compatibility.

Endpoint¶

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

Query Parameters¶

Name	Required	Type	Example	Description
`planet_name`	✅	String	`pluto`	The planet name you want to retrieve. Supported values: `sun`, `moon`, `mercury`, `venus`, `mars`, `jupiter`, `saturn`, `uranus`, `neptune`, `pluto`.

Note

Missing or invalid parameters will return 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/planets?planet_name=pluto" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

POST Request¶

curl -X POST "https://the-numerology-api.p.rapidapi.com/horoscope/planets" \
  -H "Content-Type: application/json" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -d '{
        "planet_name": "pluto"
      }'

Example Response¶

{
  "planet_calendar": {
    "2019": ["Apr 29 - Oct 3"],
    "2020": ["Apr 25 - Oct 4"],
    "2021": ["Apr 27 - Oct 6"]
  },
  "planet_calendar_type": "Retrograde",
  "planet_facts": {
    "Detriment": "Taurus",
    "Exultation": "Aries",
    "Fall": "Libra",
    "Orbit Length": "248 years",
    "Retrograde": "Yearly, for 4-5 months at a time",
    "Rulership": "Scorpio",
    "Temperature": "Cold"
  },
  "planet_keywords_neg": "Obsession, Dark, Manipulative, Resentment, Secretive...",
  "planet_keywords_pos": "Transformation, Mysterious, Magnetic, Sexual, Bold...",
  "planet_name": "Pluto",
  "planet_overview": "There has been some recent debate about whether Pluto should be classified as a planet by astronomical standards...",
  "planet_personality": "Sex, death, and transformation",
  "planet_summary": "Pluto rules our unconscious selves: our innermost secret lives and desires...",
  "planet_symbol": "Pluto's glyph is the circle of spirit resting within the soul crescent..."
}

View on RapidAPI

Note

Response Fields:

planet_calendar — Retrograde or notable planetary date ranges by year.
planet_calendar_type — Type of calendar period (e.g., Retrograde).
planet_facts — Key astrological rulerships, detriments, exaltation, orbit length, and more.
planet_keywords_pos — Positive keywords associated with the planet.
planet_keywords_neg — Negative keywords associated with the planet.
planet_name — Name of the planet.
planet_overview — Summary and context about the planet.
planet_personality — Planet personality and symbolic meaning.
planet_summary — Detailed explanation of the planet's influence.
planet_symbol — Symbolism of the planet’s glyph.