Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Horoscope → Personal Yearly Text

AI-generated

Summary

Generate a personalized yearly horoscope text prediction based on the user's birth date, time, and location, optionally for a specified target date, using a chosen astrological tradition and language with customizable text formatting and emoji inclusion.

Inputs

  • Year (required) — Birth year in 4-digit format (e.g., 1990)
  • Month (required) — Birth month as number 1-12 (January=1, December=12)
  • Day (required) — Birth day of month (1-31)
  • Hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon)
  • Minute (required) — Birth minute (0-59)
  • Location Type (required) — Method to specify birth location, either by city name or exact coordinates
  • City (required) — Birth city name (required if Location Type is city)
  • Country Code (required) — 2-letter ISO country code for the birth city (required if Location Type is city)
  • Latitude (required) — Geographic latitude in decimal degrees (-90 to 90, positive=North), required if Location Type is coordinates
  • Longitude (required) — Geographic longitude in decimal degrees (-180 to 180, positive=East), required if Location Type is coordinates
  • Target Date — Date for prediction in YYYY-MM-DD format; defaults to current date if empty
  • Language — Language code for horoscope text output (default is English)
  • Tradition — Astrological tradition affecting interpretation style and emphasis (default is Universal)
  • Text Format — Format of the returned horoscope text (e.g., paragraph, bullets, short, long, structured)
  • Include Emoji — Whether to include emoji markers in the output text (default true)

Output shape

a textual horoscope prediction string formatted per the selected text format

The output is a text-based personalized yearly horoscope interpretation that respects the specified language, tradition, and formatting options. If a target date is omitted, current date predictions are given.

Links

Discussion