Planet Analysis API

This documentation explains how to use the Planet Analysis API to get a detailed, planet-specific interpretation based on the planet’s house, sign, and lord placement in a native’s horoscope.

Planet Codes (analysis_planet)

The analysis_planet field tells the API which planet’s interpretation you want.

sun : For Sun

moon : For Moon

mars : For Mars

mercury : For Mercury

venus : For Venus

saturn : For Saturn

jupiter : For Jupiter

ketu : For Ketu

rahu : For Rahu

Step by Step Planet Analysis API Postman Testing Integration

Step by Step Planet Analysis API Postman Testing Integration

Supported Language Codes

Support Article URL
https://support.divineapi.com/general-api-support/translating-an-indian-vedic-apis-into-a-different-language

Code	Language
en	English
hi	Hindi
bn	Bengali
ma	Marathi
tm	Tamil
tl	Telugu
ml	Malayalam
kn	Kannada

Guide
These languages are supported by this API. You can pass "lan" in the body with a value from the above table. Default is en.

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v2/planet-analysis

Description

The Planet Analysis API returns:

the planet requested (planet)

its sign, house, lord and longitude

an image URL for the planet

two rich interpretation blocks:

planet_in_house – how the planet behaves in the house it occupies

planet_in_sign – how the planet expresses in its zodiac sign

This makes it suitable for horoscope-report builders, mobile astrology apps, and dashboard-style interpretations.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token, e.g. `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 of birth (24-hr), e.g. `14`
min*	Integer	Minute, e.g. `40`
sec*	Integer	Second, e.g. `43`
gender*	String	Gender, e.g. `male`
place*	String	Birth 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	Optional language code; default `en`
analysis_planet*	String	Planet code, e.g. `moon`, `sun`, `saturn`

Timezone Reference
Understanding Time Zones – Divine API

200: OK Planet Analysis fetched successfully

{
    "success": 1,
    "data": {
        "planet": "Moon",
        "sign": "Libra",
        "sign_no": 7,
        "house": 6,
        "longitude": "11:30:20",
        "lord": "Venus",
        "image": "https://divineapi.com/public/api-assets/assets/images/planets/Moon.png",
        "analysis": {
            "planet_in_house": [
                {
                    "heading": "Harmonizer of the Work Sphere",
                    "description": "With the Moon in the sixth house, you bring emotional sensitivity to your work environment. You may be highly attuned to the emotional needs of your colleagues and have a nurturing and supportive approach. Your empathetic nature allows you to create harmonious and caring relationships with coworkers."
                },
                {
                    "heading": "Guardian of Physical and Emotional Balance",
                    "description": "The placement of the Moon in the sixth house indicates an intuitive awareness of health and well-being. You have a natural ability to sense what your body needs and understand the importance of self-care. Trusting your instincts can guide you in making beneficial choices for your physical and emotional health."
                },
                {
                    "heading": "Emissary of Daily Rituals",
                    "description": "Your emotions are closely tied to your daily routines and work responsibilities. The way you structure your day and the tasks you engage in can significantly impact your mood and emotional well-being. It's important for you to find a healthy balance and establish routines that support your emotional needs."
                },
                {
                    "heading": "Nurturer in the Professional Realm",
                    "description": "You have a nurturing and supportive approach to your work. You may excel in roles where you can provide care and assistance to others, such as healthcare, counseling, or social services. Your compassion and understanding create a positive and harmonious work environment."
                },
                {
                    "heading": "Seeker of Emotional Consistency in Career",
                    "description": "The Moon's influence in the sixth house can bring fluctuations in your work motivation. Your level of enthusiasm and dedication may vary depending on your emotional state. It's important for you to find ways to stay motivated and engaged, even during periods of emotional ups and downs."
                }
            ],
            "planet_in_sign": [
                {
                    "heading": "Harmonious Emotional Landscape",
                    "description": "With the Moon in Libra, your emotional world basks in the glow of harmony and grace. You feel most secure and at peace when surrounded by balanced relationships and aesthetic beauty, seeking an environment that reflects your inner need for tranquility."
                },
                {
                    "heading": "Diplomat of the Heart",
                    "description": "Internally, you navigate the complexities of emotions with diplomacy. Your heart yearns for balance and you often act as the mediator in emotional conflicts. This attunement to others' feelings makes you exceptionally empathetic but also vulnerable to external discord."
                },
                {
                    "heading": "Peacemaker's Strength",
                    "description": "Your greatest strengths lie in your gentle approach to handling conflicts and your innate ability to understand different perspectives. This not only endears you to others but often places you in roles where tact and fairness are required."
                },
                {
                    "heading": "Challenges in Self-Assertion",
                    "description": "The quest for external peace can sometimes lead you to compromise too much of yourself. The challenge for your emotional growth is learning to affirm your own needs and express your discontent when necessary, without fearing the loss of harmony."
                },
                {
                    "heading": "Mission of Relational Balance",
                    "description": "Your life’s mission revolves around creating and maintaining balance, particularly within relationships. You are drawn to roles that enable you to foster understanding and cooperation among diverse individuals, enhancing not only your personal world but also the broader social fabric."
                }
            ]
        }
    }
}

Example Integrations

Below are examples of how you might call this API using different programming languages and environments.

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/planet-returns-list' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'planet="MOON"' \
--form 'full_name="Test"' \
--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"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \
--form 'return_year="2024"' \
--form 'return_place="New Delhi"' \
--form 'return_lat="28.7041"' \
--form 'return_lon="77.1025"' \
--form 'return_tzone="5.5"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v2/planet-analysis',
  '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 ',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'lan': 'en',
    'analysis_planet': 'moon'
  }
};
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 ");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");
form.append("analysis_planet", "moon");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v2/planet-analysis",
  "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-3.divineapi.com/indian-api/v2/planet-analysis"

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 ',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',
'analysis_planet': 'moon'}

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

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

print(response.text)