Planets Info¶

The Planets Info 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://api.numerologyapi.com/api/v1/horoscope/planets-info`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/planets-info`

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.

Add the optional lang query parameter to localize responses. Supported values: en, es, de, fr, pt.

Example Requests¶

GET Request¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/planets-info?planet_name=sun&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/planets-info?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "planet_name": "sun"
}'

Example Response¶

{
  "planet_symbol": "☉",
  "ruling_signs": [
    "Leo"
  ],
  "exalted_in": "Aries",
  "detriment_in": "Aquarius",
  "fall_in": "Libra",
  "element": "Fire",
  "modality": "Fixed",
  "orbital_period_days": "N/A",
  "mythological_origin": "In Greek myth, Helios drove the chariot of the Sun across the sky. In Roman tradition, Sol embodies vitality and conscious will.",
  "planet_personality": "The Sun radiates confidence, identity, and creative life force. It represents your core self—the essence you reveal to the world when you’re authentically aligned.",
  "planet_overview": "The Sun is the center of your astrological chart, symbolizing ego, vitality, and life purpose.",
  "planet_summary": "In the natal chart, the Sun reveals your fundamental drive, sense of self, and how you express individuality. Its placement by sign and house shows where you naturally shine and seek recognition. During transits, the Sun activates areas of growth, spotlighting opportunities for leadership and self-actualization. Spiritually, the Sun is the divine spark within—the unwavering truth of who you are beyond roles and masks. For coaches, it marks the client’s ‘hero’s journey’ axis.",
  "planet_keywords_positive": [
    "Confidence",
    "Vitality",
    "Authenticity",
    "Leadership",
    "Creativity",
    "Clarity"
  ],
  "planet_keywords_negative": [
    "Ego-inflation",
    "Self-centeredness",
    "Pride",
    "Rigidity",
    "Need for attention"
  ],
  "life_domains": [
    "Identity",
    "Career",
    "Public Image",
    "Creativity",
    "Father/Authority Figures"
  ],
  "numerological_resonance": 1,
  "affirmation": "I am my true self, radiant and whole.",
  "shadow_aspect": "The fear of invisibility or irrelevance, leading to performative identity.",
  "transformational_gift": "The courage to embody your truth unapologetically, inspiring others to do the same.",
  "modern_interpretation": "In the digital age, the Sun governs personal branding, social media presence, and the quest for authentic self-expression amidst curated personas.",
  "compatibility_notes": "Harmonizes with Jupiter (expansion of self) and Mars (action-aligned identity); challenged by Saturn (self-doubt) and Uranus (identity disruption).",
  "retrograde_meaning": null,
  "eclipse_association": "Solar",
  "archetypal_role": "The Sovereign",
  "color": "Gold",
  "gemstone": "Citrine",
  "sacred_number": 1,
  "chakra_association": "Solar Plexus",
  "frequency_in_hz": 126.22,
  "planet_name": "Sun",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "d5be325868282dcc",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "horoscope_planets_info",
    "endpoint_description": "Provides detailed astrological information and attributes of planets.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:37:10.990107+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

Open Dashboard

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.