Copy page
Copy page as Markdown for LLMs
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
The API supports a wide range of languages. Pass the language code in the lan field in the request body.
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| pt | Portuguese |
| fr | French |
| es | Spanish |
| ru | Russian |
| de | German |
| nl | Dutch |
| it | Italian |
| pl | Polish |
| ar | Arabic |
| ja | Japanese |
| zh | Chinese |
| tm | Tamil |
| tl | Telugu |
| tr | Turkish |
| ta | Filipino/Tagalog |
| bn | Bengali |
| ma | Marathi |
| ml | Malayalam |
| kn | Kannada |
| uk | Ukrainian |
| hu | Hungarian |
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.
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.
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.
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token. Example: Bearer {token} |
Fields marked with * are mandatory.
| Name | Type | Description |
|---|---|---|
| api_key* | String | Your API key from the DivineAPI dashboard. |
| sign* | String | Zodiac sign, e.g. aries, leo, capricorn. Case-insensitive in most implementations. |
| h_day* | String | One of yesterday, today, tomorrow. Use this when you want relative-day horoscope. |
| tzone* | Float | Timezone of the user, e.g. 5.5 for IST. Refer to the DivineAPI timezone guide. |
| lan | String | Language code as per the table above. Default is en. |
{
"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
}
}
}
}Below are example implementations in various programming environments.
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"'
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);
});
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);
});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)
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.