Overview

The Forecast API returns current conditions, minutely precipitation, hourly and daily forecasts, and weather alerts for a given coordinate.

Endpoint

GET /forecast/{lat},{lon}

Parameters

Parameter	Required	Default	Description
`lat,lon`	Yes	—	Latitude and longitude as path parameter (e.g. `47.37,8.55`)
`units`	No	`us`	Unit system: `us` (imperial), `si` (metric), `ca` (metric with km/h wind), `uk` (metric with mph wind), `auto` (based on country)
`lang`	No	`en`	Language code for text summaries
`extend`	No	—	Set to `hourly` to extend hourly forecast beyond 48 hours
`exclude`	No	—	Comma-separated blocks to exclude: `currently`, `minutely`, `hourly`, `daily`, `alerts`

Example Request

GET /forecast/47.37,8.55?units=si

Example Response

{
  "latitude": 47.37,
  "longitude": 8.55,
  "timezone": "Europe/Zurich",
  "offset": 1,
  "elevation": 408,
  "currently": {
    "time": 1709132400,
    "summary": "Partly Cloudy",
    "icon": "01d",
    "is_day": true,
    "temperature": 8.2,
    "apparentTemperature": 5.1,
    "humidity": 0.65,
    "pressure": 1018.5,
    "windSpeed": 12.3,
    "windDirection": 230,
    "cloudCover": 0.45,
    "visibility": 16.1
  },
  "hourly": {
    "summary": "Partly cloudy throughout the day.",
    "icon": "01d",
    "data": [
      {
        "time": 1709132400,
        "summary": "Partly Cloudy",
        "icon": "01d",
        "is_day": true,
        "temperature": 8.2,
        "apparentTemperature": 5.1,
        "humidity": 0.65,
        "pressure": 1018.5,
        "windSpeed": 12.3,
        "windDirection": 230,
        "cloudCover": 0.45,
        "precipitation": 0,
        "precipitationType": "none"
      }
    ]
  },
  "daily": {
    "summary": "Partly cloudy for the week.",
    "icon": "01d",
    "data": [
      {
        "time": 1709082000,
        "summary": "Partly cloudy throughout the day.",
        "icon": "01d",
        "is_day": true,
        "temperatureHigh": 11.5,
        "temperatureLow": 3.2,
        "humidity": 0.62,
        "pressure": 1018.5,
        "windSpeed": 15.1,
        "windDirection": 240,
        "cloudCover": 0.4,
        "precipitation": 0,
        "sunriseTime": 1709101200,
        "sunsetTime": 1709139600,
        "moonPhase": 0.62
      }
    ]
  },
  "alerts": []
}

Response Blocks

currently

Current weather conditions at the requested location.

Field	Type	Description
`time`	integer	Unix timestamp
`summary`	string	Human-readable summary
`icon`	string	Weather condition code with day/night suffix (e.g. `"01d"`, `"07n"`). See Weather Icons.
`is_day`	boolean	Whether the data point is during daylight hours
`temperature`	float	Temperature
`apparentTemperature`	float	Feels-like temperature
`humidity`	float	Relative humidity (0–1)
`pressure`	float	Sea-level pressure (hPa)
`windSpeed`	float	Wind speed
`windDirection`	integer	Wind direction (0–360°)
`cloudCover`	float	Cloud cover (0–1)
`visibility`	float	Visibility distance

hourly

Hourly forecast for the next 48 hours (or extended with extend=hourly). Each item in data contains the same fields as currently.

daily

Daily forecast for the next 7 days. Each item in data includes:

Field	Type	Description
`time`	integer	Unix timestamp (start of day)
`summary`	string	Human-readable daily summary
`temperatureHigh`	float	Daytime high temperature
`temperatureLow`	float	Overnight low temperature
`sunriseTime`	integer	Unix timestamp of sunrise
`sunsetTime`	integer	Unix timestamp of sunset
`moonPhase`	float	Lunar phase (0 = new moon, 0.5 = full moon)
`precipitation`	float	Daily precipitation total

alerts

Array of active weather alerts for the area. Each alert includes title, description, time, expires, and severity.

Units

Measurement	`us`	`si`	`ca`	`uk`
Temperature	°F	°C	°C	°C
Wind speed	mph	m/s	km/h	mph
Precipitation	in/hr	mm/hr	mm/hr	mm/hr
Visibility	mi	km	km	mi
Elevation	ft	m	m	m

Errors

Status	Description
`400`	Invalid coordinates or parameters
`403`	Invalid API key
`429`	Rate limit exceeded
`503`	Forecast data not loaded