Horoscopes

Access AI-generated horoscope content including daily, weekly, and yearly horoscopes for all zodiac signs.

AI-Generated Content

Horoscopes are generated using Cloudflare AI (LLaMA 3.3-70B) and are refreshed automatically on a scheduled basis.

Zodiac Signs

All horoscope endpoints accept the following zodiac sign identifiers:

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

---

Daily Horoscopes

Retrieve AI-generated daily horoscopes for all 12 zodiac signs.

Required Module

Requires the module:daily-report module.

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

With a specific language:

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

Path Parameters

Parameter	Type	Required	Description
date	string	Yes	Date in YYYY-MM-DD format

Query Parameters

Parameter	Type	Required	Description
language	string	No	Language code for the horoscope text (default: "en")

Response

The daily endpoint returns horoscopes for all 12 signs:

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

Content Availability

Daily horoscopes are generated on a schedule and may not be available for dates more than 4 months in the past.

---

Weekly Horoscopes

Retrieve a weekly horoscope for a specific zodiac sign.

Required Module

Requires the module:weekly-report module.

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

Path Parameters

Parameter	Type	Required	Description
year	number	Yes	Year (e.g. 2024)
week	string	Yes	ISO week number, zero-padded (01–53)
zodiacSign	string	Yes	Zodiac sign identifier (see list above)

Query Parameters

Parameter	Type	Required	Description
language	string	No	Language code for the horoscope text (default: "en")

Response

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

Content Availability

Weekly horoscopes are available for the current week and up to approximately 4 months in the past.

---

Yearly Horoscopes

Retrieve a yearly horoscope for a specific zodiac sign.

Required Module

Requires the module:yearly-report module.

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

Path Parameters

Parameter	Type	Required	Description
year	number	Yes	Year (only the current year is supported)
zodiacSign	string	Yes	Zodiac sign identifier

Query Parameters

Parameter	Type	Required	Description
language	string	No	Language code for the horoscope text (default: "en")

Response

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

Content Availability

Yearly horoscopes are only available for the current calendar year.

---

Yearly Ascendant Horoscopes

Retrieve a yearly horoscope focused on the ascendant (rising sign) perspective.

Required Module

Requires the module:yearly-ascendant-report module.

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

Path Parameters

Parameter	Type	Required	Description
year	number	Yes	Year (only the current year is supported)
zodiacSign	string	Yes	Ascendant sign identifier

Query Parameters

Parameter	Type	Required	Description
language	string	No	Language code for the horoscope text (default: "en")

Response

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

Content Availability

Yearly ascendant horoscopes are only available for the current calendar year.

---

Availability Summary

Endpoint	Module Required	Availability Window
Daily	module:daily-report	Max ~4 months in the past
Weekly	module:weekly-report	Max ~4 months in the past
Yearly	module:yearly-report	Current year only
Yearly Ascendant	module:yearly-ascendant-report	Current year only