Planets - Extended information

API Endpoint:

planets/extended

Method:

POST

Full URL:

https://json.freeastrologyapi.com/planets/extended


Request data
Parameter Data type Description Constraints Required
year Integer Year number, eg: 2023 Valid year Number Yes
month Integer Month number,with no leading zero eg: 7 or 8 Valid month number Yes
date Integer Day number,with no leading zero eg: 5 or 6 Valid date number Yes
hours Integer Hours number,with no leading zero eg: 1 or 2 Valid hours number Yes
minutes Integer Minutes number,with no leading zero eg: 0 or 1 Valid minutes number Yes
seconds Integer Seconds number,with no leading zero eg: 0 or 1 Valid seconds number Yes
latitude Float Latitude number, in the range from -90 to 90 Valid latitude Yes
longitude Float Longitude number, in the range from -180 to 180 Valid longitude Yes
timezone Float Timezone of birth location, eg: 5.5 Valid timezone Yes
config Object Contains optional configuration values Optional No
observation_point String Either "topocentric" or "geocentric" Optional No
ayanamsha String Either "sayana" or "lahiri" Optional No
language String Either "en" or "te" Optional No


Sample Payload 


    
        {
        "year": 2024,
        "month": 6,
        "date": 10,
        "hours": 15,
        "minutes": 10,
        "seconds": 0,
        "latitude": 18.9333,
        "longitude": 72.8166,
        "timezone": 5.5,
        "settings": {
            "observation_point": "topocentric", /*  topocentric / geocentric */
            "ayanamsha": "lahiri", /* lahiri / sayana */
            "language": "te" /* te / en */
            }
        }
    

    
        {
        "year": 2024,
        "month": 6,
        "date": 10,
        "hours": 15,
        "minutes": 10,
        "seconds": 0,
        "latitude": 18.9333,
        "longitude": 72.8166,
        "timezone": 5.5,
        "settings": {
            "observation_point": "topocentric", /*  topocentric / geocentric */
            "ayanamsha": "lahiri", /* lahiri / sayana */
            "language": "en" /* te / en */
            }
        }


Sample Code


    
        $curl = curl_init();

        curl_setopt_array($curl, array(
        CURLOPT_URL => 'https://json.apiastro.com/planets/extended',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS =>'{
            "year": 2024,
            "month": 6,
            "date": 10,
            "hours": 15,
            "minutes": 10,
            "seconds": 0,
            "latitude": 18.9333,
            "longitude": 72.8166,
            "timezone": 5.5,
            "settings": {
                "observation_point": "topocentric",
                "ayanamsha": "lahiri",
                "language":"te"
            }

        }',
        CURLOPT_HTTPHEADER => array(
            'Content-Type: application/json',
            'x-api-key: YOUR_API_KEY_HERE'
        ),
        ));

        $response = curl_exec($curl);

        curl_close($curl);
        echo $response;
    

    
        import requests
        import json

        url = "https://json.apiastro.com/planets/extended"

        payload = json.dumps({
        "year": 2024,
        "month": 6,
        "date": 10,
        "hours": 15,
        "minutes": 10,
        "seconds": 0,
        "latitude": 18.9333,
        "longitude": 72.8166,
        "timezone": 5.5,
        "settings": {
            "observation_point": "topocentric",
            "ayanamsha": "lahiri",
            "language": "te"
        }
        })
        headers = {
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY_HERE'
        }

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

        print(response.text)

    

    
        var request = require('request');
        var options = {
        'method': 'POST',
        'url': 'https://json.apiastro.com/planets/extended',
        'headers': {
            'Content-Type': 'application/json',
            'x-api-key': 'YOUR_API_KEY_HERE'
        },
        body: JSON.stringify({
            "year": 2024,
            "month": 6,
            "date": 10,
            "hours": 15,
            "minutes": 10,
            "seconds": 0,
            "latitude": 18.9333,
            "longitude": 72.8166,
            "timezone": 5.5,
            "settings": {
            "observation_point": "topocentric",
            "ayanamsha": "lahiri",
            "language": "te"
            }
        })

        };
        request(options, function (error, response) {
        if (error) throw new Error(error);
        console.log(response.body);
        });


