★ Horoscope API

Get Daily Horoscope

Query Parameters

Parameter	Type	Description
sign required	string	Zodiac sign (e.g. aries, taurus)

Example Request

GET https://freehoroscopeapi.com/api/v1/get-horoscope/daily?sign=aries

Success Response 200 OK

{
  "success": true,
  "data": {
    "date": "2026-02-18",
    "sign": "Aries",
    "horoscope": "A spark of divine inspiration ignites...",
    "horoscope_data": "A spark of divine inspiration ignites..."
  }
}

Get Weekly Horoscope

Query Parameters

Parameter	Type	Description
sign required	string	Zodiac sign (e.g. aries, taurus)

Example Request

GET https://freehoroscopeapi.com/api/v1/get-horoscope/weekly?sign=aries

Success Response 200 OK

{
  "success": true,
  "data": {
    "date": "2026-02-16",
    "period": "weekly",
    "sign": "Aries",
    "horoscope": "This week brings new opportunities...",
    "horoscope_data": "This week brings new opportunities..."
  }
}

Get Monthly Horoscope

Query Parameters

Parameter	Type	Description
sign required	string	Zodiac sign (e.g. aries, taurus)

Example Request

GET https://freehoroscopeapi.com/api/v1/get-horoscope/monthly?sign=aries

Success Response 200 OK

{
  "success": true,
  "data": {
    "date": "2026-02",
    "period": "monthly",
    "sign": "Aries",
    "horoscope": "February brings a wave of creativity...",
    "horoscope_data": "February brings a wave of creativity..."
  }
}

Error Responses

Missing Parameter 400

{
  "error": "Missing parameter",
  "message": "Please provide a zodiac sign...",
  "example": "/api/v1/get-horoscope/daily?sign=aries"
}

Invalid Zodiac Sign 404

{
  "error": "Invalid zodiac sign",
  "message": "\"invalid\" is not a valid zodiac sign",
  "valid_signs": ["aries", "taurus", "..."]
}

Method Not Allowed 405

{
  "error": "Method not allowed",
  "message": "Only GET requests are supported"
}