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

Weekly Chinese Horoscope

Introducing the Weekly Chinese Horoscope Prediction API, your gateway to delivering personalized insights from the Chinese zodiac. With this API, you can access weekly 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-weekly

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-weekly

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
zhChinese
jaJapanese
arArabic
ruRussian
ptPortuguese
esSpanish
frFrench
deGerman
itItalian
nlDutch
plPolish
trTurkish
ukUkrainian
huHungarian
grGreek
bnBengali
maMarathi
tmTamil
tlTelugu
mlMalayalam
knKannada
taFilipino/Tagalog
bahIndonesian
guGujarati
koKorean

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).
week*StringChoose between current, prev, or next.
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": "Rat",
        "week": "08 Nov 2026 to 14 Nov 2026",
        "prediction": {
            "growth": "If you knew which two days this week would carry you, what would you save for them? Picture a tide chart by a harbour door: quiet early, rising midweek, lifting at the weekend. This year clashes head-on with your sign, so timing beats effort. Early in the week, throw out or give away one thing from a plan you have dropped.",
            "health": "If your work keeps you on your feet in the cold, as a fishmonger's does, your back and hips may carry the whole week. Pressure this month builds slowly rather than all at once, so steady habits matter more than bursts. Choose one fixed evening to stretch your back and hips for fifteen minutes on the floor.",
            "wealth": "This month's Earth presses on your Water element, like a bank narrowing a river, so money can feel tighter than the numbers say. Sui Po, the year's star for plans that may need changing, adds a reason to keep options open. Hold any larger purchase until Wednesday, then compare two options side by side on paper first.",
            "career": "Wednesday's Ox forms a six harmony with your sign, a secret friend who quietly backs you, which makes it the week's best day to be heard. Book the conversation you most need with a manager or client for then. A part-time university tutor might use it to settle next term's hours. Bring one clear request and one fallback.",
            "love": "Friday asks for a lighter touch, because the Rabbit day forms a punishment with your sign, a strain that can leave you touchy for no clear reason. Zai Sha, this year's star for steering clear of quarrels, adds weight to that. Keep the evening simple and let your partner choose what you do together.",
            "family": "Saturday brings the Dragon, which forms a three harmony with your sign: a natural ally offering easy support. Old family ties often feel lighter on days like that, when a shared job does the talking. Asking a cousin or old family friend to help sort a garage or loft may bring more warmth than any formal visit.",
            "fortune": [
                "Lucky Numbers of the week : 6, 9, 21",
                "Lucky Alphabets you will be in sync with : C, W",
                "Cosmic Tip : With Sui Po over your year, a plan that bends this week is not a failure, so keep one alternative ready for anything that matters.",
                "Tips for Singles : Saturday's natural ally makes group outings easier, so a shared activity with friends is a good setting for meeting someone new.",
                "Tips for Couples : In a year that pulls against your sign, small disagreements can feel bigger than they are, so name the real issue in one sentence before it grows."
            ]
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'tzone="5.5"' \
--form 'sign="rat"' \
--form 'week="current"'
curl -X POST "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly" \
  -H "Authorization: Bearer {Your Auth Token}" \
  --form 'api_key="{Your API Key}"' \
  --form 'tzone="5.5"' \
  --form 'sign="rat"' \
  --form 'week="current"' \
  --form 'lan="en"'
const FormData = require('form-data');
const axios = require('axios');

const form = new FormData();
form.append('api_key', '{Your API Key}');
form.append('tzone', '5.5');
form.append('sign', 'rat');
form.append('week', 'current');
form.append('lan', 'en');

const response = await axios.post('https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': 'Bearer {Your Auth Token}',
  }
});

console.log(response.data);
import requests

url = "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly"
headers = {
    "Authorization": "Bearer {Your Auth Token}",
}
payload = {
    "api_key": "{Your API Key}",
    "tzone": "5.5",
    "sign": "rat",
    "week": "current",
    "lan": "en",
}

response = requests.post(url, headers=headers, data=payload)

print(response.json())
const formData = new FormData();
formData.append('api_key', '{Your API Key}');
formData.append('tzone', '5.5');
formData.append('sign', 'rat');
formData.append('week', 'current');
formData.append('lan', 'en');

const response = await fetch('https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly', {
  method: 'POST',
  headers: {
      'Authorization': "Bearer {Your Auth Token}",
    },
  body: formData,
});

