Tarot card texts (public, no key)

GET

/public/tarot/texts

Code sample: cURL

request.sh

curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=en'

▸ Спробувати GET /public/tarot/texts

• Production

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.

Parameters

Query Parameters

cards

string

Example

the-fool,9-of-swords

lang

string

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.

fields

string

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.

Example

planets.name,planets.longitude

precision

integer

<= 15

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.

Example

4

Header Parameters

Accept-Language

string

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.

Responses

200

OK

Media type application/json

object

ok

boolean

data

object

lang

string

nullable

textLocalized

boolean

nullable

cards

object

9-of-swords

object

name

string

nullable

keywords

object

upright

Array<string>

nullable

reversed

Array<string>

nullable

description

string

nullable

upright

object

love

string

nullable

career

string

nullable

finance

string

nullable

health

string

nullable

spirit

string

nullable

reversed

object

love

string

nullable

career

string

nullable

finance

string

nullable

health

string

nullable

spirit

string

nullable

_footer

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

string

Example

{
  "ok": true,
  "data": {
    "lang": "en",
    "textLocalized": true,
    "cards": {
      "9-of-swords": {
        "name": "Nine of Swords",
        "keywords": {
          "upright": [
            "anxiety",
            "nightmare",
            "mental anguish"
          ],
          "reversed": [
            "hopelessness",
            "mental health crisis"
          ]
        },
        "description": "A woman sits up in bed in the dark, her face buried in her hands. Nine swords hang in horizontal rows on the black wall behind her. Her quilt is patterned with roses and astrological signs, and the bed is carved with a scene of combat. The danger is not in the room; it is in her thoughts.\n\nUpright, this is the card of worry and sleepless nights, when anxious thoughts run ahead of the facts. Linked to Mars in Gemini, it shows the mind turning on itself. Ask what is actually happening, as opposed to what you fear might happen.\n\nReversed, the weight of worry can feel heavier and more isolating. This is the moment to reach out rather than carry it alone: talk to a friend, a family member or a qualified professional. Support makes the night shorter.",
        "upright": {
          "love": "Worry about the relationship may be bigger than the problem itself. Share your fears calmly with your partner rather than replaying them alone at night.",
          "career": "Anxiety about work keeps you awake or distracted. Write down the specific concern, separate facts from fears, and choose one action you can take tomorrow.",
          "finance": "Money worries can loop endlessly. Look at the actual figures in daylight, make one small plan, and talk to someone with practical experience if you need guidance.",
          "health": "Stress may be disturbing your sleep. Build a calm evening routine, limit late-night screens, and talk with someone you trust about what is weighing on you.",
          "spirit": "The mind's darkest stories are not the whole truth. Gentle practices such as slow breathing or prayer can steady you while the night passes."
        },
        "reversed": {
          "love": "Do not carry relationship worries in silence. Reach out to a friend or a counsellor, and let the people close to you know you need support.",
          "career": "Pressure at work may feel overwhelming. Tell a manager or colleague what is happening, ask for help, and remember that your wellbeing comes before any deadline.",
          "finance": "Financial stress feels heavy. Contact a trusted adviser or support service, and share the load with someone instead of facing the numbers alone.",
          "health": "When worry feels too heavy, reach for support from people you trust or a qualified professional. You do not have to manage this by yourself.",
          "spirit": "Even the longest night ends. Let others hold a light for you now; accepting help is a strength, not a failure."
        }
      }
    }
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Invalid sign or date

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_SIGN",
    "message": "sign must be one of the 12 zodiac signs"
  }
}