Where do the readings come from?

They are generated for entertainment, deterministic per sign and date, so everyone sees the same reading for a sign on a given day and it changes daily.

What does a reading include?

The text for today, tomorrow or yesterday, a mood, a lucky number, a lucky colour and a compatibility note.

What is the sign metadata?

Factual data per sign: element, modality, ruling planet, date range and symbol, with a date-to-sign lookup.

Is this astrology advice?

No. The readings are entertainment content and are labelled as such in the response.

What does a call cost?

1 token. The free plan covers 500 readings a month.

EntertainmentMAINTAINED1 token / call

Horoscope & Zodiac API

Daily horoscopes for the 12 signs with mood, lucky number and colour, plus sign facts and date-to-sign lookup

Daily horoscopes for all 12 zodiac signs (today, tomorrow, or yesterday) with mood, lucky number, lucky color, and compatibility — plus factual sign metadata and a date-to-sign lookup. Readings are generated for entertainment.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "sign": "Leo",
  "symbol": "♌",
  "element": "Fire",
  "date_range": "July 23 – August 22",
  "day": "today",
  "date": "2026-06-06",
  "horoscope": "A wave of positive energy surrounds you. Career matters take center stage. Small, deliberate steps lead to real progress. By evening, clarity will arrive.",
  "mood": "Confident",
  "lucky_number": 15,
  "lucky_color": "Gold",
  "compatibility": "Sagittarius"
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Horoscope & Zodiac API

Add a daily horoscope section to a lifestyle app or newsletter.
Show a user's sign and its traits from their birth date at signup.
Generate shareable daily cards with mood, lucky number and colour.
Build compatibility features from the sign metadata.

Horoscope & Zodiac API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETDaily Horoscope
GETList Signs
GETSign By Date

GETDaily Horoscope

https://api-horoscope.dataandapis.com/v1/horoscope/{sign}

Path parameters

Parameter	Example
sign	leo	Required

Query parameters

Parameter	Example
day	today	Optional

Example request

curl "https://api-horoscope.dataandapis.com/v1/horoscope/leo?day=today" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "sign": "Leo",
  "symbol": "♌",
  "element": "Fire",
  "quality": "Fixed",
  "ruling_planet": "Sun",
  "date_range": "July 23 – August 22",
  "day": "today",
  "date": "2026-06-06",
  "horoscope": "A wave of positive energy surrounds you. Career matters take center stage. Small, deliberate steps lead to real progress. By evening, clarity will arrive.",
  "mood": "Confident",
  "lucky_number": 15,
  "lucky_color": "Gold",
  "compatibility": "Sagittarius",
  "disclaimer": "For entertainment purposes only."
}

GETList Signs

https://api-horoscope.dataandapis.com/v1/signs

This endpoint takes no parameters.

Example request

curl "https://api-horoscope.dataandapis.com/v1/signs" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "count": 12,
  "signs": [
    {
      "sign": "Aries",
      "symbol": "♈",
      "element": "Fire",
      "quality": "Cardinal",
      "ruling_planet": "Mars",
      "date_range": "March 21 – April 19"
    },
    {
      "sign": "Taurus",
      "symbol": "♉",
      "element": "Earth",
      "quality": "Fixed",
      "ruling_planet": "Venus",
      "date_range": "April 20 – May 20"
    }
  ]
}

GETSign By Date

https://api-horoscope.dataandapis.com/v1/sign

Query parameters

Parameter	Example
date	1990-07-15	Required

Example request

curl "https://api-horoscope.dataandapis.com/v1/sign?date=1990-07-15" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "date": "1990-07-15",
  "sign": "Cancer",
  "symbol": "♋",
  "element": "Water",
  "quality": "Cardinal",
  "ruling_planet": "Moon",
  "date_range": "June 21 – July 22"
}

Where the data comes from

Source: Generated readings plus a factual zodiac reference table. Pure computation.
Freshness: Readings change daily; generated on every call.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

3endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-horoscope.dataandapis.com/v1/horoscope/{sign}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Horoscope & Zodiac API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Query Parameters

day(Optional)

Path Parameters

sign

Target:

Client:

import axios from 'axios';

const url = 'https://api-horoscope.dataandapis.com/v1/horoscope/{sign}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});