Public

Tarot card texts (public, no key)

Changed on

Long-form readings for the 78 Rider-Waite-Smith cards: a three-paragraph description (the imagery, the upright meaning, the reversed meaning), and for upright and reversed one text each on love, career, finance, health and spirit, plus name and up to five keywords per side. cards is a comma-separated list of slugs (as in GET /public/tarot/decks); omit it for all 78; an unknown slug is a 400 INVALID_CARD. Our own prose. A language without its table yet answers English text with textLocalized: false; names and keywords are localised either way. Static data, Cache-Control: public, max-age=604800.

get/public/tarot/texts

Request

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

Query parameters

cardsstring
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