Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Horoscope → Personal Yearly

AI-generated

Summary

Generate a personalized yearly horoscope forecast for an individual based on their exact birth date, time, and location for a specified target date, using selectable astrological traditions and language preferences.

Inputs

  • Year (required) — Birth year in 4-digit format (e.g., 1990).
  • Month (required) — Birth month as a number from 1 (January) to 12 (December).
  • Day (required) — Birth day of the month (1-31).
  • Hour (required) — Birth hour in 24-hour format (0-23, where 0 represents midnight and 12 represents noon).
  • Minute (required) — Birth minute (0-59).
  • Location Type (required) — Specifies how to provide birth location: either by city name (auto-detects coordinates) or directly by geographic coordinates.
  • City (required) — Birth city name (e.g., "London", "New York", "Kyiv") — required if Location Type is 'city'.
  • Country Code (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR) — required if Location Type is 'city'.
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive for North) — required if Location Type is 'coordinates'.
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive for East) — required if Location Type is 'coordinates'.
  • Target Date — Date for the yearly prediction in YYYY-MM-DD format. If omitted, the current date is used for forecasting.
  • Language — Language code for the horoscope text output (e.g., en for English, uk for Ukrainian, ru for Russian, es for Spanish, de for German). Defaults to English.
  • Tradition — Astrological tradition to influence the interpretation style and emphasis. Options include: Chinese, Classical, Event Oriented, Psychological, Universal (default), and Vedic.

Output shape

a single JSON object containing the personalized yearly horoscope forecast data.

The output contains detailed astrological analysis and interpretations for the specified individual's birth details and target date. The result varies according to the chosen astrological tradition and language settings.

Links

Discussion