astro_search_charts

Celebrity chart database lookup + filter search (Astrodatabank-grade).

Layer: search
Methods: lookup, search, pattern
Free tier: —
Paid tier: lookup, search, pattern

Description

Celebrity chart database lookup + filter search (Astrodatabank-grade).

Methods:
  lookup  [Paid] — Look up a chart by name (case-insensitive substring) in the seed dataset.
  search  [Paid] — Filter the seed dataset by category, nationality, rodden rating, or birth-date range.
  pattern [Paid] — Match charts against a pattern (planet-in-sign, planets-in-same-sign, sun-moon-angle).

Input schema

lookup

Field	Type	Required	Constraints
name	string	yes	minLength 1

Example request

{
  "method": "lookup",
  "name": "Einstein"
}

Example response (captured; long values elided)

[
  {
    "slug": "albert-einstein",
    "name": "Albert Einstein",
    "category": "scientist",
    "nationality": "German",
    "roddenRating": "AA",
    "birth": {
      "year": 1879,
      "month": 3,
      "day": 14,
      "hour": 11,
      "minute": 30,
      "latitude": 48.4011,
      "longitude": 9.9876,
      "timezone": 0.6532
    },
    "note": "Seed demo entry — approximate historical data"
  }
]

search

Field	Type	Required	Constraints
category	"scientist" \| "artist" \| "musician" \| "politician" \| "athlete" \| "writer"	no	—
nationality	string	no	—
roddenRatings	array<"AA" \| "A" \| "B" \| "C" \| "DD" \| "X">	no	—
bornAfter.year	integer	yes	int
bornAfter.month	integer	yes	min 1, max 12, int
bornAfter.day	integer	yes	min 1, max 31, int
bornBefore.year	integer	yes	int
bornBefore.month	integer	yes	min 1, max 12, int
bornBefore.day	integer	yes	min 1, max 31, int

Example request

{
  "method": "search",
  "category": "scientist"
}

Example response (captured; long values elided)

[
  {
    "slug": "ada-lovelace",
    "name": "Ada Lovelace",
    "category": "scientist",
    "nationality": "British",
    "roddenRating": "C",
    "birth": {
      "year": 1815,
      "month": 12,
      "day": 10,
      "hour": 12,
      "minute": 0,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    },
    "note": "Seed demo entry — approximate historical data"
  },
  {
    "slug": "albert-einstein",
    "name": "Albert Einstein",
    "category": "scientist",
    "nationality": "German",
    "roddenRating": "AA",
    "birth": {
      "year": 1879,
      "month": 3,
      "day": 14,
      "hour": 11,
      "minute": 30,
      "latitude": 48.4011,
      "longitude": 9.9876,
      "timezone": 0.6532
    },
    "note": "Seed demo entry — approximate historical data"
  },
  {
    "slug": "marie-curie",
    "name": "Marie Curie",
    "category": "scientist",
    "nationality": "Polish",
    "roddenRating": "DD",
    "birth": {
      "year": 1867,
      "month": 11,
      "day": 7,
      "hour": 12,
      "minute": 0,
      "latitude": 52.2297,
      "longitude": 21.0122,
      "timezone": 1.4008
    },
    "note": "Seed demo entry — approximate historical data"
  }
]

pattern

Field	Type	Required	Constraints
pattern	any \| object	yes	—

Example request

{
  "method": "pattern",
  "pattern": {
    "kind": "planet-in-sign",
    "planet": "Sun",
    "sign": "Pisces"
  }
}

Example response (captured; long values elided)

[
  {
    "slug": "albert-einstein",
    "name": "Albert Einstein",
    "matched": {
      "kind": "planet-in-sign",
      "planet": "Sun",
      "sign": "Pisces"
    }
  }
]