Horoscopes Past, Present & Future

Free Horoscope API

The Zodiac Timeline Horoscope API gives your app fresh daily horoscopes for all 12 zodiac signs. It is free, open to every site and needs no API key. All you need to do is credit Zodiac Timeline.

One GET request returns everything:

https://zodiactimeline.com/feed.xml

This is the same address as our horoscope RSS feed. An API is a web address that a program calls to get data.

The API at a glance

• Endpoint: GET https://zodiactimeline.com/feed.xml
• Format: XML in the RSS 2.0 standard, plus our own zt: fields for sign, date and score.
• Access: no key, no account and no sign-up.
• Browser calls: open to every website (CORS). CORS is the browser rule that decides which sites may read the data.
• Data: 60 horoscopes: all 12 signs for five days. The days are two days back, today and two days ahead.
• Updates: once a day at midnight UTC.
• Price: free, with a visible credit.

Try it from the command line:

curl https://zodiactimeline.com/feed.xml

API response

Each horoscope in the response is one item with these fields:

• title: the sign and the date, such as “Leo · October 13, 2026”.
• link: the page for that sign and day on Zodiac Timeline on the day the feed was built, such as /leo/today/ or /leo/tomorrow/.
• guid: the sign and the date, such as leo-2026-10-13. It stays the same for that item every day.
• pubDate: the date of the horoscope, in the RSS date format.
• description: the full horoscope for that day, as plain text.
• zt:sign: the sign in small letters, such as leo. Use it to pick one sign.
• zt:date: the date of the horoscope, such as 2026-10-13.
• zt:score: the overall score for the day, out of 10.

One item looks like this (the reading is shortened here):

<item>
  <title>Leo · October 13, 2026</title>
  <link>https://zodiactimeline.com/leo/today/</link>
  <guid isPermaLink="false">leo-2026-10-13</guid>
  <pubDate>Tue, 13 Oct 2026 00:00:00 +0000</pubDate>
  <description>This is a good time to ask what makes you feel safe and how much of it you actually have. …</description>
  <zt:sign>leo</zt:sign>
  <zt:date>2026-10-13</zt:date>
  <zt:score>3.5</zt:score>
</item>

Sample code

Our GitHub repository has short, ready-to-run examples in Python and Node.js. They read the API and show the horoscopes: free-horoscope-api-examples

React component: react-horoscope

react-horoscope is our free, open-source component for React, the popular JavaScript library for building web pages. It puts all 12 signs on your page with one line of code. It reads this same feed, right in the browser.

npm install react-horoscope

Then add it to your app:

import { Horoscope } from 'react-horoscope';
import 'react-horoscope/styles.css';

export default function App() {
  return <Horoscope />;
}

What you get:

• A grid of all 12 signs. Tap a sign to open its reading for today. Yesterday and tomorrow are one tap away.
• The visitor’s own date. “Today” follows the clock on the visitor’s device, in any time zone.
• A daily score. Each sign shows its score for the day, out of 10.
• Tiny and fast. It is about 6 KB when compressed and needs no other packages. A page makes one feed request, however many times the component appears.
• Your look. Pick light, dark or automatic themes, cards or tiles, and your own colors. Every color and size is a CSS variable you can change.
• Hooks for your own design. A hook is a React function that hands you the data. Use useHoroscope to get one sign’s reading and build the layout yourself.
• Built for modern apps. It is written in TypeScript, so code editors check your code as you type. It works with React 17 and later.
• Safe on strict sites. It runs no inline scripts, so it works with a strict Content Security Policy (a browser rule that blocks unknown code).
• Easy for everyone. Keyboard and screen reader users keep their place as they move between signs.
• Credit built in. The component shows the “Powered by Zodiac Timeline” link for you.

It is free under the MIT License, so you can use it in personal and paid projects.

• Try it: live demo
• Install it: react-horoscope on npm
• Read the code: react-horoscope on GitHub

Best practices

• Cache for a day. The data changes once a day, so one call a day is all you need.
• Call it from anywhere. Your server, a scheduled job or a visitor’s browser all work.
• Use the visitor’s date. The response holds five days, so “today” is there in every time zone.

Credit Zodiac Timeline

Show the name Zodiac Timeline near the horoscopes, where your readers can see it. Make the name a link to https://zodiactimeline.com as in this HTML:

<a href="https://zodiactimeline.com">Zodiac Timeline</a>

The React component shows this credit for you. This permission is part of our Terms of Use.

Coming next: the full astrology platform

Zodiac Timeline is growing into a complete astrology platform, and each part will be an API you can build on. On the way:

• Birth chart: the planets, signs, houses and aspects for any birth date, time and place. Aspects are the angles between planets.
• Personal forecast: daily readings based on how today’s planets touch one person’s birth chart.
• Relationships: how two birth charts work together, day by day. Astrologers call this synastry.
• Daily scores: love, career and energy scores for each day.
• Sky events: retrogrades, eclipses, moon phases and planets changing signs, with exact times.
• Vedic and Chinese astrology: the two other major systems, from the same sky data.
• Best dates: the strongest days ahead for a goal.

Want early access or a partnership? Contact us.