Horoscope – AstroJson API

API Reference

GET /v1/horoscopes

Returns a horoscope for the given zodiac sign, language, date, and period. Free and Hobbyist receive the same response structure (full horoscope without transits). Pro and Business include transits. The response includes horoscopeScore (0-5 per theme: general, career, finance, health, romance) for all tiers. Allowed parameters and other response fields depend on your subscription tier.

Parameters

Name	Type	Required	Description
sign	string	Yes	Zodiac sign: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces
lang	string	Yes	Language code. Free tier: en only. Paid tiers: all below.en (English), mk (Macedonian), de (German), es (Spanish), fr (French), it (Italian), pt (Portuguese), nl (Dutch), pl (Polish), ru (Russian), ja (Japanese), zh (Chinese), ar (Arabic), hi (Hindi), tr (Turkish), ko (Korean), sv (Swedish), no (Norwegian), da (Danish), fi (Finnish), el (Greek), id (Indonesian)
date	string	No	Date as YYYY-MM-DD or "today", "yesterday", "tomorrow" (default: today). Yesterday/tomorrow require a paid tier. Date range depends on tier.
period	string	No	Period type: daily, weekly, monthly, yearly (default: daily). Availability depends on tier.

Example Request

GET https://api.astrojson.com/v1/horoscopes?sign=leo&lang=en&date=2025-02-15&period=daily
X-API-KEY: your_api_key_here

API Response by Plan

Free and Hobbyist receive the same response structure (full horoscope without transits). Pro and Business include transits. Upgrade for higher rate limits and extended date ranges.

Full horoscope with career, finance, health, romance. Includes compatibility, luckyNumber, luckyTime, mood, horoscopeScore. No transits.

{
  "lang": "en",
  "date": "2025-02-15",
  "period": "daily",
  "color": "Sapphire",
  "colorHex": "#0F52BA",
  "compatibility": ["Aries", "Sagittarius"],
  "luckyNumber": 7,
  "luckyTime": "Late Afternoon",
  "mood": "Confident and Creative",
  "sign": "Leo",
  "zodiac": {
    "element": "Fire",
    "name": "Leo",
    "symbol": "♌"
  },
  "horoscope": {
    "general": "Today brings opportunities for creative expression...",
    "career": "Your leadership shines in meetings...",
    "finance": "A steady approach to investments pays off...",
    "health": "Energy levels are high—good day for exercise...",
    "romance": "Passion and warmth strengthen connections..."
  },
  "horoscopeScore": {
    "general": 4,
    "career": 3,
    "finance": 5,
    "health": 2,
    "romance": 4
  }
}