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

Chinese Horoscope

Introducing the Chinese Horoscope Prediction API, your gateway to delivering personalized insights from the Chinese zodiac. With this API, you can access daily horoscope predictions for all twelve Chinese zodiac animal signs. Integrate it into your astrology applications, websites, or content systems to provide users with meaningful, culturally enriched astrological guidance.


Step by Step Chinese Horoscope API Postman Testing Integration

https://support.divineapi.com/horoscope-apis/testing-the-chinese-horoscope-api-using-post


API Endpoint for English

POST https://astroapi-5.divineapi.com/api/v3/chinese-horoscope

Guide: If you only need English, use this endpoint.


API Endpoint for other languages

POST https://astroapi-5-translator.divineapi.com/api/v3/chinese-horoscope

Guide: If you want the prediction in any other language use this translator endpoint.


Supported Language Codes

Use the lan parameter in the body to fetch responses in a specific language.

Supported Reference Article:
https://support.divineapi.com/general-api-support/translating-apis-into-a-different-language

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

Guide:
To use translations, ensure your translator is updated at DivineAPI Translator.


Headers

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

Request Body

NameTypeDescription
api_key*StringYour DivineAPI key available on your dashboard.
sign*StringThe Chinese zodiac animal sign (e.g., Tiger, Dragon, Rat).
h_day*StringChoose from yesterday, today, or tomorrow.
tzone*FloatTimezone offset, e.g., 5.5. See the Timezone Guide.
lanStringLanguage code as per the table above. Default: en.

200: OK Successful

{
    "success": 1,
    "data": {
        "sign": "Tiger",
        "date": "20 Mar 2026",
        "prediction": {
            "growth": "Today, as the Tiger navigates the energies of Yi and Wood, introspection becomes your ally. Embrace this Yin day to delve into self-discovery and learning. Read up on topics that fascinate you or pick up a meditation practice. This alignment encourages growth through quiet reflection, enhancing your innate boldness with wisdom. Let your philosophical nature guide you in discovering paths that align with your deepest aspirations.",
            "health": "With the influence of Wood and Yi, balance is crucial for your health today, Tiger. Lean towards dietary choices rich in green leafy vegetables and fruits to nurture your inner vitality. Consider incorporating gentle yoga or tai chi into your day to harmonize body and mind. Listening to your body’s subtle signals under this Yin influence will keep you vibrant and resilient.",
            "wealth": "Under the Wood and Yi combination, today's financial energies suggest taking a cautionary approach. This is a day to review your long-term investments and savings plans rather than initiating new ventures. Allow the steady, nurturing nature of Wood to guide your steps. Contemplate strategies focusing on sustainable growth; your insights today will sow the seeds for future prosperity.",
            "career": "Today, the power of Wood and the gentle touch of Yi make it a prime time to nurture your career goals quietly. Embrace teamwork and collaboration, reflecting on how your leadership can inspire others. Maintain balance in your interactions, and allow your calm yet determined Tiger nature to shine. It's a day for careful planning, laying a groundwork that will support future achievements.",
            "love": "Under the Wood element's influence, let your heart connect with warmth today. Whether with a partner or seeking new connections, let your nurturing side guide your interactions. Sharing your dreams and listening with empathy will deepen your bonds. The gentle Yin energy balances your fiery Tiger spirit, fostering closeness and mutual understanding in love and family ties.",
            "family": "Today, the energies promoting harmony within family life are strong. Foster connections by engaging in shared activities like cooking or storytelling. Yi and Wood urge you to refocus on creating supportive environments at home. This is an opportune time to address any existing tensions with compassion, turning your household into a haven of peace and understanding.",
            "fortune": [
                "Lucky Numbers of the day : 3,7,9",
                "Lucky Alphabets you will be in sync with : Y,W",
                "Cosmic Tip : Trust in the gentle power of nurturing connections today.",
                "Tips for Singles : Let your soul's warmth guide new connections, radiate genuine kindness.",
                "Tips for Couples : Embrace gentle interactions; listen deeply to strengthen mutual understanding."
            ]
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'sign="TIGER"' \
--form 'h_day="today"' \
--form 'tzone="5.5"' \
--form 'lan="en"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'sign': 'TIGER',
    'h_day': 'today',
    '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", "TIGER");
form.append("h_day", "today");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-5.divineapi.com/api/v3/chinese-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/v3/chinese-horoscope"

payload = {'api_key': '{Your API Key}',
'sign': 'TIGER',
'h_day': 'today',
'tzone': '5.5',
'lan': 'en'}

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

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

print(response.text)