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://api.numerologyapi.com/api/v1/horoscope/astrology/aspect`
`POST`	`https://api.numerologyapi.com/api/v1/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.

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/astrology/aspect?aspect=conjunction&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request¶

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

Example Response¶

{
  "aspect": "Conjunction",
  "symbol": "☌",
  "degree": "0°",
  "typical_orb": "8–10°",
  "quality": "Fusion / Intensification",
  "aspect_type": "Soft",
  "core_meaning": "Two (or more) planetary energies merge into one unified force—blending, amplifying, and acting as a single powerhouse.",
  "how_it_feels": "Like two rivers becoming one strong current—intense focus, concentrated power, but can feel overwhelming or obsessive if the planets clash in nature.",
  "strengths": [
    "Supercharged synergy",
    "Laser-like focus",
    "Natural talent or drive in the combined themes",
    "Magnetic presence"
  ],
  "shadows": [
    "Over-identification",
    "Blind spots",
    "Burnout from too much of one energy",
    "Obsession or compulsion"
  ],
  "spiritual_lesson": "Unity is power, but only when the merged forces serve higher purpose rather than ego. True conjunction alchemizes opposites into wholeness.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "ef8a48266f116eb9",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "horoscope_astrology_aspect",
    "endpoint_description": "Detailed astrological aspect interpretation.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:48.272323+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:

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