ASTROLOGY API REFERENCE DOCUMENTATION

Astro Details/Planets Details

Get Planets Details

API Endpoint
planets
Method & Url
MethodFull Url
POSThttps://json.apireports.com/v1/planets

Response Data

{
  "status_code": 200,
  "status": true,
  "data": {
    "sun": {
      "planet_id": 1,
      "planet_name": "Sun",
      "full_degree": 148.4307032,
      "norm_degree": 28.43070320000001,
      "formatted_deg": {
        "full": "148:25:51",
        "deg": "148",
        "min": "25",
        "sec": "51"
      },
      "formatted_norm_deg": {
        "full": "28:25:51",
        "deg": "28",
        "min": "25",
        "sec": "51"
      },
      "house": 10,
      "speed": 0.9743008,
      "retro": false,
      "sign_number": 5,
      "sign": "Leo",
      "sign_lord": "Sun",
      "nakshatra": "Uttra Phalguni",
      "nakshatra_lord": "Sun",
      "nakshatra_pad": 1,
      "is_planet_set": false,
      "planet_bal_avastha": "Mrit",
      "planet_jagrat_avastha": "Supust"
    },
    "moon": {
      "planet_id": 2,
      "planet_name": "Moon",
      "full_degree": 274.1466556,
      "norm_degree": 4.146655599999974,
      "formatted_deg": {
        "full": "274:08:48",
        "deg": "274",
        "min": "08",
        "sec": "48"
      },
      "formatted_norm_deg": {
        "full": "04:08:48",
        "deg": "04",
        "min": "08",
        "sec": "48"
      },
      "house": 3,
      "speed": 13.4022877,
      "retro": false,
      "sign_number": 10,
      "sign": "Capricorn",
      "sign_lord": "Saturn",
      "nakshatra": "Uttra Ashadha",
      "nakshatra_lord": "Sun",
      "nakshatra_pad": 3,
      "is_planet_set": false,
      "planet_bal_avastha": "Mrit",
      "planet_jagrat_avastha": "Supust"
    },
    "mars": {
      "planet_id": 3,
      "planet_name": "Mars",
      "full_degree": 84.8470303,
      "norm_degree": 24.8470303,
      "formatted_deg": {
        "full": "84:50:49",
        "deg": "84",
        "min": "50",
        "sec": "49"
      },
      "formatted_norm_deg": {
        "full": "24:50:49",
        "deg": "24",
        "min": "50",
        "sec": "49"
      },
      "house": 8,
      "speed": 0.6064089,
      "retro": false,
      "sign_number": 3,
      "sign": "Gemini",
      "sign_lord": "Mercury",
      "nakshatra": "Punarvasu",
      "nakshatra_lord": "Jupiter",
      "nakshatra_pad": 2,
      "is_planet_set": false,
      "planet_bal_avastha": "Vridha",
      "planet_jagrat_avastha": "Supust"
    },
    "mercury": {
      "planet_id": 4,
      "planet_name": "Mercury",
      "full_degree": 172.2615,
      "norm_degree": 22.261500000000012,
      "formatted_deg": {
        "full": "172:15:41",
        "deg": "172",
        "min": "15",
        "sec": "41"
      },
      "formatted_norm_deg": {
        "full": "22:15:41",
        "deg": "22",
        "min": "15",
        "sec": "41"
      },
      "house": 11,
      "speed": 1.3272461,
      "retro": false,
      "sign_number": 6,
      "sign": "Virgo",
      "sign_lord": "Mercury",
      "nakshatra": "Hasta",
      "nakshatra_lord": "Moon",
      "nakshatra_pad": 4,
      "is_planet_set": false,
      "planet_bal_avastha": "Kumar",
      "planet_jagrat_avastha": "Jagrat"
    },
    "jupiter": {
      "planet_id": 5,
      "planet_name": "Jupiter",
      "full_degree": 198.3659483,
      "norm_degree": 18.365948300000014,
      "formatted_deg": {
        "full": "198:21:57",
        "deg": "198",
        "min": "21",
        "sec": "57"
      },
      "formatted_norm_deg": {
        "full": "18:21:57",
        "deg": "18",
        "min": "21",
        "sec": "57"
      },
      "house": 12,
      "speed": 0.1754549,
      "retro": false,
      "sign_number": 7,
      "sign": "Libra",
      "sign_lord": "Venus",
      "nakshatra": "Swati",
      "nakshatra_lord": "Rahu",
      "nakshatra_pad": 4,
      "is_planet_set": false,
      "planet_bal_avastha": "Yuva",
      "planet_jagrat_avastha": "Swapan"
    },
    "venus": {
      "planet_id": 6,
      "planet_name": "Venus",
      "full_degree": 192.2197635,
      "norm_degree": 12.2197635,
      "formatted_deg": {
        "full": "192:13:11",
        "deg": "192",
        "min": "13",
        "sec": "11"
      },
      "formatted_norm_deg": {
        "full": "12:13:11",
        "deg": "12",
        "min": "13",
        "sec": "11"
      },
      "house": 12,
      "speed": 0.7407756,
      "retro": false,
      "sign_number": 7,
      "sign": "Libra",
      "sign_lord": "Venus",
      "nakshatra": "Swati",
      "nakshatra_lord": "Rahu",
      "nakshatra_pad": 2,
      "is_planet_set": false,
      "planet_bal_avastha": "Kumar",
      "planet_jagrat_avastha": "Swapan"
    },
    "saturn": {
      "planet_id": 7,
      "planet_name": "Saturn",
      "full_degree": 314.2033624,
      "norm_degree": 14.203362400000003,
      "formatted_deg": {
        "full": "314:12:12",
        "deg": "314",
        "min": "12",
        "sec": "12"
      },
      "formatted_norm_deg": {
        "full": "14:12:12",
        "deg": "14",
        "min": "12",
        "sec": "12"
      },
      "house": 4,
      "speed": -0.0725449,
      "retro": true,
      "sign_number": 11,
      "sign": "Aquarius",
      "sign_lord": "Saturn",
      "nakshatra": "Shatabhisha",
      "nakshatra_lord": "Rahu",
      "nakshatra_pad": 3,
      "is_planet_set": false,
      "planet_bal_avastha": "Yuva",
      "planet_jagrat_avastha": "Swapan"
    },
    "rahu": {
      "planet_id": 8,
      "planet_name": "Rahu",
      "full_degree": 203.6850613,
      "norm_degree": 23.6850613,
      "formatted_deg": {
        "full": "203:41:06",
        "deg": "203",
        "min": "41",
        "sec": "06"
      },
      "formatted_norm_deg": {
        "full": "23:41:06",
        "deg": "23",
        "min": "41",
        "sec": "06"
      },
      "house": 12,
      "speed": -0.0529538,
      "retro": true,
      "sign_number": 7,
      "sign": "Libra",
      "sign_lord": "Venus",
      "nakshatra": "Vishakha",
      "nakshatra_lord": "Jupiter",
      "nakshatra_pad": 2,
      "is_planet_set": false,
      "planet_bal_avastha": "Vridha",
      "planet_jagrat_avastha": "Supust"
    },
    "ketu": {
      "planet_id": 9,
      "planet_name": "Ketu",
      "full_degree": 23.68506130000003,
      "norm_degree": 23.68506130000003,
      "formatted_deg": {
        "full": "23:41:06",
        "deg": "23",
        "min": "41",
        "sec": "06"
      },
      "formatted_norm_deg": {
        "full": "23:41:06",
        "deg": "23",
        "min": "41",
        "sec": "06"
      },
      "house": 6,
      "speed": -0.0529538,
      "retro": true,
      "sign_number": 1,
      "sign": "Aries",
      "sign_lord": "Mars",
      "nakshatra": "Bharani",
      "nakshatra_lord": "Venus",
      "nakshatra_pad": 4,
      "is_planet_set": false,
      "planet_bal_avastha": "Vridha",
      "planet_jagrat_avastha": "Supust"
    },
    "ascendant": {
      "planet_id": 13,
      "planet_name": "Ascendant",
      "full_degree": 230.5852794,
      "norm_degree": 20.58527939999999,
      "formatted_deg": {
        "full": "230:35:07",
        "deg": "230",
        "min": "35",
        "sec": "07"
      },
      "formatted_norm_deg": {
        "full": "20:35:07",
        "deg": "20",
        "min": "35",
        "sec": "07"
      },
      "house": 1,
      "speed": 0,
      "retro": "",
      "sign_number": 8,
      "sign": "Scorpio",
      "sign_lord": "Mars",
      "nakshatra": "Jyeshtha",
      "nakshatra_lord": "Mercury",
      "nakshatra_pad": 2,
      "is_planet_set": "",
      "planet_bal_avastha": "",
      "planet_jagrat_avastha": ""
    }
  }
}
JSON
Params Data Type Description Example
day int Date of Birth 15
month int Month of Birth 9
year int Year of Birth 1994
hour int Hour of Birth 12
min int Min of Birth 30
lat float Latitude of Birth Place 28.6139
lon float Longitude of Birth Place 77.1025
tzone float Timezone of Birth Place 5.5 
# cURL Request Example

