Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Horoscope → Personal Weekly

AI-generated

Summary

Generate a personalized weekly horoscope prediction based on detailed birth data, including date, time, and location, for a specified target date using various astrological traditions.

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) — Specify birth location either by city name (auto-detects coordinates) or by exact latitude and longitude.
  • City (required) — Birth city name if location type is city (e.g., "London", "New York", "Kyiv").
  • Country Code (required) — 2-letter ISO country code for the birth city if location type is city (e.g., US, GB, UA).
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North) if location type is coordinates.
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East) if location type is coordinates.
  • Target Date — Date for the weekly horoscope prediction in YYYY-MM-DD format; if left empty, the current date is used.
  • Language — Language code for the horoscope text output (e.g., en=English, uk=Ukrainian, ru=Russian, es=Spanish, de=German). Defaults to English.
  • Tradition — Astrological tradition to use for interpretation style and emphasis, such as Chinese, Classical, Event Oriented, Psychological, Universal, or Vedic. Defaults to Universal.

Output shape

a JSON object containing the personalized weekly horoscope prediction data as returned from the astrology API

The output may vary in detail and structure depending on the selected astrological tradition and language. If a target date is omitted, the current date is used for the prediction. The forecast is based on the full birth data including precise time and location.

Examples

Example 1: Get a personalized weekly horoscope for a user born January 15, 1990, at 2:30 PM in London, GB, for the week containing 2024-01-15, using Universal tradition in English.

Year=1990, Month=1, Day=15, Hour=14, Minute=30, Location Type=City, City=London, Country Code=GB, Target Date=2024-01-15, Language=en, Tradition=Universal

Links

Discussion