Retornos Astrológicos¶

O endpoint Retornos Astrológicos explica o conceito de retornos planetários, destacando como cada retorno representa um novo ciclo na vida de uma pessoa. Os retornos podem fornecer insights sobre crescimento pessoal, oportunidades e eventos importantes na vida, dependendo do planeta envolvido.

Perfeito para entusiastas da astrologia, intérpretes de gráficos e qualquer pessoa que busca entender o momento dos ciclos de vida em seu mapa natal.

Endpoint¶

Método	Caminho
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/returns`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/returns`

Parâmetros de Consulta¶

Nome	Obrigatório	Tipo	Exemplo	Descrição
`returns`	✅	String	`solar`	Nome do retorno astrológico. Valores suportados: `solar`, `lunar`, `mercury`, `venus`, `mars`, `jupiter`, `saturn`.

Nota

Parâmetros ausentes ou inválidos resultarão em um erro 400. Ambos os métodos GET e POST são suportados.

Adicione o parâmetro de consulta opcional lang para localizar as respostas. Valores suportados: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh.

Exemplos de Solicitações¶

Solicitação GET¶

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

Solicitação POST¶

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

Resposta de Exemplo

{
  "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": [
    "Cast & interpret Solar Return chart near birthday",
    "Sun salutations on birthday",
    "Golden candle ritual for vitality",
    "Vision board for the year ahead"
  ],
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "5048da67769cb4dd",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "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-08-18T01:05:45.835823+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "fr",
      "es",
      "de",
      "pt",
      "ja",
      "hi",
      "ar",
      "ru",
      "tr",
      "it",
      "pl",
      "nl",
      "id",
      "ko",
      "th",
      "ro",
      "ur",
      "gu",
      "bn",
      "vi",
      "ta",
      "te",
      "mr",
      "pa",
      "zh"
    ],
    "notes": ""
  }
}

Abrir Painel

Nota

Campos de Resposta:

returns — Nome do retorno astrológico
definition — Explicação geral dos retornos planetários e sua relevância na vida
returns_summary — Descrição detalhada do retorno planetário selecionado