Sign In Get API Key
CATEGORY

Horoscope

What is this category

The Horoscope category provides daily horoscope content for the 12 zodiac signs, in two zodiac systems (Vedic sidereal Moon-sign and Western tropical Sun-sign), with three sub-types (general, love, career), in multiple languages.

Content is generated nightly at 03:00 IST and served from cache (typical response under 50 ms). For birth-data-driven personalized horoscopes, see the Vedic Astrology category.

Endpoints

EndpointReturns
Daily Horoscope — GET /api/v3/horoscope/daily One-day horoscope content with lucky time window (12 signs × 2 zodiac systems × 3 sub-types × multi-language)
Weekly Horoscope — GET /api/v3/horoscope/weekly 7-day weekly horoscope (Monday–Sunday) with ISO week key and flexible date selection
Monthly Horoscope — GET /api/v3/horoscope/monthly Calendar-month horoscope with 6 structured sections (Overview, Career, Money, Love, Health, Important Dates) plus structured content_sections object
Yearly Horoscope — GET /api/v3/horoscope/yearly Calendar-year horoscope with 10 structured sections (Overview, Career, Money, Love, Family & Home, Health, Education, Travel, Spirituality, Important Dates) — deepest forecast in the family

Features

  • One endpoint, every combination. Pass sign, optionally zodiac_system, sub_type, date, language.
  • Three content formats in every response. HTML (content), plain text (content_text), and paragraph array (content_paragraphs) — no parser needed.
  • Rich metadata. Mood, lucky number/color/time, compatible sign, 5-star ratings (love/career/money/health/overall), dos/donts, key theme.
  • Date flexibility. today, tomorrow, yesterday, or any future date in YYYY-MM-DD.
  • Multi-language. English and Hindi live. Tamil, Telugu, Bengali, Marathi, Gujarati, Kannada, Malayalam, Punjabi, Odia, Assamese on the roadmap.
  • Sub-50ms response. Pure DB lookup after generation — never blocks on AI at request time.

Pricing & quota

No separate subscription. Horoscope calls count against your shared request quota, same as charts, matching, transit, and panchang endpoints. See pricing for plan details.

Where to next