curl -X POST "https://api.freeastroapi.com/api/v3/horoscope/weekly/personal" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "birth": {
      "year": 1990,
      "month": 5,
      "day": 15,
      "hour": 10,
      "minute": 0,
      "city": "London, UK",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "Europe/London",
      "time_known": true
    },
    "week_start": "2026-04-20",
    "include_interpretation_blocks": true
  }'

{
  "birth": {
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 10,
    "minute": 0,
    "city": "London, UK",
    "lat": 51.5074,
    "lng": -0.1278,
    "tz_str": "Europe/London",
    "time_known": true
  },
  "week_start": "2026-04-20",
  "include_interpretation_blocks": true
}

{
  "meta": {
    "request_id": "req_42c1b7a9",
    "generated_at": "2026-04-20T13:28:51.233830",
    "settings": {
      "week_start": "2026-04-20",
      "week_end": "2026-04-26",
      "version": "v3",
      "include_interpretation_blocks": true
    },
    "engine": {
      "name": "DailyHoroscopeEngine",
      "version": "3.1.0-weekly"
    }
  },
  "data": {
    "sign": "taurus",
    "period": {
      "start": "2026-04-20",
      "end": "2026-04-26",
      "days": 7
    },
    "scores": {
      "overall": 71,
      "love": 82,
      "career": 63,
      "money": 76,
      "health": 61
    },
    "content": {
      "text": "From April 20 to April 26, the week centers on Relationship Window, with timing led by Venus Trine Natal Moon. The timeline shows 5 supportive windows and 3 pressure windows, so plan around both openings and friction points. The practical focus is relationships & bonds and structure & career. Love is the strongest average score (82), while Health benefits from extra pacing (61).",
      "weekly_summary": "From April 20 to April 26, the week centers on Relationship Window, with timing led by Venus Trine Natal Moon. The timeline shows 5 supportive windows and 3 pressure windows, so plan around both openings and friction points. The practical focus is relationships & bonds and structure & career. Love is the strongest average score (82), while Health benefits from extra pacing (61).",
      "theme": "Stability",
      "keywords": ["Stability", "Practicality", "Focus"],
      "supporting_insights": [
        "Dominant topics: Relationship Window.",
        "Top exact hits: Venus Trine Natal Moon.",
        "Focus areas: Relationships & Bonds and Structure & Career."
      ]
    },
    "personal": {
      "focus_areas": ["Relationships & Bonds", "Structure & Career", "Background Themes"],
      "confidence_score": 92,
      "transits_top": [
        {
          "label": "Venus Trine Natal Moon",
          "score": 99.3,
          "event_date": "2026-04-21",
          "exact_at": "2026-04-21T13:42:39Z",
          "active_start": "2026-04-20T09:00:00Z",
          "active_end": "2026-04-22T18:00:00Z",
          "exact_hits": ["2026-04-21T13:42:39Z"],
          "transit_planet": { "key": "venus", "label": "Venus" },
          "natal_planet": { "key": "moon", "label": "Moon" },
          "aspect": { "key": "trine", "label": "Trine" }
        }
      ],
      "week_context": {
        "range_start": "2026-04-20",
        "range_end": "2026-04-26",
        "exact_hits": [
          {
            "timestamp": "2026-04-21T13:42:39Z",
            "label": "Venus Trine Natal Moon"
          }
        ],
        "next_shift": {
          "timestamp": "2026-04-21T13:42:39Z",
          "label": "Venus Trine Natal Moon exact",
          "type": "exact_hit"
        },
        "dominant_topics": [
          {
            "title": "Relationship Window",
            "category": "relationships",
            "focus_type": "sharp_event_peak",
            "score": 0.91,
            "peak_datetime": "2026-04-23T13:42:39Z"
          }
        ],
        "supportive_vs_challenging": {
          "supportive": 5,
          "challenging": 3
        }
      },
      "days": [
        {
          "date": "2026-04-20",
          "weekday": "monday",
          "scores": { "overall": 72, "love": 86, "career": 58, "money": 92, "health": 53 },
          "focus_areas": ["Relationships & Bonds", "Action & Energy"],
          "transits_top": [],
          "day_context": {
            "range_start": "2026-04-20",
            "range_end": "2026-04-20",
            "exact_hits": [],
            "dominant_topics": []
          }
        }
      ],
      "insights_meta": {
        "source": "timeline_and_transit_insights",
        "timeline_enabled": true,
        "insights_enabled": true,
        "period": "week",
        "range_start": "2026-04-20T00:00:00Z",
        "range_end": "2026-04-26T23:59:59Z"
      }
    }
  }
}