Response data

    

        {
            "statusCode": 200,
            "output": {
                "Ascendant": {
                    "current_sign": 5,
                    "fullDegree": 124.88125403997319,
                    "normDegree": 4.881254039973186,
                    "isRetro": "false",
                    "degrees": 4,
                    "minutes": 52,
                    "seconds": 52.514543903469075,
                    "house_number": 1,
                    "localized_name": "లగ్నం",
                    "zodiac_sign_name": "సింహము",
                    "zodiac_sign_lord": "రవి",
                    "nakshatra_number": 10,
                    "nakshatra_name": "మఘ",
                    "nakshatra_pada": 2,
                    "nakshatra_vimsottari_lord": "కేతు"
                },
                "Sun": {
                    "current_sign": 2,
                    "house_number": 10,
                    "fullDegree": 55.94243834021972,
                    "normDegree": 25.942438340219717,
                    "isRetro": "false",
                    "degrees": 25,
                    "minutes": 56,
                    "seconds": 32.77802479097943,
                    "localized_name": "రవి",
                    "zodiac_sign_name": "వృషభము",
                    "zodiac_sign_lord": "శుక్రుడు",
                    "nakshatra_number": 5,
                    "nakshatra_name": "మృగశిర",
                    "nakshatra_pada": 1,
                    "nakshatra_vimsottari_lord": "కుజుడు"
                },
                "Moon": {
                    "current_sign": 7,
                    "house_number": 3,
                    "fullDegree": 208.64642093769868,
                    "normDegree": 28.64642093769868,
                    "isRetro": "false",
                    "degrees": 28,
                    "minutes": 38,
                    "seconds": 47.11537571524332,
                    "localized_name": "చంద్రుడు",
                    "zodiac_sign_name": "తుల",
                    "zodiac_sign_lord": "శుక్రుడు",
                    "nakshatra_number": 16,
                    "nakshatra_name": "విశాఖ",
                    "nakshatra_pada": 3,
                    "nakshatra_vimsottari_lord": "గురుడు"
                },
                "Mars": {
                    "current_sign": 4,
                    "house_number": 12,
                    "fullDegree": 110.62046117683758,
                    "normDegree": 20.62046117683758,
                    "isRetro": "false",
                    "degrees": 20,
                    "minutes": 37,
                    "seconds": 13.660236615287431,
                    "localized_name": "కుజుడు",
                    "zodiac_sign_name": "కర్కాటకము",
                    "zodiac_sign_lord": "చంద్రుడు",
                    "nakshatra_number": 9,
                    "nakshatra_name": "ఆశ్లేష",
                    "nakshatra_pada": 2,
                    "nakshatra_vimsottari_lord": "బుధుడు"
                },
                "Mercury": {
                    "current_sign": 2,
                    "house_number": 10,
                    "fullDegree": 33.89956760465726,
                    "normDegree": 3.899567604657257,
                    "isRetro": "false",
                    "degrees": 3,
                    "minutes": 53,
                    "seconds": 58.44337676612497,
                    "localized_name": "బుధుడు",
                    "zodiac_sign_name": "వృషభము",
                    "zodiac_sign_lord": "శుక్రుడు",
                    "nakshatra_number": 3,
                    "nakshatra_name": "కృత్తిక",
                    "nakshatra_pada": 3,
                    "nakshatra_vimsottari_lord": "రవి"
                },
                "Jupiter": {
                    "current_sign": 1,
                    "house_number": 9,
                    "fullDegree": 24.223142882520122,
                    "normDegree": 24.223142882520122,
                    "isRetro": "false",
                    "degrees": 24,
                    "minutes": 13,
                    "seconds": 23.314377072439356,
                    "localized_name": "గురువు",
                    "zodiac_sign_name": "మేషం",
                    "zodiac_sign_lord": "కుజుడు",
                    "nakshatra_number": 2,
                    "nakshatra_name": "భరణి",
                    "nakshatra_pada": 4,
                    "nakshatra_vimsottari_lord": "శుక్రుడు"
                },
                "Venus": {
                    "current_sign": 2,
                    "house_number": 10,
                    "fullDegree": 53.77706362802696,
                    "normDegree": 23.77706362802696,
                    "isRetro": "false",
                    "degrees": 23,
                    "minutes": 46,
                    "seconds": 37.42906089705059,
                    "localized_name": "శుక్రుడు",
                    "zodiac_sign_name": "వృషభము",
                    "zodiac_sign_lord": "శుక్రుడు",
                    "nakshatra_number": 5,
                    "nakshatra_name": "మృగశిర",
                    "nakshatra_pada": 1,
                    "nakshatra_vimsottari_lord": "కుజుడు"
                },
                "Saturn": {
                    "current_sign": 4,
                    "house_number": 12,
                    "fullDegree": 97.00945882520148,
                    "normDegree": 7.009458825201477,
                    "isRetro": "false",
                    "degrees": 7,
                    "minutes": 0,
                    "seconds": 34.05177072531842,
                    "localized_name": "శని",
                    "zodiac_sign_name": "కర్కాటకము",
                    "zodiac_sign_lord": "చంద్రుడు",
                    "nakshatra_number": 8,
                    "nakshatra_name": "పుష్య",
                    "nakshatra_pada": 2,
                    "nakshatra_vimsottari_lord": "శని"
                },
                "Rahu": {
                    "current_sign": 7,
                    "house_number": 3,
                    "fullDegree": 197.20188515374542,
                    "normDegree": 17.201885153745422,
                    "isRetro": "true",
                    "degrees": 17,
                    "minutes": 12,
                    "seconds": 6.786553483520947,
                    "localized_name": "రాహు",
                    "zodiac_sign_name": "తుల",
                    "zodiac_sign_lord": "శుక్రుడు",
                    "nakshatra_number": 15,
                    "nakshatra_name": "స్వాతి",
                    "nakshatra_pada": 4,
                    "nakshatra_vimsottari_lord": "రాహు"
                },
                "Ketu": {
                    "current_sign": 1,
                    "house_number": 9,
                    "fullDegree": 17.201885153745415,
                    "normDegree": 17.201885153745415,
                    "isRetro": "true",
                    "degrees": 17,
                    "minutes": 12,
                    "seconds": 6.786553483495368,
                    "localized_name": "కేతు",
                    "zodiac_sign_name": "మేషం",
                    "zodiac_sign_lord": "కుజుడు",
                    "nakshatra_number": 2,
                    "nakshatra_name": "భరణి",
                    "nakshatra_pada": 2,
                    "nakshatra_vimsottari_lord": "శుక్రుడు"
                },
                "Uranus": {
                    "current_sign": 7,
                    "house_number": 3,
                    "fullDegree": 189.90425842761877,
                    "normDegree": 9.904258427618771,
                    "isRetro": "true",
                    "degrees": 9,
                    "minutes": 54,
                    "seconds": 15.330339427575836,
                    "localized_name": "యురేనస్",
                    "zodiac_sign_name": "తుల",
                    "zodiac_sign_lord": "శుక్రుడు",
                    "nakshatra_number": 15,
                    "nakshatra_name": "స్వాతి",
                    "nakshatra_pada": 1,
                    "nakshatra_vimsottari_lord": "రాహు"
                },
                "Neptune": {
                    "current_sign": 8,
                    "house_number": 4,
                    "fullDegree": 228.8692084961828,
                    "normDegree": 18.869208496182807,
                    "isRetro": "true",
                    "degrees": 18,
                    "minutes": 52,
                    "seconds": 9.15058625810616,
                    "localized_name": "నెప్ట్యూన్",
                    "zodiac_sign_name": "వృశ్చికము",
                    "zodiac_sign_lord": "కుజుడు",
                    "nakshatra_number": 18,
                    "nakshatra_name": "జ్యేష్ఠ",
                    "nakshatra_pada": 1,
                    "nakshatra_vimsottari_lord": "బుధుడు"
                },
                "Pluto": {
                    "current_sign": 6,
                    "house_number": 2,
                    "fullDegree": 165.42193727666407,
                    "normDegree": 15.421937276664067,
                    "isRetro": "true",
                    "degrees": 15,
                    "minutes": 25,
                    "seconds": 18.974195990642784,
                    "localized_name": "ప్లూటో",
                    "zodiac_sign_name": "కన్య",
                    "zodiac_sign_lord": "బుధుడు",
                    "nakshatra_number": 13,
                    "nakshatra_name": "హస్త",
                    "nakshatra_pada": 2,
                    "nakshatra_vimsottari_lord": "చంద్రుడు"
                }
            }
        }
    

    
    {
        "statusCode": 200,
        "output": {
            "Ascendant": {
                "current_sign": 5,
                "fullDegree": 124.88125403997319,
                "normDegree": 4.881254039973186,
                "isRetro": "false",
                "degrees": 4,
                "minutes": 52,
                "seconds": 52.514543903469075,
                "house_number": 1,
                "localized_name": "Ascendant",
                "zodiac_sign_name": "Leo",
                "zodiac_sign_lord": "Sun",
                "nakshatra_number": 10,
                "nakshatra_name": "Makha",
                "nakshatra_pada": 2,
                "nakshatra_vimsottari_lord": "Ketu"
            },
            "Sun": {
                "current_sign": 2,
                "house_number": 10,
                "fullDegree": 55.94243834021972,
                "normDegree": 25.942438340219717,
                "isRetro": "false",
                "degrees": 25,
                "minutes": 56,
                "seconds": 32.77802479097943,
                "localized_name": "Sun",
                "zodiac_sign_name": "Taurus",
                "zodiac_sign_lord": "Venus",
                "nakshatra_number": 5,
                "nakshatra_name": "Mrigasira",
                "nakshatra_pada": 1,
                "nakshatra_vimsottari_lord": "Mars"
            },
            "Moon": {
                "current_sign": 7,
                "house_number": 3,
                "fullDegree": 208.64642093769868,
                "normDegree": 28.64642093769868,
                "isRetro": "false",
                "degrees": 28,
                "minutes": 38,
                "seconds": 47.11537571524332,
                "localized_name": "Moon",
                "zodiac_sign_name": "Libra",
                "zodiac_sign_lord": "Venus",
                "nakshatra_number": 16,
                "nakshatra_name": "Visakha",
                "nakshatra_pada": 3,
                "nakshatra_vimsottari_lord": "Jupiter"
            },
            "Mars": {
                "current_sign": 4,
                "house_number": 12,
                "fullDegree": 110.62046117683758,
                "normDegree": 20.62046117683758,
                "isRetro": "false",
                "degrees": 20,
                "minutes": 37,
                "seconds": 13.660236615287431,
                "localized_name": "Mars",
                "zodiac_sign_name": "Cancer",
                "zodiac_sign_lord": "Moon",
                "nakshatra_number": 9,
                "nakshatra_name": "Aaslesha",
                "nakshatra_pada": 2,
                "nakshatra_vimsottari_lord": "Mercury"
            },
            "Mercury": {
                "current_sign": 2,
                "house_number": 10,
                "fullDegree": 33.89956760465726,
                "normDegree": 3.899567604657257,
                "isRetro": "false",
                "degrees": 3,
                "minutes": 53,
                "seconds": 58.44337676612497,
                "localized_name": "Mercury",
                "zodiac_sign_name": "Taurus",
                "zodiac_sign_lord": "Venus",
                "nakshatra_number": 3,
                "nakshatra_name": "Krittika",
                "nakshatra_pada": 3,
                "nakshatra_vimsottari_lord": "Sun"
            },
            "Jupiter": {
                "current_sign": 1,
                "house_number": 9,
                "fullDegree": 24.223142882520122,
                "normDegree": 24.223142882520122,
                "isRetro": "false",
                "degrees": 24,
                "minutes": 13,
                "seconds": 23.314377072439356,
                "localized_name": "Jupiter",
                "zodiac_sign_name": "Aries",
                "zodiac_sign_lord": "Mars",
                "nakshatra_number": 2,
                "nakshatra_name": "Bharani",
                "nakshatra_pada": 4,
                "nakshatra_vimsottari_lord": "Venus"
            },
            "Venus": {
                "current_sign": 2,
                "house_number": 10,
                "fullDegree": 53.77706362802696,
                "normDegree": 23.77706362802696,
                "isRetro": "false",
                "degrees": 23,
                "minutes": 46,
                "seconds": 37.42906089705059,
                "localized_name": "Venus",
                "zodiac_sign_name": "Taurus",
                "zodiac_sign_lord": "Venus",
                "nakshatra_number": 5,
                "nakshatra_name": "Mrigasira",
                "nakshatra_pada": 1,
                "nakshatra_vimsottari_lord": "Mars"
            },
            "Saturn": {
                "current_sign": 4,
                "house_number": 12,
                "fullDegree": 97.00945882520148,
                "normDegree": 7.009458825201477,
                "isRetro": "false",
                "degrees": 7,
                "minutes": 0,
                "seconds": 34.05177072531842,
                "localized_name": "Saturn",
                "zodiac_sign_name": "Cancer",
                "zodiac_sign_lord": "Moon",
                "nakshatra_number": 8,
                "nakshatra_name": "Pushyami",
                "nakshatra_pada": 2,
                "nakshatra_vimsottari_lord": "Saturn"
            },
            "Rahu": {
                "current_sign": 7,
                "house_number": 3,
                "fullDegree": 197.20188515374542,
                "normDegree": 17.201885153745422,
                "isRetro": "true",
                "degrees": 17,
                "minutes": 12,
                "seconds": 6.786553483520947,
                "localized_name": "Rahu",
                "zodiac_sign_name": "Libra",
                "zodiac_sign_lord": "Venus",
                "nakshatra_number": 15,
                "nakshatra_name": "Swati",
                "nakshatra_pada": 4,
                "nakshatra_vimsottari_lord": "Rahu"
            },
            "Ketu": {
                "current_sign": 1,
                "house_number": 9,
                "fullDegree": 17.201885153745415,
                "normDegree": 17.201885153745415,
                "isRetro": "true",
                "degrees": 17,
                "minutes": 12,
                "seconds": 6.786553483495368,
                "localized_name": "Ketu",
                "zodiac_sign_name": "Aries",
                "zodiac_sign_lord": "Mars",
                "nakshatra_number": 2,
                "nakshatra_name": "Bharani",
                "nakshatra_pada": 2,
                "nakshatra_vimsottari_lord": "Venus"
            },
            "Uranus": {
                "current_sign": 7,
                "house_number": 3,
                "fullDegree": 189.90425842761877,
                "normDegree": 9.904258427618771,
                "isRetro": "true",
                "degrees": 9,
                "minutes": 54,
                "seconds": 15.330339427575836,
                "localized_name": "Uranus",
                "zodiac_sign_name": "Libra",
                "zodiac_sign_lord": "Venus",
                "nakshatra_number": 15,
                "nakshatra_name": "Swati",
                "nakshatra_pada": 1,
                "nakshatra_vimsottari_lord": "Rahu"
            },
            "Neptune": {
                "current_sign": 8,
                "house_number": 4,
                "fullDegree": 228.8692084961828,
                "normDegree": 18.869208496182807,
                "isRetro": "true",
                "degrees": 18,
                "minutes": 52,
                "seconds": 9.15058625810616,
                "localized_name": "Neptune",
                "zodiac_sign_name": "Scorpio",
                "zodiac_sign_lord": "Mars",
                "nakshatra_number": 18,
                "nakshatra_name": "Jyeshta",
                "nakshatra_pada": 1,
                "nakshatra_vimsottari_lord": "Mercury"
            },
            "Pluto": {
                "current_sign": 6,
                "house_number": 2,
                "fullDegree": 165.42193727666407,
                "normDegree": 15.421937276664067,
                "isRetro": "true",
                "degrees": 15,
                "minutes": 25,
                "seconds": 18.974195990642784,
                "localized_name": "Pluto",
                "zodiac_sign_name": "Virgo",
                "zodiac_sign_lord": "Mercury",
                "nakshatra_number": 13,
                "nakshatra_name": "Hasta",
                "nakshatra_pada": 2,
                "nakshatra_vimsottari_lord": "Moon"
            }
        }
    }