Astrology Terms¶

The Astrology Terms endpoint provides definitions and explanations of important astrology concepts.
It covers everything from signs and planetary positions to transits, aspects, and different astrological systems.

Perfect for beginners, enthusiasts, and professional astrologers who want a quick reference for terminology.

Endpoint¶

Method	Path
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/term`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/term`

Query Parameters¶

Name	Required	Type	Example	Description
`term`	✅	String	`transit`	The astrology term you want to retrieve. Supported values: `astrology`, `sun_sign`, `moon_sign`, `rising_sign`, `transit`, `aspects`, `western_astrology`, `vedic_astrology`, `tibetan_astrology`, `horary_astrology`, `medical_astrology`, `chinese_astrology`.

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

POST Request¶

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

Example Response¶

{
  "term": "Sun Sign",
  "definition": "The zodiac sign the Sun was in at the moment of birth. Most people’s “star sign” — represents core identity, ego, life purpose, vitality, and conscious self-expression.",
  "timeframe": "Approximately 30 days per sign",
  "symbolic_role": "The hero / central character of your life story",
  "common_misconception": "It is only one part of the chart — not the whole personality",
  "related_terms": [
    "moon_sign",
    "rising_sign",
    "natal_chart"
  ],
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "397ce32532f8850d",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "horoscope_astrology_term",
    "endpoint_description": "Provides definitions and meanings for astrological terms.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:51.458843+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:

term_summary — Explanation or meaning of the requested astrology term.