const data = await response.json();
console.log(data);
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly', [
    'headers' => [
        'Authorization' => 'Bearer {Your Auth Token}',
    ],
    'multipart' => [
        ['name' => 'api_key', 'contents' => '{Your API Key}'],
        ['name' => 'tzone', 'contents' => '5.5'],
        ['name' => 'sign', 'contents' => 'rat'],
        ['name' => 'week', 'contents' => 'current'],
        ['name' => 'lan', 'contents' => 'en'],
    ],
]);

echo $response->getBody();
package main

import (
    "bytes"
    "fmt"
    "mime/multipart"
    "net/http"
    "io"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    writer.WriteField("api_key", "{Your API Key}")
    writer.WriteField("tzone", "5.5")
    writer.WriteField("sign", "rat")
    writer.WriteField("week", "current")
    writer.WriteField("lan", "en")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly", body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("Authorization", "Bearer {Your Auth Token}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body2, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body2))
}
import okhttp3.*;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();

        RequestBody body = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("api_key", "{Your API Key}")
            .addFormDataPart("tzone", "5.5")
            .addFormDataPart("sign", "rat")
            .addFormDataPart("week", "current")
            .addFormDataPart("lan", "en")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly")
            .post(body)
            .addHeader("Authorization", "Bearer {Your Auth Token}")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}
import Foundation

let url = URL(string: "https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var bodyData = Data()
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("{Your API Key}\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"tzone\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("5.5\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"sign\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("rat\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"week\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("current\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("en\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = bodyData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()
import okhttp3.*

fun main() {
    val client = OkHttpClient()

    val body = MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("api_key", "{Your API Key}")
        .addFormDataPart("tzone", "5.5")
        .addFormDataPart("sign", "rat")
        .addFormDataPart("week", "current")
        .addFormDataPart("lan", "en")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly")
        .post(body!!)
        .addHeader("Authorization", "Bearer {Your Auth Token}")
        .build()

    client.newCall(request).execute().use { response ->
        println(response.body?.string())
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}");

        var content = new MultipartFormDataContent();
        content.Add(new StringContent("{Your API Key}"), "api_key");
        content.Add(new StringContent("5.5"), "tzone");
        content.Add(new StringContent("rat"), "sign");
        content.Add(new StringContent("current"), "week");
        content.Add(new StringContent("en"), "lan");

        var response = await client.PostAsync("https://astroapi-5.divineapi.com/api/v3/chinese-horoscope-weekly", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}
Response 200
{
    "success": 1,
    "data": {
        "sign": "Rat",
        "week": "08 Nov 2026 to 14 Nov 2026",
        "prediction": {
            "growth": "If you knew which two days this week would carry you, what would you save for them? Picture a tide chart by a harbour door: quiet early, rising midweek, lifting at the weekend. This year clashes head-on with your sign, so timing beats effort. Early in the week, throw out or give away one thing from a plan you have dropped.",
            "health": "If your work keeps you on your feet in the cold, as a fishmonger's does, your back and hips may carry the whole week. Pressure this month builds slowly rather than all at once, so steady habits matter more than bursts. Choose one fixed evening to stretch your back and hips for fifteen minutes on the floor.",
            "wealth": "This month's Earth presses on your Water element, like a bank narrowing a river, so money can feel tighter than the numbers say. Sui Po, the year's star for plans that may need changing, adds a reason to keep options open. Hold any larger purchase until Wednesday, then compare two options side by side on paper first.",
            "career": "Wednesday's Ox forms a six harmony with your sign, a secret friend who quietly backs you, which makes it the week's best day to be heard. Book the conversation you most need with a manager or client for then. A part-time university tutor might use it to settle next term's hours. Bring one clear request and one fallback.",
            "love": "Friday asks for a lighter touch, because the Rabbit day forms a punishment with your sign, a strain that can leave you touchy for no clear reason. Zai Sha, this year's star for steering clear of quarrels, adds weight to that. Keep the evening simple and let your partner choose what you do together.",
            "family": "Saturday brings the Dragon, which forms a three harmony with your sign: a natural ally offering easy support. Old family ties often feel lighter on days like that, when a shared job does the talking. Asking a cousin or old family friend to help sort a garage or loft may bring more warmth than any formal visit.",
            "fortune": [
                "Lucky Numbers of the week : 6, 9, 21",
                "Lucky Alphabets you will be in sync with : C, W",
                "Cosmic Tip : With Sui Po over your year, a plan that bends this week is not a failure, so keep one alternative ready for anything that matters.",
                "Tips for Singles : Saturday's natural ally makes group outings easier, so a shared activity with friends is a good setting for meeting someone new.",
                "Tips for Couples : In a year that pulls against your sign, small disagreements can feel bigger than they are, so name the real issue in one sentence before it grows."
            ]
        }
    }
}