Zum Inhalt

Astrology Returns

Der Endpoint Astrology Returns erklärt das Konzept der planetarischen Rückgänge, wobei der Schwerpunkt auf dem liegt, wie jeder Rückgang einen neuen Lebensabschnitt für eine Person repräsentiert. Rückgänge können Einblicke in persönliches Wachstum, Chancen und wichtige Lebensereignisse geben, abhängig von dem beteiligten Planeten.

Ideal für Astrologie-Enthusiasten, Chart-Interpreten und alle, die das Timing von Lebenszyklen in ihrem Geburtshoroskop verstehen möchten.

Endpoint

Methode Pfad
GET https://api.numerologyapi.com/api/v1/horoscope/astrology/returns
POST https://api.numerologyapi.com/api/v1/horoscope/astrology/returns

Abfrageparameter

Name Erforderlich Typ Beispiel Beschreibung
returns ✅ String solar Name des astrologischen Rückgangs. Unterstützte Werte: solar, lunar, mercury, venus, mars, jupiter, saturn.

Anmerkung

Fehlende oder ungültige Parameter führen zu einem Fehler 400. Beide Methoden (GET und POST) werden unterstützt.

Fügen Sie den optionalen Abfrageparameter lang hinzu, um die Antworten zu lokalisieren. Unterstützte Werte: en, es, de, fr, pt.

Beispielanfragen

GET-Anfrage

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/astrology/returns?returns=solar&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST-Anfrage

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

Beispielantwort

{
  "return_type": "solar",
  "full_name": "Solar Return",
  "cycle_duration": "≈1 year (exact birthday to next birthday)",
  "symbolic_meaning": "Annual rebirth of the Sun — your personal New Year chart",
  "what_it_activates": "Core identity, life purpose, vitality, conscious direction for the coming year",
  "key_themes": [
    "Overall tone of the year",
    "Where you shine / seek recognition",
    "Major focus areas (look at SR Ascendant + Sun house)"
  ],
  "psychological_focus": "Evolving sense of self, confidence levels, how you want to be seen",
  "spiritual_growth_opportunity": "Aligning ego with soul purpose, stepping into authentic leadership",
  "common_challenges_shadow": [
    "Ego inflation/deflation",
    "Burnout from over-identification with external success",
    "Fear of not being 'enough'"
  ],
  "highest_expression": "Radiant authentic presence, joyful creative contribution",
  "affirmation": "I shine from my true center. This year I live my purpose with courage and joy.",
  "recommended_rituals_practices": [
    "Cast & interpret Solar Return chart near birthday",
    "Sun salutations on birthday",
    "Golden candle ritual for vitality",
    "Vision board for the year ahead"
  ],
  "common_challenges": [
    "Ego inflation/deflation",
    "Burnout from over-identification with external success",
    "Fear of not being 'enough'"
  ],
  "recommended_practices": [],
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "90f458dfe1aafa13",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "horoscope_astrology_returns",
    "endpoint_description": "Calculates planetary returns (Solar, Lunar, etc.).",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:50.607044+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": ""
  }
}

Dashboard öffnen

Anmerkung

Antwortfelder:

  • returns — Name des astrologischen Rückgangs
  • definition — Allgemeine Erklärung von planetarischen Rückgängen und deren Bedeutung für das Leben
  • returns_summary — Detaillierte Beschreibung des ausgewählten planetarischen Rückgangs

Verwandte Endpunkte