POST/api/astro/fixed-star/catalog/1 credit

Fixed star catalogue

Search the Swiss Ephemeris fixed star catalogue by name, designation or brightness. 1357 rows covering 532 distinct stars — the remainder are alias names, folded into the star they belong to. That matters here: Aldebaran is also Rohini and Sirius is also Lubdhaka, so the Vedic names are searchable, and a naive listing would return Sirius three times. This is the index you need before asking for anything else, because star names are not guessable. It takes no date and returns no positions — a position needs a date, so use /positions/ for that.

https://yogataraapi.prahlad.app/api/astro/fixed-star/catalog/

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

Field	Type	Required	Notes
limit	integer	optional	min 1 · max 500
max_magnitude	number (double)	optional
preset	string	optional	`majorbehenianbrightestall`
search	string	optional	Match a name or Bayer designation.

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/fixed-star/catalog/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"aldebaran","preset":"all","limit":25}'

Response

{
  "data": {
    "distinct_stars": 532,
    "matched": 1,
    "returned": 1,
    "stars": [
      {
        "star": "Aldebaran",
        "designation": "alTau",
        "magnitude": 0.86,
        "aliases": [
          "Rohini"
        ]
      }
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.