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.

Free Plan Returns Sample Content

On the free plan this endpoint returns a fixed sample horoscope. The same content comes back for every date, sign system and language, and the response carries "is_sample": true along with "served_tier": "sample".

The sample matches the live response field for field, so you can build and test your entire integration on it — parsing, UI, caching, error handling. Live content, generated fresh every night, requires a paid plan. See pricing.

Where to next