Planetary Positions
Explore the current celestial layout with Planetary Positions, understanding the astrological influence of each planet.
Step by Step Planetary Positions API Postman Testing Integration
Supported Language Codes
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 body with the corresponding value of the language.
House System Codes
Support Article URL:
https://support.divineapi.com/western-astrology-apis/how-to-change-the-house-system-code-in-natal-astrology
| Code | House System Name |
|---|---|
| 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.
API Endpoint
POST https://astroapi-4.divineapi.com/western-api/v1/planetary-positions
Returns Planetary Positions in response.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token. Example: Bearer {token} |
Request Body
| 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 of birth, 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 (Timezone List) |
| lan | String | Language code (default: en) |
| house_system | String | House system code (default: P - Placidus) |
| node_type | String | meannode or truenode (default: meannode) |
200: OK Planets Positions Fetched Successfully
{
"success": 1,
"data": [
{
"name": "Ascendant",
"full_degree": "58.9993544",
"sign": "Taurus",
"sign_no": 2,
"longitude": "28:59:58",
"speed": "379.3437328",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Sun",
"full_degree": "257.2375629",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "17:14:15",
"speed": "1.0161489",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Moon",
"full_degree": "215.6951372",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "5:41:42",
"speed": "12.6900018",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Mars",
"full_degree": "250.8916331",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "10:53:30",
"speed": "0.7241894",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Mercury",
"full_degree": "277.3974655",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "7:23:51",
"speed": "0.5581587",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Earth",
"modality": "Cardinal"
},
{
"name": "Venus",
"full_degree": "215.6839880",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "5:41:2",
"speed": "1.1852668",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Jupiter",
"full_degree": "36.3737458",
"sign": "Taurus",
"sign_no": 2,
"longitude": "6:22:25",
"speed": "-0.0724541",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 12,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Saturn",
"full_degree": "331.5775299",
"sign": "Pisces",
"sign_no": 12,
"longitude": "1:34:39",
"speed": "0.0588062",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Water",
"modality": "Mutable"
},
{
"name": "North node",
"full_degree": "22.0625037",
"sign": "Aries",
"sign_no": 1,
"longitude": "22:3:45",
"speed": "-0.0529509",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "South node",
"full_degree": "202.0625037",
"sign": "Libra",
"sign_no": 7,
"longitude": "22:3:45",
"speed": "-0.0529509",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Air",
"modality": "Cardinal"
},
{
"name": "Uranus",
"full_degree": "50.0389490",
"sign": "Taurus",
"sign_no": 2,
"longitude": "20:2:20",
"speed": "-0.0355893",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 12,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Neptune",
"full_degree": "354.8909141",
"sign": "Pisces",
"sign_no": 12,
"longitude": "24:53:27",
"speed": "0.0017843",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Pluto",
"full_degree": "298.7140370",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "28:42:51",
"speed": "0.0258093",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Earth",
"modality": "Cardinal"
},
{
"name": "MC",
"full_degree": "317.0730215",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "17:4:23",
"speed": "364.5752791",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Chiron",
"full_degree": "15.5932923",
"sign": "Aries",
"sign_no": 1,
"longitude": "15:35:36",
"speed": "-0.0159938",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Part of fortune",
"full_degree": "17.4569287",
"sign": "Aries",
"sign_no": 1,
"longitude": "17:27:24",
"speed": "--",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Lilith",
"full_degree": "157.4785861",
"sign": "Virgo",
"sign_no": 6,
"longitude": "7:28:43",
"speed": "0.1113971",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Earth",
"modality": "Mutable"
}
]
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-4.divineapi.com/western-api/v1/planetary-positions' \
--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"'NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-4.divineapi.com/western-api/v1/planetary-positions',
'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);
});
JavaScript (jQuery AJAX)
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("lan", "en");
form.append("house_system", "P");
var settings = {
"url": "https://astroapi-4.divineapi.com/western-api/v1/planetary-positions",
"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-4.divineapi.com/western-api/v1/planetary-positions"
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)