Horóscopos

Acceded al contenido de horóscopos, incluyendo horóscopos diarios, semanales y anuales para todos los signos zodiacales.

Signos Zodiacales

Todos los endpoints de horóscopos aceptan los siguientes identificadores de signos zodiacales:

aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces

---

Horóscopos Diarios

Recuperad horóscopos diarios para los 12 signos zodiacales. Los horóscopos diarios combinan textos de interpretación profesionales con cálculos astronómicos en tiempo real del día.

Módulo Requerido

Requiere el módulo module:daily-report.

cURL

curl "https://api.astroapi.cloud/api/horoscope/daily/2024-06-15" \
  -H "X-Api-Key: your-api-key"

JavaScript

const response = await fetch("https://api.astroapi.cloud/api/horoscope/daily/2024-06-15", {
    headers: {
        "X-Api-Key": "your-api-key"
    }
});

const data = await response.json();
console.log(JSON.stringify(data, null, 2));

Python

import requests

response = requests.get(
    "https://api.astroapi.cloud/api/horoscope/daily/2024-06-15",
    headers={
        "X-Api-Key": "your-api-key"
    }
)

print(response.json())

Con un idioma específico:

curl "https://api.astroapi.cloud/api/horoscope/daily/2024-06-15?language=nl" \
  -H "X-Api-Key: your-api-key"

Parámetros de Ruta

Parámetro	Tipo	Obligatorio	Descripción
date	string	Sí	Fecha en formato YYYY-MM-DD

Parámetros de Consulta

Parámetro	Tipo	Obligatorio	Descripción
language	string	No	Código de idioma para el texto del horóscopo (por defecto: "en")

Respuesta

El endpoint diario devuelve los horóscopos para los 12 signos:

{
    "data": {
        "date": "2024-06-15",
        "language": "en",
        "horoscopes": {
            "aries": {
                "sign": "aries",
                "text": "Today brings a surge of energy and motivation. Mars, your ruling planet, aligns favorably with Jupiter, opening doors for bold action and new beginnings..."
            },
            "taurus": {
                "sign": "taurus",
                "text": "Venus highlights your financial sector today, making this an excellent time to review your long-term plans..."
            }
        }
    }
}

Disponibilidad del Contenido

Los horóscopos diarios pueden no estar disponibles para fechas anteriores a más de 4 meses.

---

Horóscopos Semanales

Recuperad un horóscopo semanal para un signo zodiacal específico.

Módulo Requerido

Requiere el módulo module:weekly-report.

curl "https://api.astroapi.cloud/api/horoscope/weekly/2024/24/aries" \
  -H "X-Api-Key: your-api-key"

Parámetros de Ruta

Parámetro	Tipo	Obligatorio	Descripción
year	number	Sí	Año (p. ej., 2024)
week	string	Sí	Número de semana ISO, con cero inicial (01–53)
zodiacSign	string	Sí	Identificador del signo zodiacal (ver lista anterior)

Parámetros de Consulta

Parámetro	Tipo	Obligatorio	Descripción
language	string	No	Código de idioma para el texto del horóscopo (por defecto: "en")

Respuesta

{
    "data": {
        "year": 2024,
        "week": 24,
        "zodiacSign": "aries",
        "language": "en",
        "text": "This week marks an important turning point for Aries. The Sun's position in Gemini activates your communication house, making this the ideal time to speak your truth and connect with others..."
    }
}

Disponibilidad del Contenido

Los horóscopos semanales están disponibles para la semana actual y hasta aproximadamente 4 meses en el pasado.

---

Horóscopos Anuales

Recuperad un horóscopo anual para un signo zodiacal específico.

Módulo Requerido

Requiere el módulo module:yearly-report.

curl "https://api.astroapi.cloud/api/horoscope/yearly/2024/aries" \
  -H "X-Api-Key: your-api-key"

Parámetros de Ruta

Parámetro	Tipo	Obligatorio	Descripción
year	number	Sí	Año (solo se admite el año actual)
zodiacSign	string	Sí	Identificador del signo zodiacal

Parámetros de Consulta

Parámetro	Tipo	Obligatorio	Descripción
language	string	No	Código de idioma para el texto del horóscopo (por defecto: "en")

Respuesta

{
    "data": {
        "year": 2024,
        "zodiacSign": "aries",
        "language": "en",
        "text": "2024 is a year of transformation and expansion for Aries. Saturn's continued presence in Pisces asks you to confront hidden patterns, while Jupiter in Taurus brings tangible rewards for past efforts..."
    }
}

Disponibilidad del Contenido

Los horóscopos anuales solo están disponibles para el año calendario actual.

---

Horóscopos Anuales del Ascendente

Recuperad un horóscopo anual centrado en la perspectiva del ascendente (signo ascendente).

Módulo Requerido

Requiere el módulo module:yearly-ascendant-report.

curl "https://api.astroapi.cloud/api/horoscope/yearly-ascendant/2024/aries" \
  -H "X-Api-Key: your-api-key"

Parámetros de Ruta

Parámetro	Tipo	Obligatorio	Descripción
year	number	Sí	Año (solo se admite el año actual)
zodiacSign	string	Sí	Identificador del signo ascendente

Parámetros de Consulta

Parámetro	Tipo	Obligatorio	Descripción
language	string	No	Código de idioma para el texto del horóscopo (por defecto: "en")

Respuesta

{
    "data": {
        "year": 2024,
        "zodiacSign": "aries",
        "language": "en",
        "text": "For those with Aries rising, 2024 activates your chart in powerful ways. Pluto's move into your 11th house reshapes your social circle and long-term goals..."
    }
}

Disponibilidad del Contenido

Los horóscopos anuales del ascendente solo están disponibles para el año calendario actual.

---

Resumen de Disponibilidad

Endpoint	Módulo Requerido	Ventana de Disponibilidad
Diario	module:daily-report	Máximo ~4 meses en el pasado
Semanal	module:weekly-report	Máximo ~4 meses en el pasado
Anual	module:yearly-report	Solo el año actual
Anual Ascendente	module:yearly-ascendant-report	Solo el año actual