Daily Horoscope (public, no key)

GET

/public/horoscope/daily

Code sample: cURL

request.sh

curl 'https://api.astroway.info/v1/public/horoscope/daily?sign=aries'

▸ Спробувати GET /public/horoscope/daily

• Production

Sun-sign daily horoscope. No authentication, IP-rate-limited (30/hr). Cached per (sign, date, language); every response carries the _footer watermark. The horoscope field is paragraphs separated by a blank line and may contain **bold** and hyphen bullets; it never contains a heading, because the caller renders its own.

Parameters

Query Parameters

sign required

string

Allowed values: aries taurus gemini cancer leo virgo libra scorpio sagittarius capricorn aquarius pisces

Zodiac sun sign.

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

sign

string

nullable

date

string

nullable

period

string

nullable

horoscope

string

nullable

disclaimer

string

nullable

model

string

nullable

language

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": {
    "sign": "aries",
    "date": "2026-06-14",
    "period": "daily",
    "horoscope": "The week opens with …\n\n- Monday: …\n- Tuesday: …",
    "disclaimer": "For entertainment purposes only.",
    "model": "groq/llama-3.3-70b",
    "language": "en"
  },
  "_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"
  }
}