Aspects - Western Astrology

API Endpoint:

western/aspects

Method:

POST

Full URL:

https://json.freeastrologyapi.com/western/aspects


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 tropical or sayana or lahiri Optional No
language String either en or es or fr or pt or ru or de or ja Optional No
exclude_planets Array Array of Planets, which you want to be excluded. By default all the planets will be considered. For example, ["Lilith","Chiron"] will exclude Lilith,Chiron for calculating aspects. Optional No
allowed_aspects Array Array of Aspects, only which you want to be included. By default all the above aspects will be considered. For example ["Conjunction","Trine"] will consider only Conjunction and Trine. Optional No
orb_values Object For each aspect, a custom orb can be mentioned. For example,{"Conjunction": 3, "Opposition": 5, "Square": 5, "Trine": 5} Optional- Range from 0 to 15 No


Sample Payload 



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "language": "en", /* en , te , es , fr , pt , ru , de ,  ja */
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": ["Conjunction","Trine"], /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "language": "es",
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": ["Conjunction","Trine"], /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "language": "fr",
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": ["Conjunction","Trine"], /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "language": "pt",
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": ["Conjunction","Trine"], /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "language": "ru",
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": ["Conjunction","Trine"], /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "language": "de",
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": ["Conjunction","Trine"], /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "language": "ja",
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": ["Conjunction","Trine"], /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}


Sample Code



$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/western/aspects',
  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": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "language": "en",
        "exclude_planets": ["Lilith","Chiron","Ceres","Vesta","Juno","Pallas"],
        "allowed_aspects": ["Conjunction","Trine"],
        "orb_values":{
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}',
  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.freeastrologyapi.com/western/aspects"

payload = json.dumps({
  "year": 1998,
  "month": 3,
  "date": 3,
  "hours": 10,
  "minutes": 30,
  "seconds": 0,
  "latitude": 17.38405,
  "longitude": 78.45636,
  "timezone": 5.5,
  "config": {
    "observation_point": "topocentric",
    "ayanamsha": "tropical",
    "language": "en",
    "exclude_planets": [
      "Lilith",
      "Chiron",
      "Ceres",
      "Vesta",
      "Juno",
      "Pallas"
    ],
    "allowed_aspects": [
      "Conjunction",
      "Trine"
    ],
    "orb_values": {
      "Conjunction": 3,
      "Opposition": 5,
      "Square": 5,
      "Trine": 5,
      "Sextile": 5,
      "Semi-Sextile": 5,
      "Quintile": 5,
      "Septile": 5,
      "Octile": 5,
      "Novile": 5,
      "Quincunx": 5,
      "Sesquiquadrate": 5
    }
  }
})
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.freeastrologyapi.com/western/aspects',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "tropical",
      "language": "en",
      "exclude_planets": [
        "Lilith",
        "Chiron",
        "Ceres",
        "Vesta",
        "Juno",
        "Pallas"
      ],
      "allowed_aspects": [
        "Conjunction",
        "Trine"
      ],
      "orb_values": {
        "Conjunction": 3,
        "Opposition": 5,
        "Square": 5,
        "Trine": 5,
        "Sextile": 5,
        "Semi-Sextile": 5,
        "Quintile": 5,
        "Septile": 5,
        "Octile": 5,
        "Novile": 5,
        "Quincunx": 5,
        "Sesquiquadrate": 5
      }
    }
  })

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


Response data


{
  "statusCode": 200,
  "output": [
    {
      "planet_1": {
        "en": "Moon"
      },
      "planet_2": {
        "en": "Mean Node"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Moon"
      },
      "planet_2": {
        "en": "True Node"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Mercury"
      },
      "planet_2": {
        "en": "Descendant"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Venus"
      },
      "planet_2": {
        "en": "Neptune"
      },
      "aspect": {
        "en": "Conjunction"
      }
    },
    {
      "planet_1": {
        "en": "Uranus"
      },
      "planet_2": {
        "en": "MC"
      },
      "aspect": {
        "en": "Conjunction"
      }
    },
    {
      "planet_1": {
        "en": "Pluto"
      },
      "planet_2": {
        "en": "IC"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Mean Node"
      },
      "planet_2": {
        "en": "True Node"
      },
      "aspect": {
        "en": "Conjunction"
      }
    }
  ]
}




{
  "statusCode": 200,
  "output": [
    {
      "planet_1": {
        "en": "Moon",
        "es": "Luna"
      },
      "planet_2": {
        "en": "Mean Node",
        "es": "Nodo Medio"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Moon",
        "es": "Luna"
      },
      "planet_2": {
        "en": "True Node",
        "es": "Nodo Verdadero"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Mercury",
        "es": "Mercurio"
      },
      "planet_2": {
        "en": "Descendant",
        "es": "Descendente"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Venus",
        "es": "Venus"
      },
      "planet_2": {
        "en": "Neptune",
        "es": "Neptuno"
      },
      "aspect": {
        "en": "Conjunction"
      }
    },
    {
      "planet_1": {
        "en": "Uranus",
        "es": "Urano"
      },
      "planet_2": {
        "en": "MC",
        "es": "Medio Cielo"
      },
      "aspect": {
        "en": "Conjunction"
      }
    },
    {
      "planet_1": {
        "en": "Pluto",
        "es": "Plutón"
      },
      "planet_2": {
        "en": "IC",
        "es": "Fondo del Cielo"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Mean Node",
        "es": "Nodo Medio"
      },
      "planet_2": {
        "en": "True Node",
        "es": "Nodo Verdadero"
      },
      "aspect": {
        "en": "Conjunction"
      }
    }
  ]
}



{
  "statusCode": 200,
  "output": [
    {
      "planet_1": {
        "en": "Moon",
        "fr": "Lune"
      },
      "planet_2": {
        "en": "Mean Node",
        "fr": "Nœud moyen"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Moon",
        "fr": "Lune"
      },
      "planet_2": {
        "en": "True Node",
        "fr": "Nœud vrai"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Mercury",
        "fr": "Mercure"
      },
      "planet_2": {
        "en": "Descendant",
        "fr": "Descendant"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Venus",
        "fr": "Vénus"
      },
      "planet_2": {
        "en": "Neptune",
        "fr": "Neptune"
      },
      "aspect": {
        "en": "Conjunction"
      }
    },
    {
      "planet_1": {
        "en": "Uranus",
        "fr": "Uranus"
      },
      "planet_2": {
        "en": "MC",
        "fr": "Milieu du Ciel"
      },
      "aspect": {
        "en": "Conjunction"
      }
    },
    {
      "planet_1": {
        "en": "Pluto",
        "fr": "Pluton"
      },
      "planet_2": {
        "en": "IC",
        "fr": "Imum Coeli"
      },
      "aspect": {
        "en": "Trine"
      }
    },
    {
      "planet_1": {
        "en": "Mean Node",
        "fr": "Nœud moyen"
      },
      "planet_2": {
        "en": "True Node",
        "fr": "Nœud vrai"
      },
      "aspect": {
        "en": "Conjunction"
      }
    }
  ]
}