Skip to content
POST/api/astrodatabank/celebrities/1 credit

Celebrity chart search

A searchable database of birth charts for public figures and dated historical events, with each record already reduced to divisional charts, house positions, aspects and arudhas so you can query by chart feature rather than by date. It is the tool for research questions such as which charts have Saturn in the tenth house, or which astrologers were born with Mars and Mercury conjunct. Every filter is optional and they combine with AND. Biographical filters cover `name_search` (each word must appear, so 'Amitabh Bachchan' matches a record stored as 'Bachchan, Amitabh'), `name_starts_with`, `birth_date_from`/`birth_date_to`, `birth_month_day` as 'MM-DD', `gender`, `countries`, `categories` (a substring match against the AstroDatabank category strings such as 'Vocation: Sports: Football') and `rodden_rating` — the standard scale for how well a birth time is sourced, from AA for a birth certificate down to DD for conflicting or unverified data. Chart filters cover `planets_in_houses`, `planets_in_signs`, `planets_in_nakshatras`, `conjunct` (two planets in the same house), `graha_aspects` and `rashi_aspects` (planet-to-planet, one aspecting the other), `bhava_arudhas`, `combust_planets` and `retrograde_planets`. `chart` selects which divisional chart the position filters apply to — RashiChart by default, or Hora, Drekkana, Chaturthamsa, Navamsa or Dasamsa — and `nodes` chooses true or mean nodes for any Rahu or Ketu condition. Results are paginated: `page` from 1 and `page_size` from 1 to 100, defaulting to 20, ordered by `order_by` (`birth_date_asc` by default, or name ascending or descending, which sorts on the given name rather than the stored 'Last, First' form). The response is `{results, total, page, page_size, total_pages}`; each result carries id, display name, gender, birth date and time, city, country, latitude, longitude, Rodden rating, data source, category list, image URL, the Rashi ascendant and the localised birth datetime. Take the `id` to the detail endpoint for the full chart data.

https://yogataraapi.prahlad.app/api/astrodatabank/celebrities/
Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

FieldTypeRequiredNotes
bhava_arudhasarrayoptional

ARRAY OF OBJECTS: {"arudha": <one of A1..A12>, "sign": <string>}.

birth_date_fromstring (date)optional

FORMAT constraint: ISO-8601 'YYYY-MM-DD' (DRF default input formats).

birth_date_tostring (date)optional

FORMAT constraint: ISO-8601 'YYYY-MM-DD' (DRF default input formats).

birth_month_daystringoptional

MM-DD e.g. 06-08

FORMAT constraint: 'MM-DD', e.g. '06-08'.

categoriesarrayoptional
chartstringoptional
RashiChartHoraChartDrekkanaChartChaturthamsaChartNavamsaChartDasamsaChart

Only these six divisional charts are available for celebrity records. Defaults to RashiChart. Case-sensitive.

combust_planetsarrayoptional
MarsMercuryVenusJupiterSaturn

Array of strings. Deliberately narrower than VALID_PLANETS - only these five are tracked in the combust_planets data.

conjunctarrayoptional

ARRAY OF OBJECTS: {"planet_a": X, "planet_b": Y}, both from the 12 VALID_PLANETS (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu, Uranus, Neptune, Pluto).

countriesarrayoptional
data_sourcearrayoptional
genderstringoptional
malefemalen/a
graha_aspectsarrayoptional

ARRAY OF OBJECTS: {"from_planet": X, "to_planet": Y}, both from HORA_PLANETS = Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Uranus/Neptune/Pluto are NOT allowed here.

name_searchstringoptional

Full or partial name search. Works with 'First Last' or 'Last First' order.

FREE-FORM. Split on whitespace and each word AND-ed as a case-insensitive `contains`, so 'Amitabh Bachchan' matches the stored 'Bachchan, Amitabh'.

name_starts_witharrayoptional

FREE-FORM array of strings, normally single letters. OR-ed; matches either the start of the stored 'Last, First' name or the first name following ', '. Case-insensitive.

nodesstringoptional
truemean

Default 'true'. Selects true vs mean lunar nodes for every Rahu/Ketu-based filter.

order_bystringoptional

name_asc = A→Z, name_desc = Z→A, birth_date_asc/desc = oldest/newest first

name_ascname_descbirth_date_ascbirth_date_desc
pageintegeroptional

min 1

page_sizeintegeroptional

min 1 · max 100

planets_in_housesarrayoptional

ARRAY OF OBJECTS: {"planet": <one of Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu, Uranus, Neptune, Pluto>, "house": <int 1-12>}.

planets_in_nakshatrasarrayoptional

ARRAY OF OBJECTS: {"planet": <VALID_PLANETS>, "nakshatra": <string>}. one of: Ashwini, Bharani, Krittika, Rohini, Mrigasira, Aardra, Punarvasu, Pushyami, Aasresha, Makha, Poorva Phalguni, Uttara Phalguni, Hasta, Chitra, Swaati, Visaakha, Anooraadha, Jyeshtha, Moola, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra, Revati. Case- and spelling-sensitive.

planets_in_signsarrayoptional

ARRAY OF OBJECTS: {"planet": <VALID_PLANETS>, "sign": <string>}.

rashi_aspectsarrayoptional

ARRAY OF OBJECTS: same shape and same HORA_PLANETS value set as graha_aspects.

retrograde_planetsarrayoptional
SunMoonMarsMercuryJupiterVenusSaturnRahuKetu

Array of strings. Rahu/Ketu are resolved to the stored 'True Node'/'Mean Node' keys according to `nodes` and:101-107).

rodden_ratingarrayoptional

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astrodatabank/celebrities/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart":"RashiChart","combust_planets":[],"gender":"male","nodes":"true","order_by":"name_asc","retrograde_planets":[]}'

