Daily Sign Horoscope

The Daily Sign Horoscope endpoint provides general forecasts for each of the 12 zodiac signs. It serves as an excellent entry-point feature for apps, offering daily engagement without requiring full birth details.

GET/api/v2/horoscope/daily/sign

Endpoint Overview

Returns scores (0-100) for love, career, money, and health, along with a written forecast, lucky attributes, and moon phase data.

Set lang=fr for French or lang=it for Italian. The response keeps stable English keys while localizing interpretation text and display labels. The older locale query parameter remains available as a deprecated alias; when both are provided, lang takes precedence.

Query Parameters

Parameter	Type	Required	Description
sign	string	Yes	Zodiac sign slug (aries, taurus, gemini, etc.)
date	string	No	Date for the horoscope (YYYY-MM-DD) or 'today'. Default: today
tz_str	string	No	Timezone string (e.g. 'Europe/Paris' or 'AUTO'). Default: AUTO
lang	string	No	Interpretation language. Supported: en, fr, it. Regional forms such as fr-FR and it-IT are accepted. Default: en
locale	string	No	Deprecated alias for lang. Accepts en, fr, it, and regional forms. Use lang for new integrations; when both are supplied, lang takes precedence.

Example Request

curl -G "https://api.freeastroapi.com/api/v2/horoscope/daily/sign" \
 -H "x-api-key: YOUR_API_KEY" \
 -d "sign=aries" \
 -d "date=today" \
 -d "tz_str=Europe/Paris" \
 -d "lang=fr"

Response Example

{
  "meta": {
    "request_id": "req_3e283335",
    "generated_at": "2026-02-13T10:58:07",
    "settings": {
      "date_resolved": "2026-02-13",
      "version": "v2",
      "lang": "fr",
      "locale": "fr"
    },
    "engine": {
      "name": "DailyHoroscopeEngine",
      "version": "2.0.0"
    }
  },
  "data": {
    "sign": "aries",
    "sign_label": "Bélier",
    "date": "2026-02-13",
    "scores": { "overall": 84, "love": 83, "career": 89, "money": 85, "health": 78 },
    "lucky": {
      "color": { "key": "silver", "label": "Argent" },
      "number": 61,
      "time_window": {
        "display": "09h00 - 13h00",
        "start": "09:00",
        "end": "13:00",
        "tz": "UTC"
      }
    },
    "content": {
      "text": "Avec la Lune en Capricorne (Dernier quartier), les natifs du Bélier ressentent le climat du jour avec une sensibilité de Feu. Lune en maison 10 place aujourd'hui la direction professionnelle et la production concrète au premier plan. La priorité du jour porte sur votre trajectoire professionnelle ; votre meilleur appui reste l'initiative et l'action visible.",
      "theme": "Initiative",
      "keywords": ["Énergie", "Audace", "Initiative", "Élan", "Croissance", "Équilibre"],
      "supporting_insights": []
    },
    "astro": {
      "moon_sign": { "key": "capricorn", "label": "Capricorne" },
      "moon_phase": { "key": "last_quarter", "label": "Dernier quartier" },
      "highlights": [
        { "type": "moon_sign", "key": "capricorn", "label": "Lune en Capricorne" },
        { "type": "moon_phase", "key": "last_quarter", "label": "Dernier quartier" }
      ]
    }
  }
}