Daily Horoscope (HTML)

GET

/embed/daily-horoscope

request.sh

curl -X GET https://api.astroway.info/v1/embed/daily-horoscope \
  -H "Content-Type: application/json"

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

• Production

Iframe-friendly daily horoscope card per zodiac sign.

Parameters

Query Parameters

sign

string

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

Zodiac sun sign, lowercase English name.

Example

leo

date

string format: date

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

Example

2026-08-01

time

string

Local birth time HH:mm:ss. Defaults to 12:00:00.

Example

14:30:00

tz

number

UTC offset in hours, e.g. 2 or -5.5. Defaults to 0.

Example

2

lat

number

Latitude in decimal degrees. Defaults to 0.

Example

50.45

lng

number

Longitude in decimal degrees. Defaults to 0.

Example

30.52

city

string

Optional city label shown on the card.

lang

string

Allowed values: uk en de ru pl es pt fr it nl cs ro hu el tr ar hi ja ko vi id

Widget language. Also accepts the Accept-Language header.

Example

de

theme

string

Allowed values: dark light console

Colour scheme. Unknown values fall back to dark.

Example

light

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

Responses

200

Rendered widget markup, ready to drop into an iframe.

Media type text/html

string

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}