apyhub
▣ SMART GENERATION

Generate Daily Horoscope API

What it does

Daily Horoscope generates a horoscope for a zodiac sign on a specific date. Send a date, a sign, and an optional tone, and you get back a structured reading for the day.

The response includes date, sign, overview, love, career, health, lucky_color, and lucky_number. That makes it easy to surface a full daily reading in a consumer app, a membership dashboard, or a content workflow that publishes horoscope copy by sign.

Use tone to shape the writing style: balanced, positive, or direct. If you need consistency across a product or content feed, pass the same date and sign to generate comparable readings for each zodiac profile.

Daily Horoscope is a simple fit when you need astrology content assembled into a predictable response shape rather than freeform text.

POST
Generate a daily horoscope for a zodiac sign or birth profile
http://localhost:8080/dosvak/generate-daily-horoscope

QUICKSTART

GUIDE

Quickstart

Generate a daily horoscope for one sign by sending the required sign and a date.

curl -X POST "http://localhost:8080/dosvak/generate-daily-horoscope" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-26","sign":"aries"}'

What you'll get back

Returns a JSON object with these top-level fields: date (string), love (string), sign (string), career (string), health (string), overview (string), lucky_color (string), and lucky_number (integer).

{
  "date": "2026-07-26",
  "love": "Be open to a small gesture that deepens connection.",
  "sign": "aries",
  "career": "A practical decision will move work forward.",
  "health": "Keep your routine steady and get enough rest.",
  "overview": "A focused day favors simple plans and clear communication.",
  "lucky_color": "blue",
  "lucky_number": 7
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Generates a daily horoscope for a zodiac sign and returns a JSON object with horoscope text and related fields for that day.

Request Body

ParameterTypeMandatoryDescription
dateStringYesThe horoscope date in date format (YYYY-MM-DD).
signENUMNoThe zodiac sign. Allowed values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces. Default: aries
toneENUMNoThe writing tone. Allowed values: balanced, positive, direct. Default: balanced.

Response

Returns a JSON object with date, love, sign, career, health, overview, lucky_color, and lucky_number fields. date and sign are strings, love, career, health, overview, and lucky_color are strings, and lucky_number is an integer.

ParameterTypeMandatoryDescription
dateStringNoThe horoscope date in date format (YYYY-MM-DD).
loveStringNoHoroscope text for love.
signStringNoThe zodiac sign.
careerStringNoHoroscope text for career.
healthStringNoHoroscope text for health.
overviewStringNoGeneral horoscope overview text.
lucky_colorStringNoThe lucky color.
lucky_numberIntegerNoThe lucky number.

Body

Name
Type
Description
bodyREQUIRED
object
—
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Product
CatalogPricingQuickstartBecome a providerStatus (opens in new tab)
Company
AboutBlogCareers (opens in new tab)Contact
Legal
Terms of ServicePrivacy PolicyProvider terms
© 2026 APYHUB · BUILT FOR DEVELOPERS