POST
Houses - Western Astrology
Calculate the 12 astrological house cusps for a given date, time, and geographical location using Western astrology. Retrieve each house's zodiac sign, absolute longitude, and degree within its sign, with support for multiple house systems such as Placidus, Koch, and Whole Sign.
/western/houses
Method
POST
Format
JSON
Auth
API Key
Credits
1
Overview
The Western Astrology Houses API calculates the positions of all 12 astrological house cusps for a specified date, time, and geographical location. Each house entry includes its house number, absolute zodiac longitude, degree within the zodiac sign, and corresponding zodiac sign number and name.
House cusps define the boundaries of the 12 houses used in a Western natal chart. This information helps developers display house positions, build natal chart wheels, and support astrological interpretations involving areas such as identity, finances, communication, relationships, career, and personal development.
To calculate house positions, provide the year, month, date, hours, minutes, seconds, latitude, longitude, and timezone. The optional configuration lets you choose a house system, including Placidus, Koch, Whole Signs, Porphyry, Regiomontanus, or Vehlow, along with supported zodiac calculation settings, observation points, and response languages. The API returns structured JSON data for integration into websites, mobile applications, and Western astrology software.
Request Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
year
|
integer | Yes | Year number, eg: 2023 | 2023 |
month
|
integer | Yes | Month number,with no leading zero | 7 |
date
|
integer | Yes | Day number,with no leading zero | 5 |
hours
|
integer | Yes | Hours number,with no leading zero | 1 |
minutes
|
integer | Yes | Minutes number,with no leading zero | 1 |
seconds
|
integer | Yes | Seconds number, with no leading zero | 0 |
latitude
|
float | Yes | Latitude number, in the range from -90 to 90 | 12.86 |
longitude
|
float | Yes | Longitude number, in the range from -180 to 180 | 123.5 |
timezone
|
float | Yes | Timezone of birth location, eg: 5.5 | 5.5 |
config
|
object | No | Contains optional configuration values | |
ayanamsha
|
string | No | Either "tropical" or "sayana" or "lahiri" | Either "tropical" or "sayana" or "lahiri" |
language
|
string | No | Valid 2 letter ISO 639-1 language code | Either "en" For English or "es" for Spanish or "fr" for French or "pt" for Portuguese or "ru" for Russian or "de" for German or "ja" for Japanese or "pl" for Polish or "tr" for Turkish |
observation_point
|
string | No | Geocentric positions are calculated with respect to the center of Earth. Topocentric positions are calculated with respect to the actual given place | Either "topocentric" or "geocentric" |
house_system
|
string | No | House System to be used | either "Porphyry" or "Placidus" or "Koch" or "Whole Signs" or "Regiomontanus" or "Vehlow" |
Supported Languages
This API endpoint supports the following languages.
Use the corresponding 2-letter language code
in the language parameter when making your request.
| Language | Code |
|---|---|
| English |
en
|
| Spanish |
es
|
| French |
fr
|
| Portuguese |
pt
|
| Russian |
ru
|
| German |
de
|
| Japanese |
ja
|
| Polish |
pl
|
| Turkish |
tr
|
Example
To request the response in Telugu, use
te as the language code:
{
"language": "te"
}Request Example
{
"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 */
"house_system": "Placidus", /* "Placidus","Koch","Whole Signs","Equal Houses","Regiomontanus","Vehlow" */
"language": "en" /* en , te , es , fr , pt , ru , de , ja */
}
}
Response Examples
Example responses returned by this API.
English Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus"
}
}
}
]
}
}
Spanish Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"es": "Géminis"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"es": "Cáncer"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"es": "Cáncer"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"es": "Leo"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"es": "Virgo"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"es": "Escorpio"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"es": "Sagitario"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"es": "Capricornio"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"es": "Capricornio"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"es": "Acuario"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"es": "Piscis"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"es": "Tauro"
}
}
}
]
}
}
French Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"fr": "Gémeaux"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"fr": "Cancer"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"fr": "Cancer"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"fr": "Lion"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"fr": "Vierge"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"fr": "Scorpion"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"fr": "Sagittaire"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"fr": "Capricorne"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"fr": "Capricorne"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"fr": "Verseau"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"fr": "Poissons"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"fr": "Taureau"
}
}
}
]
}
}
Portuguese Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"pt": "Gêmeos"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"pt": "Câncer"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"pt": "Câncer"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"pt": "Leão"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"pt": "Virgem"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"pt": "Escorpião"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"pt": "Sagitário"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"pt": "Capricórnio"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"pt": "Capricórnio"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"pt": "Aquário"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"pt": "Peixes"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"pt": "Touro"
}
}
}
]
}
}
Russian Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"ru": "Близнецы"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"ru": "Рак"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"ru": "Рак"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"ru": "Лев"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"ru": "Дева"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"ru": "Скорпион"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"ru": "Стрелец"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"ru": "Козерог"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"ru": "Козерог"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"ru": "Водолей"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"ru": "Рыбы"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"ru": "Телец"
}
}
}
]
}
}
German Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"de": "Zwillinge"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"de": "Krebs"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"de": "Krebs"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"de": "Löwe"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"de": "Jungfrau"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"de": "Skorpion"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"de": "Schütze"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"de": "Steinbock"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"de": "Steinbock"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"de": "Wassermann"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"de": "Fische"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"de": "Stier"
}
}
}
]
}
}
Japanese Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"ja": "ふたご座"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"ja": "かに座"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"ja": "かに座"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"ja": "しし座"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"ja": "おとめ座"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"ja": "さそり座"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"ja": "いて座"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"ja": "やぎ座"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"ja": "やぎ座"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"ja": "みずがめ座"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"ja": "うお座"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"ja": "おうし座"
}
}
}
]
}
}
Polish Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"pl": "Bliźnięta"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"pl": "Rak"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"pl": "Rak"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"pl": "Lew"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"pl": "Panna"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"pl": "Skorpion"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"pl": "Strzelec"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"pl": "Koziorożec"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"pl": "Koziorożec"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"pl": "Wodnik"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"pl": "Ryby"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"pl": "Byk"
}
}
}
]
}
}
Turkish Response
{
"statusCode": 200,
"output": {
"Houses": [
{
"House": 1,
"degree": 67.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 3,
"name": {
"en": "Gemini",
"tr": "İkizler"
}
}
},
{
"House": 2,
"degree": 93.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"tr": "Yengeç"
}
}
},
{
"House": 3,
"degree": 118.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 4,
"name": {
"en": "Cancer",
"tr": "Yengeç"
}
}
},
{
"House": 4,
"degree": 146.28412022526288,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 5,
"name": {
"en": "Leo",
"tr": "Aslan"
}
}
},
{
"House": 5,
"degree": 178.35773702333336,
"normDegree": 28.357737023333357,
"zodiac_sign": {
"number": 6,
"name": {
"en": "Virgo",
"tr": "Başak"
}
}
},
{
"House": 6,
"degree": 213.3868670415725,
"normDegree": 3.3868670415724864,
"zodiac_sign": {
"number": 8,
"name": {
"en": "Scorpio",
"tr": "Akrep"
}
}
},
{
"House": 7,
"degree": 247.08167055995895,
"normDegree": 7.081670559958951,
"zodiac_sign": {
"number": 9,
"name": {
"en": "Sagittarius",
"tr": "Yay"
}
}
},
{
"House": 8,
"degree": 273.22391017921376,
"normDegree": 3.2239101792137603,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"tr": "Oğlak"
}
}
},
{
"House": 9,
"degree": 298.53918498544635,
"normDegree": 28.539184985446354,
"zodiac_sign": {
"number": 10,
"name": {
"en": "Capricorn",
"tr": "Oğlak"
}
}
},
{
"House": 10,
"degree": 326.2841202252629,
"normDegree": 26.284120225262882,
"zodiac_sign": {
"number": 11,
"name": {
"en": "Aquarius",
"tr": "Kova"
}
}
},
{
"House": 11,
"degree": 358.3577370233334,
"normDegree": 28.357737023333414,
"zodiac_sign": {
"number": 12,
"name": {
"en": "Pisces",
"tr": "Balık"
}
}
},
{
"House": 12,
"degree": 33.3868670415725,
"normDegree": 3.3868670415725006,
"zodiac_sign": {
"number": 2,
"name": {
"en": "Taurus",
"tr": "Boğa"
}
}
}
]
}
}Code Examples
Use the following examples to integrate this API into your application.
PHP Code
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://json.freeastrologyapi.com/western/houses',
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": 1984,
"month": 4,
"date": 3,
"hours": 9,
"minutes": 15,
"seconds": 0,
"latitude": 16.50745,
"longitude": 80.6466,
"timezone": 5.5,
"config": {
"observation_point": "topocentric",
"ayanamsha": "tropical",
"house_system": "Placidus",
"language": "en"
}
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'x-api-key: YOUR_API_KEY_HERE'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Python Code
import requests
import json
url = "https://json.freeastrologyapi.com/western/houses"
payload = json.dumps({
"year": 1984,
"month": 4,
"date": 3,
"hours": 9,
"minutes": 15,
"seconds": 0,
"latitude": 16.50745,
"longitude": 80.6466,
"timezone": 5.5,
"config": {
"observation_point": "topocentric",
"ayanamsha": "tropical",
"house_system": "Placidus",
"language": "en"
}
})
headers = {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY_HERE'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Node JS Code
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://json.freeastrologyapi.com/western/houses',
'headers': {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY_HERE'
},
body: JSON.stringify({
"year": 1984,
"month": 4,
"date": 3,
"hours": 9,
"minutes": 15,
"seconds": 0,
"latitude": 16.50745,
"longitude": 80.6466,
"timezone": 5.5,
"config": {
"observation_point": "topocentric",
"ayanamsha": "tropical",
"house_system": "Placidus",
"language": "en"
}
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});