Copy page
Copy page as Markdown for LLMs
Discover the essence of your astrological identity with the General Sign Report API, providing personalized insights into a planet’s sign placement (Sun, Moon, Mercury, etc.) and its attributes within the Western/Natal astrology flow.
These are the only accepted values for the :planet path parameter in the endpoint.
| Planet Value | Description |
|---|---|
| sun | For Sun data |
| moon | For Moon data |
| mars | For Mars data |
| mercury | For Mercury data |
| venus | For Venus data |
| jupiter | For Jupiter data |
| saturn | For Saturn data |
| northnode | For North Node data |
| southnode | For South Node data |
| uranus | For Uranus data |
| neptune | For Neptune data |
| pluto | For Pluto data |
| mc | For MC (Midheaven) data |
| chiron | For Chiron data |
Support Article URL:
https://support.divineapi.com/general-api-support/translating-a-natal-apis-into-a-different-language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| pt | Portuguese |
| fr | French |
| de | German |
| ja | Japanese |
| tr | Turkish |
| ru | Russian |
| it | Italian |
| es | Spanish |
| nl | Dutch |
| pl | Polish |
Guide: These languages are supported by this API. You can use them by passing lan in the request body with the corresponding language code.
House System Codes Support Article URL:
https://support.divineapi.com/western-astrology-apis/how-to-change-the-house-system-code-in-natal-astrology
| Code | Description |
|---|---|
| P | Placidus |
| K | Koch |
| R | Regiomontanus |
| C | Campanus |
| A | Equal |
| W | Equal, whole sign |
| N | Whole sign, Aries = 1st house |
| X | Axial rotation system / Meridian houses |
| T | Polich/Page ("topocentric") |
| M | Morinus |
| O | Porphyry |
| B | Alcabitius |
| D | Equal / MC |
| E | Equal = A |
| F | Carter poli-equatorial |
| G | 36 Gauquelin sectors |
| H | Horizon / Azimuth |
| I | Sunshine |
| i | Sunshine alternative |
| L | Pullen |
| S-delta | — |
| Q | Pullen |
| S-ratio | — |
| S | Sripati |
| U | Krusinski-Pisa-Goelzer |
| V | Equal Vehlow |
| Y | APC houses |
Note: The default house system used is P – Placidus.
POST https://astroapi-4.divineapi.com/western-api/v2/general-sign-report/:planet
Replace :planet with one of the allowed planet values (for example: sun, moon, mercury, mc, chiron).
Returns General Sign Report in response.
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token, e.g. Bearer {token} |
| Name | Type | Description |
|---|---|---|
| api_key* | String | Your API key |
| full_name* | String | Full name, e.g. Rahul Kumar |
| day* | Integer | Date of birth, e.g. 24 |
| month* | Integer | Month of birth, e.g. 05 |
| year* | Integer | Year of birth, e.g. 2023 |
| hour* | Integer | Hour, e.g. 14 |
| min* | Integer | Minute, e.g. 40 |
| sec* | Integer | Second, e.g. 43 |
| gender* | String | Gender, e.g. male |
| place* | String | Place, e.g. New Delhi |
| lat* | Float | Latitude, e.g. 28.7041 |
| lon* | Float | Longitude, e.g. 77.1025 |
| tzone* | Float | Timezone, e.g. 5.5 (see Timezone List) |
| lan | String | Language code, default: en |
| house_system | String | House system code, default: P (Placidus) |
{
"success": 1,
"data": {
"planet_name": "Sun",
"sign_name": "Sagittarius",
"report": [
{
"heading": "The Explorer’s Essence",
"description": "With the Sun in Sagittarius, your core essence bursts with an unquenchable thirst for exploration and discovery. You are inexorably drawn to the distant horizons of both mind and map, embodying a spirited and ever-expanding identity."
},
{
"heading": "Dream Chaser’s Emotions",
"description": "Internally, you are fueled by an optimistic and adventurous spirit. Your emotions swirl around your dreams and philosophy, driving an eternal search for deeper meaning and higher truth in life."
},
{
"heading": "Gifts of the Wanderlust Spirit",
"description": "Your innate optimism and enthusiasm serve as powerful catalysts that inspire and influence those around you. These strengths forge connections and open doors, as your genuine quest for knowledge makes you a lifelong learner and sharer of wisdom."
},
{
"heading": "Navigating the Flight of Fancy",
"description": "The challenge for such a free spirit lies in grounding your abundant ideas and maintaining focus. You might struggle with impatience or a tendency to overlook details. Embracing patience and practicality will enrich your journey."
},
{
"heading": "Mission of the Global Pathfinder",
"description": "Your life themes revolve around expanding horizons, both literally and intellectually. Your mission is to seek and spread knowledge, understanding different cultures, and weaving the tapestry of human experience into a richer whole."
}
]
}
}
Below are example implementations in various programming environments.
curl --location 'https://astroapi-4.divineapi.com/western-api/v2/general-sign-report/sun' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Rahul Kumar"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi, India"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"'
--form 'lan="en"' \
--form 'house_system="P"'
--form 'lan="en"' \
--form 'house_system="P"'
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-4.divineapi.com/western-api/v2/general-sign-report/sun',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'full_name': 'Rahul Kumar',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5'
'lan': 'en',
'house_system': 'P'
}
};
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("full_name", "Rahul Kumar");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi, India");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("house_system", "P");
var settings = {
"url": "https://astroapi-4.divineapi.com/western-api/v2/general-sign-report/sun",
"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-4.divineapi.com/western-api/v2/general-sign-report/sun"
payload = {'api_key': '{Your API Key}',
'full_name': 'Rahul Kumar',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5'
'lan': 'en',
'house_system': 'P'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)