Public

Tarot reading of the day (public, no key)

Changed on

The Rider-Waite-Smith three-card spread of the day (the same cards for every caller on a date) read as a whole, in the requested language: each position in context, synthesis and advice. The same answer shape as POST /interpret/tarot, plus back (the card back). In a language other than English each position carries positionMeaningLocalized and each card suitLocalized and meaningLocalized (keywords and meaning of the side drawn); the long card texts are GET /public/tarot/texts by slug. Generated once per date and language and cached for a day, Cache-Control: public, max-age=3600.

get/public/tarot/daily-reading

Request

  • Base URL: https://api.astroway.info/v1
  • URL: https://api.astroway.info/v1/public/tarot/daily-reading
  • Auth: none required

Query parameters

datestring date

Calendar date YYYY-MM-DD (UTC). Defaults to today.

langstring
Example:en

Language for this call, overriding Accept-Language. The canonical per-call form: a page that renders in one language passes it here rather than reconfiguring its client. Unknown or inactive codes fall back to uk.

fieldsstring

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

precisioninteger

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Headers

Accept-Languagestring

BCP-47 language (e.g. uk, en, de). Set it once on your HTTP client as its default; for a single call, ?lang= overrides it. Unknown or inactive codes fall back to uk.

Response

OK

okboolean
_footerstring

Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

Example response

{
  "ok": true,
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Changes