API

Natal Horoscope

The Natal horoscope, also known as a birth horoscope, calculates a person's unique and personal astrological report based on birthdate, birthplace and birthtime. This is the most widely used horoscope.

Basic Flow

To generate a Natal Horoscope from the AstroAPI, the system (your implementation) makes a POST-request to the /api/natal endpoint with the necessary parameters. With correct parameters the AstroAPI will provide a full natal horoscope in JSON-format + the astrological wheel image url.

Asteroids

The AstroAPI can also calculate asteroids. The following asteroids are available:

  • Apollo (id: 11862)
  • Eros (id: 10433)
  • Pallas (id: 18)
  • Athene (id: 10881)
  • Ceres (id: 10001)
  • Juno (id: 10003)
  • Chariklo (id: 20199)

Add the ID to the planets array to calculate the asteroid.

Point IDs (planets array)

  • Vertex (id: 200003)
  • True Lilith (Black Moon) (id: 200013)

Generating a Natal Horoscope

POST /api/natal

Header Value
Accept-Encoding application/json
Content-Type application/json
Authorization Bearer [accessToken]


body

{
    "name": "Matthias",
    "date": "1984-03-27",
    "time": "13:13",
    "place_id": 1250015082,
    "lang": "en",
    "system": "p",
    "planets": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
    "collect_text": true
}


Params explanation

Header Value
name The name of the person or event you wish to create a natal horoscope for
date The (birth)date of the person or event in format YYYY-mm-dd
time The (birth)time of the person or event in format HH:mm
place_id The (birth)place of the person or event retrieved from the /api/places request
lang The language you wish to receive the astrological interpretation texts associated with the horoscope in. Default: 'nl'
system The House system: or "p" (Placidus), "k" (Koch), "x" (Meridian House system) or "W" (Whole Sign)
planets An array of planets that need calculation (Sun = 0, Moon = 1, Mercury = 2, Venus = 3, Mars = 4, Jupiter = 5, Saturn = 6, Uranus = 7, Neptune = 8, Pluto = 9, Chiron = 10, Lilith = 11, ...). Can include asteroids (Apollo (11862), Eros (10433), Pallas (18), Athene (10881), Chariklo (20199))
collect_text Set to true if you want to retrieve the texts, false if you only want calculation

Response

Example response for Lady Gaga


Full JSON-response Page Full JSON-response File


JSON-object Astrological naming Explanation Custom Text
profile Information about the person/event this astrological profile is about. Info about converted Birthdata to UTC, latitude/longitude, timezone -
intro Text as intro with general info about the natal horoscope. Yes
planets Planets in Signs Influence of the planets on the person/event. Calculation for each planet. *e.g. Jupiter in Aries in House 4 Yes
elements Basic Elements Strength of the different planets on the horoscope. Yes
zodiacpoints Zodiac Elements Strength Strength of the zodiac signs in the horoscope. e.g. Taurus: strength 5 Yes (for strength > 4)
housecusps House Cusps The signs on the different house cusps of the astrological chart Yes
aspects Aspects The interplanetary relations in degrees that form bonds. *e.g. 180° = Opposite aspect Yes
wheel Astrological Wheel URL to the generated Astrological wheel based on the horoscope calculation. -


Astrological wheel

...
"wheel": "/img/example_wheel.png"
}

image