https://open-meteo.com/en/docs Open-Meteo * Home * Features * API Documentation GitHub API Documentation Select your location, weather variables and start using the API. URL Builder Parameter documentation Select Coordinates or City [52.52 ] Latitude [13.41 ] Longitude [Berlin ] Select city Detect GPS Position Hourly Weather Variables [*] Temperature (2 m) [ ] Relative humidity (2 m) [ ] Dewpoint (2 m) [ ] Apparent Temperature [ ] Sealevel Pressure [ ] Precipitation [ ] Weathercode [ ] Snow height [ ] Cloudcover Total [ ] Cloudcover Low [ ] Cloudcover Mid [ ] Cloudcover High [ ] Shortwave solar radiation [ ] Direct solar radiation [ ] Diffuse solar radiation [ ] Evapotranspiration [ ] Vapor Pressure Deficit [ ] Windspeed (10 m) [ ] Windspeed (80 m) [ ] Windspeed (120 m) [ ] Winddirection (10 m) [ ] Winddirection (80 m) [ ] Winddirection (120 m) [ ] Windgusts (10 m) [ ] Freezinglevel height [ ] Soil temperature 0 cm [ ] Soil temperature 6 cm [ ] Soil temperature 18 cm [ ] Soil temperature 54 cm [ ] Soil moisture 0-1 cm [ ] Soil moisture 1-3 cm [ ] Soil moisture 3-9 cm [ ] Soil moisture 9-27 cm [ ] Soil moisture 27-81 cm Settings [ ] Current weather with temperature, windspeed and weather code [Celsius degC ] Temperature Unit [Km/h ] Wind Speed Unit [Millimeter] Precipitation Unit [UTC ] Timezone [0] Past days Preview API URL (Open in new tab) [ ] You can copy this API URL into your application API documentation The API endpoint /v1/forecast accepts a WGS4 coordinate, a list of weather variables and responds with a JSON hourly weather forecast for 7 days. Time always starts at 0:00 today and contains 168 hours. All URL parameters are listed below: Parameter Format Required Default Description latitude, Floating Yes Geographical WGS84 longitude point coordiante of the location A list of weather variables which should be String returned. Values can be hourly array Yes coma separated, or multiple &hourly= parameter in the URL can be used. Include the currurrent current_weather Bool No false weather conditions in the JSON output. If fahrenheit is set, all temperature_unit String No celsius temperature values are converted to Fahrenheit. windspeed_unit String No kmh Available wind speed speed units ms, mph and kn windspeed_unit String No mm Available precipitation amount unitsinch If fahrenheit is set, all temperature_unit String No celsius temperature values are converted to Fahrenheit. If timezone is set, all timestamps are returned as local-time and data is timezone String No UTC returned starting at 0:00 local-time. Any time zone name from the time zone database is supported. If past_days is set, past_days Integer No 0 yesterdays or the day (0-2) before yesterdays data are also returned. Additional optional URL parameters will be added. For example, a daily parameter will be added to select daily weather forecast aggregations. For API stability, no required parameters will be added in the future! Hourly parameter definition The parameter &hourly= accepts the following values. Most weather variables are given as an instantaneous value for the indicated hour. Some variables like precipitation are calculated from the preceding hour as and average or sum. Variable Valid Unit Description time temperature_2m Instant degC Air temperature at 2 meters (degF) above ground relativehumidity_2m Instant % Relative humidity at 2 meters above ground dewpoint_2m Instant degC Dew point temperature at 2 (degF) meters above ground Apparent temperature is the degC perceived feels-like apparent_temperature Instant (degF) tempertature combinding wind chill factor, realtive humidity and solar radition pressure_msl Instant hPa Atmospheric air pressure reduced to sea level cloudcover Instant % Total cloud cover as an area fraction cloudcover_low Instant % Low level clouds and fog up to 3 km altitude cloudcover_mid Instant % Mid level clouds from 3 to 8 km altitude cloudcover_high Instant % High level clouds from 8 km altitude windspeed_10m km/h Wind speed at 10, 80 or 120 windspeed_80m Instant (mph, meters above ground. Wind windspeed_120m m/s, speed on 10 meters is the knots) standard level. winddirection_10m Wind direction at 10, 80 or winddirection_80m Instant deg 120 meters above ground winddirection_120m km/h Gusts at 10 meters above windgusts_10m Preceding (mph, ground as a maximum of the hour max m/s, preceding hour knots) shortwave_radiation Preceding W/m2 Shortwave solar radiation as hour mean average of the preceding hour direct_radiation Preceding W/m2 Direct solar radiation as hour mean average of the preceding hour diffuse_radiation Preceding W/m2 Diffure solar radiation as hour mean average of the preceding hour Vapor Pressure Deificit (VPD) in kilo pascal (kPa). For high VPD (>1.6), water vapor_pressure_deficit Instant kPa transpiration of plants increases. For low VPD (<0.4), transpiration decreases Preceding mm Sum of evapotranspration of evapotranspiration hour sum (inch) the preceding hour from lands urface and plants Preceding mm Total precipitation (rain, precipitation hour sum (inch) showers, snow) sum of the preceding hour Weather condition as a weathercode Instant WMO numeric code. Follow WMO code weather interpretation codes. See table below for details. snow_height Instant meters Snow height on the ground freezinglevel_height Instant meters Altitude of the 0degC level soil_temperature_0cm Temperature in the soil at 0, soil_temperature_6cm degC 6, 18 and 54 cm depths. 0 cm soil_temperature_18cm Instant (degF) is the surface temperature on soil_temperature_54cm land or water surface temperature on water. soil_moisture_0_1cm Average soil water content as soil_moisture_1_3cm volumetric mixing ratio at soil_moisture_3_9cm Instant m3/m3 0-1, 1-3, 3-9, 9-27 and 27-81 soil_moisture_9_27cm cm depths. soil_moisture_27_81cm JSON return object On success a JSON object will be returned. { "latitude": 52.52, "longitude": 13.419, "elevation": 44.812, "generationtime_ms": 2.2119, "hourly": { "time": ["2021-08-28T00:00", "2021-08-28T01:00", "2021-08-28T02:00", ...], "temperature_2m": [13, 12.7, 12.7, 12.5, 12.5, 12.8, 13, 12.9, 13.3, ...] }, "hourly_units": { "temperature_2m": "degC" }, "current_weather": { "time": "2021-08-28T09:00", "temperature": 13.3, "weathercode": 3, "windspeed": 10.3, "winddirection": 262 } } Parameter Format Description WGS84 of the center of the weather latitude, Floating grid-cell which was used to generate this longitude point forecast. This coordinate might be up to 5 km away. The elevation in meters of the selected elevation Floating weather grid-cell. In mountain terrain it point might differ from the location you would expect. Floating Generation time of the weather forecast in generationtime_ms point milli seconds. This is mainly used for performance monitoring and improvements. For each selected weather variable, data hourly Object will be returned as a floating point array. Additionally a time array will be returned with ISO8601 timestamps. hourly_units Object For each selected weather variable, the unit will be listed here. Current weather conditions with the current_weather Object attributes: time, temperature, windspeed, winddirection and weathercode Errors In case an error occurs, for example a URL parameter is not correctly specified, a JSON error object is returned with a HTTP 400 status code. { "error": true, "reason": "Cannot initialize WeatherVariable from invalid String value tempeture_2m for key hourly" } Weather variable documentation WMO Weather interpretation codes (WW) Code Description 0 Clear sky 1, 2, 3 Mainly clear, partly cloudy, and overcast 45, 48 Fog and depositing rime fog 51, 53, 55 Drizzle: Light, moderate, and dense intensity 56, 57 Freezing Drizzle: Light and dense intensity 61, 63, 65 Rain: Slight, moderate and heavy intensity 66, 67 Freezing Rain: Light and heavy intensity 71, 73, 75 Snow fall: Slight, moderate, and heavy intensity 77 Snow grains 80, 81, 82 Rain showers: Slight, moderate, and violent 85, 86 Snow showers slight and heavy 95 * Thunderstorm: Slight or moderate 96, 99 * Thunderstorm with slight and heavy hail *) Thunderstorm forecast with hail is only available in Central Europe (c) 2021 Features * Local models * Weather variables * Lightning fast APIs Resources * API Documentation * Support on Github * Service status and uptime * Contact us About * Blog * Privacy * Terms * License