search

Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Daily Horoscope Prediction API

Introducing the Daily Horoscope Prediction API, a simple and reliable way to fetch day-wise astrological guidance for any zodiac sign. This API is designed for websites, mobile apps, chatbots, CRM dashboards, or astrology portals that want to display daily horoscopes in multiple languages.

It supports two endpoints: one for English (default) and one routed through the DivineAPI translator service for other languages.


Step by Step Horoscope API Postman Testing Integration

Step by Step Horoscope API Postman Testing Integration


Supported Language Codes

The API supports a wide range of languages. Pass the language code in the lan field in the request body.

CodeLanguage
enEnglish
hiHindi
ptPortuguese
frFrench
esSpanish
ruRussian
deGerman
nlDutch
itItalian
plPolish
arArabic
jaJapanese
zhChinese
tmTamil
tlTelugu
trTurkish
taFilipino/Tagalog
bnBengali
maMarathi
mlMalayalam
knKannada
ukUkrainian
huHungarian

Guide:

If you only need English, use the main endpoint.

If you want the prediction in any other language from the table above, use the translator endpoint and ensure the translator is updated as per DivineAPI docs.


API Endpoints

POST https://astroapi-5.divineapi.com/api/v5/daily-horoscope

This is the default English endpoint.

POST https://astroapi-5-translator.divineapi.com/api/v5/daily-horoscope

Use this when you want the response in languages other than English.


What the API Returns

The API returns the daily horoscope for the given zodiac sign and day, broken into focused life areas such as personal, health, profession, emotions, travel, and luck, along with structured extras like color codes and percentage scores.


Headers

NameTypeDescription
Authorization*StringYour API Access Token. Example: Bearer {token}

Fields marked with * are mandatory.


Request Body

NameTypeDescription
api_key*StringYour API key from the DivineAPI dashboard.
sign*StringZodiac sign, e.g. aries, leo, capricorn. Case-insensitive in most implementations.
h_day*StringOne of yesterday, today, tomorrow. Use this when you want relative-day horoscope.
tzone*FloatTimezone of the user, e.g. 5.5 for IST. Refer to the DivineAPI timezone guide.
lanStringLanguage code as per the table above. Default is en.

200: OK โ€“ Fetched Daily Horoscope Prediction Successfully

{
    "success": 1,
    "data": {
        "sign": "Leo",
        "date": "2025-10-07",
        "prediction": {
            "personal": "Your personal life is full of vibrant energy today, encouraging you to connect with those around you. Spend quality time with family and friends, as meaningful interactions could strengthen your bonds. New avenues for self-expression might open up, allowing you to explore creative pursuits more deeply. Stay open to change and embrace versatility; it could bring about personal growth and new opportunities to thrive on a personal level.",
            "health": "Pay attention to physical wellness today, Leo. A balanced approach to nutrition and hydration will keep you energized. Incorporate moderate exercise into your routine to boost endorphins and alleviate stress. Meditation or yoga might also be beneficial for maintaining mental clarity and emotional equilibrium. Listen to your body's signals and don't ignore any signs of fatigue. Rest is crucial to rejuvenate your energy levels.",
            "profession": "Today, you may find yourself inspired at work, Leo. New ideas are likely to flow freely, and you could impress colleagues with your creativity. However, balance innovation with practicality to achieve the best outcomes. Be open to collaboration and networking to advance your professional goals. By day's end, you may unlock new pathways for growth or receive an opportunity that aligns with your ambitions.",
            "emotions": "Emotionally, you may feel heightened sensitivity, Leo, which can deepen connections with others. Trust your intuition, as it guides you through complex situations with grace. Surround yourself with positivity, as it elevates your mood and fortifies your spirit. Take time to reflect on personal desires and goals, aligning actions with intentions. Moments of solitude could provide the clarity you seek today.",
            "travel": "Adventure calls today, Leo! Whether it's a spontaneous day trip or planning a future vacation, your travel aspirations demand attention. Explore new places that inspire creativity and broaden your horizons. If immediate travel isn't possible, let wanderlust fuel your dreams and research your next escape. Local excursions could offer a refreshing change and bring a sense of novelty to your routine.",
            "luck": [
                "Colors of the day : Gold, Orange",
                "Lucky Numbers of the day : 4, 9, 13",
                "Lucky Alphabets you will be in sync with : L, S",
                "Cosmic Tip : Beware of impulsive actions; stay grounded and focused.",
                "Tips for Singles : Express your interests confidently; attract genuine connections today.",
                "Tips for Couples : Share your dreams; strengthen your bond through open dialogue."
            ]
        },
        "special": {
            "lucky_color_codes": [
                "#FFD700",
                "#FFA500"
            ],
            "horoscope_percentage": {
                "personal": 85,
                "health": 75,
                "profession": 80,
                "emotions": 78,
                "travel": 72,
                "luck": 83
            }
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-5.divineapi.com/api/v5/daily-horoscope' \
--header 'authorization: Bearer {Your Auth Token}'
--form api_key={Your API Key} \
--form 'sign="aries"' \
--form 'day="10"' \
--form 'month="10"' \
--form 'year="2024"' \
--form 'tzone="5.5"' \
--form 'lan="en"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-5.divineapi.com/api/v5/daily-horoscope',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'sign': 'aries',
    'day': '10',
    'month': '10',
    'year': '2024',
    'tzone': '5.5',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("sign", "aries");
form.append("day", "10");
form.append("month", "10");
form.append("year", "2024");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-5.divineapi.com/api/v5/daily-horoscope",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-5.divineapi.com/api/v5/daily-horoscope"

payload = {'api_key': '{Your API Key}',
'sign': 'aries',
'day': '10',
'month': '10',
'year': '2024',
'tzone': '5.5',
'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Notes and Best Practices

Always send the correct timezone so the API can match the correct day to the userโ€™s region.

Use the translator endpoint when you need localized content and pass the right lan code from the table above.

sign should be a valid zodiac sign supported by DivineAPI (Aries through Pisces).

You can store the response for the day to reduce calls if you are showing the same sign to many users.