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":[]}'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.
| Field | Type | Required | Notes |
|---|---|---|---|
| bhava_arudhas | array | optional | ARRAY OF OBJECTS: {"arudha": <one of A1..A12>, "sign": <string>}. |
| birth_date_from | string (date) | optional | FORMAT constraint: ISO-8601 'YYYY-MM-DD' (DRF default input formats). |
| birth_date_to | string (date) | optional | FORMAT constraint: ISO-8601 'YYYY-MM-DD' (DRF default input formats). |
| birth_month_day | string | optional | MM-DD e.g. 06-08 FORMAT constraint: 'MM-DD', e.g. '06-08'. |
| categories | array | optional | |
| chart | string | optional | RashiChartHoraChartDrekkanaChartChaturthamsaChartNavamsaChartDasamsaChartOnly these six divisional charts are available for celebrity records. Defaults to RashiChart. Case-sensitive. |
| combust_planets | array | optional | MarsMercuryVenusJupiterSaturnArray of strings. Deliberately narrower than VALID_PLANETS - only these five are tracked in the combust_planets data. |
| conjunct | array | optional | 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). |
| countries | array | optional | |
| data_source | array | optional | |
| gender | string | optional | malefemalen/a |
| graha_aspects | array | optional | 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_search | string | optional | 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_with | array | optional | 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. |
| nodes | string | optional | truemeanDefault 'true'. Selects true vs mean lunar nodes for every Rahu/Ketu-based filter. |
| order_by | string | optional | name_asc = A→Z, name_desc = Z→A, birth_date_asc/desc = oldest/newest first name_ascname_descbirth_date_ascbirth_date_desc |
| page | integer | optional | min 1 |
| page_size | integer | optional | min 1 · max 100 |
| planets_in_houses | array | optional | ARRAY OF OBJECTS: {"planet": <one of Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu, Uranus, Neptune, Pluto>, "house": <int 1-12>}. |
| planets_in_nakshatras | array | optional | 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_signs | array | optional | ARRAY OF OBJECTS: {"planet": <VALID_PLANETS>, "sign": <string>}. |
| rashi_aspects | array | optional | ARRAY OF OBJECTS: same shape and same HORA_PLANETS value set as graha_aspects. |
| retrograde_planets | array | optional | SunMoonMarsMercuryJupiterVenusSaturnRahuKetuArray of strings. Rahu/Ketu are resolved to the stored 'True Node'/'Mean Node' keys according to `nodes` and:101-107). |
| rodden_rating | array | optional |