Save over 30% when you subscribe to an annual subscription plan!

Horoscope API

The Horoscope API provides daily horoscopes for all zodiac signs.

API Status

Online - All Systems Operational

Didn't find what you were looking for? Suggest an improvement

/v1/horoscope GET

https://api.api-ninjas.com/v1/horoscope

Returns the daily horoscope for a specific zodiac sign. Optionally, you can provide a date parameter to get historical horoscopes.

Parameters

  • zodiac  required

    The zodiac sign to get a horoscope for. Valid values are: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.

  • date  optional premium only

    The date for the horoscope in YYYY-MM-DD format. The date must be either current or in the past. It cannot be in the future. If not provided, returns the horoscope for today's date.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns a JSON object with the following properties:

  • date

    The date for the horoscope in YYYY-MM-DD format.

  • zodiac

    The zodiac sign the horoscope is for.

  • horoscope

    The daily horoscope text for the specified zodiac sign.

Sample Request Live Demo!

zodiac
date premium
https://api.api-ninjas.com/v1/horoscope?zodiac=virgo

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 { "date": "2023-07-15", "zodiac": "virgo", "horoscope": "Today is a day for careful planning and attention to detail, Virgo. Your analytical skills are heightened, making it an excellent time to tackle complex problems. In your personal relationships, clear communication will prevent misunderstandings. Take some time for self-care and don't be too critical of yourself or others. A small act of kindness could have unexpected positive results." }

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/horoscope?sign=aries" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.