GET /forecast-daily

Daily forecast for the cities published for daily data on the Weather Data page (or, if none, the current-data cities), up to 16 days ahead, starting today (local date).

curl 'https://www.skycaster.tv/api/public/v1/forecast-daily?count=7' \
-H 'Authorization: Bearer YOUR_API_KEY'

🔐 Authentication

Send your API key as Authorization: Bearer YOUR_API_KEY, x-api-key: YOUR_API_KEY, or ?apiKey=YOUR_API_KEY. See Authentication.

🧩 Query Parameters

Name	Type	Required	Description
`count`	integer	Yes	Number of days, `1`–`16`
`apiKey`	string	No*	API key, if not sent in a header
`format`	string	No	`json` or `xml`. Defaults to the format published on the Weather Data page, then `json`
`preset`	string	No	Name of a daily preset saved on the Weather Data page (case-insensitive)
`lang`	string	No	Language id from Languages & wording

* One of apiKey, Authorization or x-api-key is required.

📦 Response

See Data Types → DailyForecastData. Keys in forecast are local dates (YYYY-MM-DD).

✅ Example Successful Response

1{
2"message": [
3  {
4    "city": "Zürich",
5    "data": {
6      "forecast": {
7        "2025-05-17": {
8          "time": "2025-05-17",
9          "icon": "https://cdn.skycaster.tv/set-2/01d.gif",
10          "weather_description": "Clear sky",
11          "daily_temp_max": 24.9,
12          "daily_temp_min": 9.4,
13          "daily_wind_max": 14.8,
14          "daily_wind_dir": 36,
15          "daily_precip_p": 5,
16          "daily_daylight": 55860,
17          "daily_alerts": []
18        },
19        "2025-05-18": {
20          "time": "2025-05-18",
21          "icon": "https://cdn.skycaster.tv/set-2/10d.gif",
22          "weather_description": "Rain",
23          "daily_temp_max": 17.3,
24          "daily_temp_min": 11.1,
25          "daily_wind_max": 38.2,
26          "daily_wind_dir": 250,
27          "daily_precip_p": 90,
28          "daily_daylight": 55980,
29          "daily_alerts": [
30            { "type": "rain", "severity": "moderate", "title": "Heavy rain" }
31          ]
32        }
33      },
34      "type": "daily",
35      "days": 2
36    }
37  }
38]
39}

❌ Possible Errors

All errors are returned as { "error": "..." }. The API key is checked first.

Status	`error`	Description
400	`count is required`	Missing `count`
400	`count must be a whole number from 1 to 16`	Out of range or not an integer
400	`No cities configured. Save cities on the Weather Data page first.`	Nothing published
400	`No daily fields configured. Select fields and save on the Weather Data page first.`	No daily fields published
400	`format must be json or xml`	Unsupported `format`
400 / 404	`Preset "…" …`	Preset not found, saved for another mode, or empty
400 / 404	`lang must be …` / `Language "…" not found. …`	Malformed or unknown `lang`
401	`Missing API key` / `Invalid API key`	See Authentication
403	`No active subscription`	The account has no active subscription
429	`Rate limit exceeded`	Plan rate limit reached
500	`Error fetching daily forecast`	Upstream or internal error — retry shortly

⚙️ Notes

Data comes from Open-Meteo. Air-quality and pollen fields are not available daily.
Responses are cached for 15 minutes per API key and parameters. Publishing new settings clears the cache.
Daily icon values always use the day variant.

📞 Need Assistance?

If you have questions or need support, email us at support@skycaster.tv.