Horoscope
Get daily horoscope readings for all 12 zodiac signs. Each reading is deterministically generated per sign per day.
Overview
Use Cases
- Daily horoscope widgets
- Astrology apps
- Entertainment platforms
- Personalized daily content
Features
All 12 zodiac signs supported
Consistent daily readings (same sign returns same reading throughout the day)
Lucky number and mood included
Case-insensitive sign parameter
API Endpoints
Get Daily Horoscope
Returns a daily horoscope reading for the specified zodiac sign.
GET
https://api.requiems.xyz/v1/entertainment/horoscope/{sign}
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| sign | string |
Required | Zodiac sign (case-insensitive). Supported values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces |
Try it out
Live DemoRequest
Zodiac sign (case-insensitive). Supported values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| sign | string |
Normalized zodiac sign (lowercase) |
| date | string |
Today's date in YYYY-MM-DD format (UTC) |
| horoscope | string |
Daily horoscope reading |
| lucky_number | integer |
Lucky number for the day (1-99) |
| mood | string |
Suggested mood for the day |
Code Examples
curl https://api.requiems.xyz/v1/entertainment/horoscope/aries \
-H "requiems-api-key: YOUR_API_KEY"
import requests
url = "https://api.requiems.xyz/v1/entertainment/horoscope/aries"
headers = {"requiems-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch(
'https://api.requiems.xyz/v1/entertainment/horoscope/aries',
{ headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();
console.log(data.data.horoscope);
require 'net/http'
require 'json'
uri = URI('https://api.requiems.xyz/v1/entertainment/horoscope/aries')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)
puts data['data']['horoscope']
Frequently Asked Questions
Yes. Readings are deterministic per sign per day, so every user requesting the same sign on the same day receives the same horoscope.
No. You can pass the sign in any case (e.g., "Aries", "ARIES", or "aries") and the API will normalize it.
All 12 signs are supported β aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, and pisces.