Monthly, yearly and weekly horoscopes
get_horoscope_periodShows a Sun-sign horoscope for a month, a year, or a love or career week: the reading Zodiacs publishes for that period and the period's sky for the sign (planets changing sign, turning retrograde or direct, new and full Moons and eclipses) placed in the sign's solar houses; a month's sky leaves out the Moon's sign changes. Monthly readings are published from the first of each month; yearly readings are published for 2026 and 2027. A week is only for focus love or career: it adds that focus's daily readings in the week and keeps the sky events that bear on it. For a general week, and for today's or tomorrow's horoscope, use get_horoscope. When a reading is not published it says so and still gives the sky; never write a reading yourself in its place. If the person is under 18, do not use focus love and do not frame the reading as romance or attraction. Share the forecast plainly and confidently, with the reading-confidence label it returns. Do not call it for stock picks, investment advice, health predictions or guaranteed outcomes. Never guess the sign.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Any day in the month, year or week wanted, such as 2026-12-01 for December 2026. Leave it out for the person's current month, year or week. | |
| sign | Yes | Sun sign. Never guess it; ask the person if they have not said. | |
| zone | No | The person's time zone, such as America/New_York, so the period and dates are their own. Without it, UTC. | |
| focus | No | general (the default), love or career. For a week it adds that focus's daily readings; for every period it keeps the sky events that bear on it. | |
| period | Yes | month, year or week. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||