Vai al contenuto

Astrology Returns

L'endpoint Astrology Returns spiega il concetto di ritorni planetari, evidenziando come ogni ritorno rappresenta un nuovo ciclo nella vita di una persona. I ritorni possono fornire informazioni su crescita personale, opportunità e eventi importanti della vita, a seconda del pianeta coinvolto.

Perfetto per gli appassionati di astrologia, gli interpreti di grafi e chiunque cerchi di comprendere il momento dei cicli vitali nel proprio tema natale.

Endpoint

Metodo Percorso
GET https://api.numerologyapi.com/api/v1/horoscope/astrology/returns
POST https://api.numerologyapi.com/api/v1/horoscope/astrology/returns

Parametri di Query

Nome Obbligatorio Tipo Esempio Descrizione
returns ✅ Stringa solar Nome del ritorno astrologico. Valori supportati: solar, lunar, mercury, venus, mars, jupiter, saturn.

Nota

Missing or invalid parameters will return a 400 error.
Both GET and POST methods are supported.

Aggiungere il parametro di query opzionale lang per localizzare le risposte. Valori supportati: en, es, de, fr, pt.

Esempi di Richieste

Richiesta GET

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

Richiesta POST

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"
}'

Risposta di Esempio

{
  "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": ""
  }
}

---Apri Dashboard

Nota

Campi di risposta:

  • returns — Nome del risultato astrologico
  • definition — Spiegazione generale dei risultati planetari e della loro rilevanza nella vita
  • returns_summary — Descrizione dettagliata del risultato planetario selezionato

Endpoint correlati