curl --location --request POST 'https://json.apireports.com/v1/planets' \
-u '{YourUserID}:{YourApiKey}'\
--header 'Accept-Language: en' \
--header 'Content-Type: application/json' \
--data-raw '{
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
}'

# END
cURL
/* JavaScript Request Example */

var apiEndPoint = "planets";
var userId = "{YourUserID}";
var apiKey = "{YourApiKey}";
var language = "en";
var data = {
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
};
var url = 'https://json.apireports.com/v1/'+apiEndPoint;

var request = $.ajax({
	url: url,
	method: "POST",
	dataType:'json',
	headers: {
		"Authorization": "Basic " + btoa(userId+":"+apiKey),
		"Accept-Language": "en",
		"Content-Type":'application/json'
	},
	data:JSON.stringify(data)
});

request.then(
	function(resp){
		console.log(resp);
	},
	function(err){
		console.log(err);
	}
);

/* END */
JavaScript
<?php
/* PHP Request Example */

$apiEndPoint = "planets";
$userId = "{YourUserID}";
$apiKey = "{YourApiKey}";
$url = "https://json.apireports.com/v1/";
$data = array(
	"day" => 15,
	"month" => 9,
	"year" => 1994,
	"hour" => 12,
	"min" => 30,
	"lat" => 28.6139,
	"lon" => 77.1025,
	"tzone" => 5.5
);
$ch = curl_init();
curl_setopt($ch,CURLOPT_URL, $url.$apiEndPoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 20);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$header[] = 'Authorization: Basic '. base64_encode($userId.":".$apiKey);
$header[] = 'Accept-Language: en';
$header[] = 'Content-Type: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
$error = curl_error($ch);
$http_code = curl_getinfo($ch ,CURLINFO_HTTP_CODE);
curl_close($ch);
echo $response;

/* END */
PHP
# Python Request Example

import requests
import json

apiEndPoint = "planets";
userId = "{YourUserID}";
apiKey = "{YourApiKey}";
url = "https://json.apireports.com/v1/"+apiEndPoint

data = json.dumps({
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
})

headers = {
  'Accept-Language': 'en',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, auth=(userId, apiKey),data=data)

print(response.text)

# END
Python
/* NodeJS Request Example */

var request = require('request');
var apiEndPoint = "planets";
var userId = "{YourUserID}";
var apiKey = "{YourApiKey}";
var url = 'https://json.apireports.com/v1/'+apiEndPoint;
var options = {
  'method': 'POST',
  'url': url,
  'auth': {
    'user': userId,
    'password': apiKey
  },
  'headers': {
    'Accept-Language': 'en',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
})
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

/* END */
NodeJS

Astrology API Reports in News