Natal Chart Astrodatabank#

These endpoints are designed to provide quick access to the astrodatanak's database and retrieve birth data from there.

  • /api/astrodatabank/names/ - Get a list of persons whose surname starts with the given letters.
  • /api/astrodatabank/person/ - Retrieve the birthdate of a person based on the titles selected in the API above.

Get List of Persons#

/api/astrodatabank/names/

Use this endpoint to retrieve the titles (name and surname) of famous persons from astrodatabank. The access level for this endpoint is m1 (see access levels).

Request#

  • Method: POST
  • The only parameter is starts_with - the first 3+ letters of the surname of the person in the query.

Response#

It returns a list of titles and URLs of the pages in astrowiki.

"response": [
    {
        "titles": "Morini-Bosc, Isabelle",
        "url": "https://www.astro.com/astro-databank/Morini-Bosc,_Isabelle"
    },
    {
        "titles": "Morin, Christian",
        "url": "https://www.astro.com/astro-databank/Morin,_Christian"
    },
    {
        "titles": "Morin, Hervé",
        "url": "https://www.astro.com/astro-databank/Morin,_Herv%C3%A9"
    },
    // ... etc
]

Collect Birthdate Data#

/api/astrodatabank/person/

Once you have selected a title from the list above, send this title to this endpoint. You will receive birthdate data and some additional information about the chosen person.

Request#

  • Method: POST
  • The only parameter is titles - the titles from the previous list, f.e. 'Blake, Robert'

Response#

"parsed": { // You can send this data to the /api/astro/natal/ endpoint
    "name": "Robert Blake",
    "accuracy": "AA",
    "year": 1933,
    "month": 9,
    "day": 18,
    "hour": 8,
    "minute": 30,
    "tz": -4.0,
    "ln_d": 74,
    "ln_m": 10,
    "dir_ln": "w",
    "lt_d": 40,
    "lt_m": 49,
    "dir_lt": "n"
},
// Here is the original data returned by astrowiki. You may pick up some additional info from here.
"original": { 
    "DatamainID": "25670",
    "Name": "Blake, Robert",
    "sflname": "Robert Blake",
    "sbdate": "1933/09/18",
    "sbdate_dmy": "18 September 1933",
    "sbtime": "08:30",
    // ... etc
}