Planet of the Day (public, no key)

GET

/public/planet-of-day

Code sample: cURL

request.sh

curl 'https://api.astroway.info/v1/public/planet-of-day'

▸ Спробувати GET /public/planet-of-day

• Production

Traditional (Chaldean) planetary ruler of the weekday: Sun=Sunday, Moon=Monday, …, Saturn=Saturday. Deterministic, no AI. _footer watermark. localized carries planet and weekday in the requested language; themes is an open set and stays English.

Parameters

Query Parameters

date

string format: date

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

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

date

string

nullable

weekday

string

nullable

planet

string

nullable

glyph

string

nullable

themes

Array<string>

nullable

localized

object

planet

string

nullable

weekday

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": {
    "date": "2026-08-21",
    "weekday": "Friday",
    "planet": "Venus",
    "glyph": "♀",
    "themes": [
      "love",
      "beauty",
      "harmony",
      "money"
    ],
    "localized": {
      "planet": "Венера",
      "weekday": "П’ятниця"
    }
  },
  "_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"
  }
}