Skip to content

Astrology Aspects

The Astrology Aspects endpoint provides insights into planetary relationships and influences within a birth chart.
It explains how specific aspects between planets affect energy flow, strengths, challenges, and personal tendencies.

Perfect for astrology enthusiasts, chart interpreters, or anyone curious about planetary dynamics.


Endpoint

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

Query Parameters

Name Required Type Example Description
aspect String conjunction Name of the astrology aspect. Supported values: conjunction, opposite, square, trine, sextile.

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/astrology/aspect?aspect=conjunction" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

POST Request

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

Example Response

{
  "aspect": "Conjunction (0-10 degrees)",
  "aspect_summary": "A conjunction forms when two planets are 0-10 degrees apart in the birth chart. In general, astrologers like to use the tightest orb as possible, a 5-degree orb is preferred. They are traveling close together in the same zodiac sign. A conjunction is a blending of the two planets’ energies, which can be an extremely powerful alliance—or too much of a good thing, depending on the planets involved. Imagine if you’re born with both your sun and Mercury in Cancer. If they’re sitting right next to one another in your birth chart, that’s a conjunction. A conjunction is like your first romantic relationship—when it was good it was amazing, but when it was bad, ugh. Most conjunctions are good for combining the planets’ energies and using them in a positive way. Although when two planets meet up and become too much of a good thing, the resulting energy can cause restlessness, distraction, or tension.",
  "aspect_type": "Hard"
}

View on RapidAPI


Note

Response Fields:

  • aspect — Full aspect name with degree range
  • aspect_summary — Detailed description of planetary interaction and effects
  • aspect_type — Classification (e.g., Hard, Soft)