Response

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"results\": [{\"id\": 65055, \"idx\": 65088, \"name\": \"\\\"Akron\\\" Frey\", \"gender\": \"male\", \"birth_date\": \"1948-05-01\", \"birth_time\": \"21:07\", \"city\": \"Münsterlingen\", \"country\": \"Switzerland\", \"latitude\": 47.633333, \"longitude\": 9.233333, \"rodden_rating\": \"A\", \"data_source\": \"From memory\", \"categories\": [\"Vocation: Occult Fields: Astrologer (Pro)\", \"Vocation: Occult Fields: Parapsychology\", \"Vocation: Writers: Astrology\"], \"image_url\": null, \"ascendant\": {\"pada\": 1, \"longitude\": 216.1815167580023, \"nakshatra\": \"Anooraadha\", \"zodiac_name\": \"Scorpio\"}, \"computed_datetime\": {\"timezone_as_float\": 1.0, \"localized_datetime\": \"1948-05-01T21:07:00+01:00\"}}, {\"id\": 72901, \"idx\": 72934, \"name\": \"\\\"Crazylegs\\\" Hirsch\", \"gender\": \"male\", \"birth_date\": \"1923-06-17\", \"birth_time\": \"22:45\", \"city\": \"Wauwatosa\", \"country\": \"Wisconsin\", \"latitude\": 43.05, \"longitude\": -88.0, \"rodden_rating\": \"AA\", \"data_source\": \"Quoted BC/BR\", \"categories\": [\"Traits: Body: Size (Height: 6 ft 2 in/ 1.88 m)\", \"Traits: Body: Weight (190 lb/ 86 kg)\", \"Traits: Personality: Courageous (Football after doctors said impossible)\", \"Diagnoses: Body Part Problems: Accident/Injury (Car accident, loss of body control)\", \"Lifestyle: Work: Same Job more than 10 yrs (20 years as pro player)\", \"Lifestyle: Work: Work in team/ Tandem (Football teams)\", \"Personal: Death: Long life  more than 80 yrs\", \"Vocation: Sports: Football (Pro, receiver)\", \"Vocation: Sports Business: Coach/ Manager/ Owner (Athletic director with university)\", \"Notable: Awards: Vocational award (Several football records)\", \"Notable: Famous: Founder/ originator (Games first flanker, revolutionary)\", \"Notable: Famous: Top 5% of Profession\"], \"image_url\": null, \"ascendant\": {\"pada\": 4, \"longitude\": 278.94668597910663, \"nakshatra\": \"Uttaraashaadha\", \"zodiac_name\": \"Capricorn\"}, \"computed_datetime\": {\"timezone_as_float\": -5.0, \"localized_datetime\": \"1923-06-17T22:45:00-05:00\"}}, {\"id\": 63457, \"idx\": 63492, \"name\": \"\\\"Fatty\\\" Arbuckle\", \"gender\": \"male\", \"birth_date\": \"1887-03-24\", \"birth_time\": \"12:00\", \"city\": \"Smith Center\", \"country\": \"Kansas\", \"latitude\": 39.783333, \"longitude\": -98.783333, \"rodden_rating\": \"DD\", \"data_source\": \"Conflicting/unverified\", \"categories\": [\"Traits: Body: Weight (Obese)\", \"Diagnoses: Body Part Problems: Heart (Terminal attack)\", \"Lifestyle: Financial: Gain - Financial success in field (Largest contract for that time period)\", \"Passions: Criminal Perpetrator: Homicide involvement (Death of actress at his party)\", \"Vocation: Entertainment: Comedy\", \"Vocation: Politics: Government employee (Representative and ministerial positions)\", \"Notable: Book Collection: American Book\"], \"image_url\": null, \"ascendant\": {\"pada\": 1, \"longitude\": 80.28605482949072, \"nakshatra\": \"Punarvasu\", \"zodiac_name\": \"Gemini\"}, \"computed_datetime\": {\"timezone_as_float\": -6.0, \"localized_datetime\": \"1887-03-24T12:00:00-06:00\"}}, {\"id\": 28322, \"idx\": 28331, \"name\": \"\\\"Playboy\\\" Buddy Rose\", \"gender\": \"male\", \"birth_date\": \"1952-11-27\", \"birth_time\": \"21:06\", \"city\": \"Omaha\", \"country\": \"Nebraska\", \"latitude\": 41.266667, \"longitude\": -95.933333, \"rodden_rating\": \"A\", \"data_source\": \"From memory\", \"categories\": [\"Lifestyle: Financial: Gain - Financial success in field\", \"Vocation: Sports: Wrestling\"], \"image_url\": null, \"ascendant\": {\"pada\": 3, \"longitude\": 100.06064481940373, \"nakshatra\": \"Pushyami\", \"zodiac_name\": \"Cancer\"}, \"computed_datetime\": {\"timezone_as_float\": -6.0, \"localized_datetime\": \"1952-11-27T21:06:00-06:00\"}}, {\"id\": 2385, \"idx\": 2355, \"name\": \"10th Prince of Thurn and Taxis Karl August\", \"gender\": \"male\", \"birth_date\": \"1898-07-23\", \"birth_time\": \"15:00\", \"city\": \"Feldafing\", \"country\": \"Germany\", \"latitude\": 47.95, \"longitude\": 11.283333, \"rodden_rating\": \"C\", \"data_source\": \"Accuracy in question\", \"categories\": [\"Family: Parenting: Kids more than 3 (Four)\", \"Personal: Death: Long life  more than 80 yrs (Age 83)\", \"Notable: Famous: Royal family (House of Thurn and Taxis)\"], \"image_url\": null,"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.