Skip to content

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.