Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Horoscope → Personal Weekly Text

AI-generated

Summary

Generate a personalized weekly horoscope in textual form based on the individual's birth data, location, and desired date, formatted according to selected style and language options.

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).
  • Minute (required) — Birth minute (0-59).
  • Location Type (required) — Choose either 'City Name' (with city and country code for automatic coordinate detection) or 'Coordinates' (exact latitude and longitude).
  • City (required) — Birth city name, required if 'City Name' location type is selected.
  • Country Code (required) — 2-letter ISO country code corresponding to the birth city, required if 'City Name' location type is selected.
  • Latitude (required) — Geographic latitude in decimal degrees (-90 to 90), required if 'Coordinates' location type is selected.
  • Longitude (required) — Geographic longitude in decimal degrees (-180 to 180), required if 'Coordinates' location type is selected.
  • Target Date — Date for which the weekly horoscope should be predicted in YYYY-MM-DD format; defaults to the current date if left empty.
  • Language — Language code for the horoscope text output, e.g., en for English, uk for Ukrainian, ru for Russian, es for Spanish, or de for German.
  • Tradition — Astrological tradition that influences interpretation style and emphasis; options include Chinese, Classical, Event Oriented, Psychological, Universal (default), and Vedic.
  • Text Format — Output format for the horoscope text: bullet points, long prose, paragraph style (default), short summary, or structured categorized sections.
  • Include Emoji — Boolean flag to include emoji markers in the textual horoscope output (default is true).

Output shape

a single record containing the personalized weekly horoscope text and metadata

The response includes a textual horoscope prediction customized to the provided birth data and parameters. The output respects the selected language, tradition, and text format preferences. If the target date is not specified, the current date is used for the weekly forecast.

Links

Discussion