Daily Forecast 16 Days - OpenWeatherMap

Daily Forecast 16 Days is available at any location on the globe. The forecast includes daily weather data and the response data is available in JSON or XML format.

Call 16 day / daily forecast data

How to make an API call

You can seach 16 day weather forecast with daily average parameters by geographic coordinates. All weather data can be obtained in JSON and XML formats.

API call

api.openweathermap.org/data/2.5/forecast/daily?lat={lat}&lon={lon}&cnt={cnt}&appid={API key}

Parameters
`lat, lon`	required	Geographical coordinates (latitude, longitude). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API.
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`cnt`	optional	A number of days, which will be returned in the API response (from `1` to `16`). Learn more
`mode`	optional	Data format. Possible values are: `json`, `xml`. If the `mode` parameter is empty the format is JSON by default. Learn more
`units`	optional	Units of measurement. `standard`, `metric` and `imperial` units are available. If you do not use the `units` parameter, `standard` units will be applied by default. Learn more
`lang`	optional	Language code. Learn more

Please use Geocoder API if you need automatic convert city names and zip-codes to geo coordinates and the other way around.

Please note that built-in geocoder has been deprecated. Although it is still available for use, bug fixing and updates are no longer available for this functionality.

Example of API call

Call 7 days forecast by geographic coordinates


                      api.openweathermap.org/data/2.5/forecast/daily?lat=44.34&lon=10.99&cnt=7&appid={API key}

                      
{
  "city": {
    "id": 3163858,
    "name": "Zocca",
    "coord": {
      "lon": 10.99,
      "lat": 44.34
    },
    "country": "IT",
    "population": 4593,
    "timezone": 7200
  },
  "cod": "200",
  "message": 0.0582563,
  "cnt": 7,
  "list": [
    {
      "dt": 1661857200,
      "sunrise": 1661834187,
      "sunset": 1661882248,
      "temp": {
        "day": 299.66,
        "min": 288.93,
        "max": 299.66,
        "night": 290.31,
        "eve": 297.16,
        "morn": 288.93
      },
      "feels_like": {
        "day": 299.66,
        "night": 290.3,
        "eve": 297.1,
        "morn": 288.73
      },
      "pressure": 1017,
      "humidity": 44,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.7,
      "deg": 209,
      "gust": 3.58,
      "clouds": 53,
      "pop": 0.7,
      "rain": 2.51
    },
    {
      "dt": 1661943600,
      "sunrise": 1661920656,
      "sunset": 1661968542,
      "temp": {
        "day": 295.76,
        "min": 287.73,
        "max": 295.76,
        "night": 289.37,
        "eve": 292.76,
        "morn": 287.73
      },
      "feels_like": {
        "day": 295.64,
        "night": 289.45,
        "eve": 292.97,
        "morn": 287.59
      },
      "pressure": 1014,
      "humidity": 60,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.29,
      "deg": 215,
      "gust": 3.27,
      "clouds": 66,
      "pop": 0.82,
      "rain": 5.32
    },
    {
      "dt": 1662030000,
      "sunrise": 1662007126,
      "sunset": 1662054835,
      "temp": {
        "day": 293.38,
        "min": 287.06,
        "max": 293.38,
        "night": 287.06,
        "eve": 289.01,
        "morn": 287.84
      },
      "feels_like": {
        "day": 293.31,
        "night": 287.01,
        "eve": 289.05,
        "morn": 287.85
      },
      "pressure": 1014,
      "humidity": 71,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.67,
      "deg": 60,
      "gust": 2.66,
      "clouds": 97,
      "pop": 0.84,
      "rain": 4.49
    },
    {
      "dt": 1662116400,
      "sunrise": 1662093595,
      "sunset": 1662141127,
      "temp": {
        "day": 294.39,
        "min": 286.8,
        "max": 294.39,
        "night": 288.05,
        "eve": 289.8,
        "morn": 287.56
      },
      "feels_like": {
        "day": 294.03,
        "night": 287.79,
        "eve": 289.51,
        "morn": 287.35
      },
      "pressure": 1015,
      "humidity": 56,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.15,
      "deg": 45,
      "gust": 1.72,
      "clouds": 92,
      "pop": 0.36,
      "rain": 0.11
    },
    {
      "dt": 1662202800,
      "sunrise": 1662180064,
      "sunset": 1662227419,
      "temp": {
        "day": 294.35,
        "min": 286.78,
        "max": 294.44,
        "night": 288.51,
        "eve": 290.55,
        "morn": 288.54
      },
      "feels_like": {
        "day": 294.14,
        "night": 288.63,
        "eve": 290.57,
        "morn": 288.41
      },
      "pressure": 1015,
      "humidity": 62,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.23,
      "deg": 288,
      "gust": 3.34,
      "clouds": 79,
      "pop": 1,
      "rain": 4.84
    },
    {
      "dt": 1662289200,
      "sunrise": 1662266533,
      "sunset": 1662313710,
      "temp": {
        "day": 294.93,
        "min": 287.9,
        "max": 294.93,
        "night": 289.29,
        "eve": 291.03,
        "morn": 288.04
      },
      "feels_like": {
        "day": 294.83,
        "night": 289.31,
        "eve": 291.04,
        "morn": 288.12
      },
      "pressure": 1018,
      "humidity": 64,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 1.31,
      "deg": 350,
      "gust": 1.8,
      "clouds": 88,
      "pop": 1,
      "rain": 3.44
    },
    {
      "dt": 1662375600,
      "sunrise": 1662353002,
      "sunset": 1662400001,
      "temp": {
        "day": 297.89,
        "min": 288.21,
        "max": 297.89,
        "night": 290.4,
        "eve": 292.15,
        "morn": 289.67
      },
      "feels_like": {
        "day": 297.78,
        "night": 290.3,
        "eve": 292.06,
        "morn": 289.68
      },
      "pressure": 1019,
      "humidity": 52,
      "weather": [
        {
          "id": 801,
          "main": "Clouds",
          "description": "few clouds",
          "icon": "02d"
        }
      ],
      "speed": 2.98,
      "deg": 34,
      "gust": 2.25,
      "clouds": 12,
      "pop": 0.08
    }
  ]
}

Bulk downloading

We provide number of bulk files with current weather and forecasts. More information is on the Bulk page.

Bulk downloading is available not for all accounts. To get more information please refer to the Price page.

Examples of bulk files

http://bulk.openweathermap.org/sample/

Weather fields in API response

If you do not see some of the parameters in your API response it means that these weather phenomena are just not happened for the time of measurement for the city or location chosen. Only really measured or calculated data is displayed in API response.

JSON


                   Example of API reponse

                   
{
  "city": {
    "id": 3163858,
    "name": "Zocca",
    "coord": {
      "lon": 10.99,
      "lat": 44.34
    },
    "country": "IT",
    "population": 4593,
    "timezone": 7200
  },
  "cod": "200",
  "message": 0.0582563,
  "cnt": 7,
  "list": [
    {
      "dt": 1661857200,
      "sunrise": 1661834187,
      "sunset": 1661882248,
      "temp": {
        "day": 299.66,
        "min": 288.93,
        "max": 299.66,
        "night": 290.31,
        "eve": 297.16,
        "morn": 288.93
      },
      "feels_like": {
        "day": 299.66,
        "night": 290.3,
        "eve": 297.1,
        "morn": 288.73
      },
      "pressure": 1017,
      "humidity": 44,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.7,
      "deg": 209,
      "gust": 3.58,
      "clouds": 53,
      "pop": 0.7,
      "rain": 2.51
    },
    {
      "dt": 1661943600,
      "sunrise": 1661920656,
      "sunset": 1661968542,
      "temp": {
        "day": 295.76,
        "min": 287.73,
        "max": 295.76,
        "night": 289.37,
        "eve": 292.76,
        "morn": 287.73
      },
      "feels_like": {
        "day": 295.64,
        "night": 289.45,
        "eve": 292.97,
        "morn": 287.59
      },
      "pressure": 1014,
      "humidity": 60,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.29,
      "deg": 215,
      "gust": 3.27,
      "clouds": 66,
      "pop": 0.82,
      "rain": 5.32
    },
    {
      "dt": 1662030000,
      "sunrise": 1662007126,
      "sunset": 1662054835,
      "temp": {
        "day": 293.38,
        "min": 287.06,
        "max": 293.38,
        "night": 287.06,
        "eve": 289.01,
        "morn": 287.84
      },
      "feels_like": {
        "day": 293.31,
        "night": 287.01,
        "eve": 289.05,
        "morn": 287.85
      },
      "pressure": 1014,
      "humidity": 71,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.67,
      "deg": 60,
      "gust": 2.66,
      "clouds": 97,
      "pop": 0.84,
      "rain": 4.49
    },
    ....

Fields in API response

city
- city.id City ID. Please note that built-in geocoder functionality has been deprecated. Learn more here.
- city.name City name. Please note that built-in geocoder functionality has been deprecated. Learn more here.
- city.coord
  - city.coord.lat City geo location, latitude
  - city.coord.lon City geo location, longitude
country Country code (GB, JP etc.). Please note that built-in geocoder functionality has been deprecated. Learn more here.
population Internal parameter
timezone Shift in seconds from UTC
cod Internal parameter
message Internal parameter
cnt A number of days returned in the API response
list
- list.dt Time of data forecasted
- list.temp
  - list.temp.day Temperature at 12:00 local time. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.temp.min Min daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.temp.max Max daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.temp.night Temperature at 00:00 local time. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.temp.eve Temperature at 18:00 local time. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.temp.morn Ttemperature at 06:00 local time. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
- list.feels_like
  - list.feels_like.day Temperature at 12:00 local time.This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.feels_like.night Temperature at 00:00 local time.This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.feels_like.eve Temperature at 18:00 local time.This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.feels_like.morn Temperature at 06:00 local time. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
- list.pressure Atmospheric pressure on the sea level, hPa
- list.humidity Humidity, %
- list.weather (more info Weather condition codes)
  - list.weather.id Weather condition id
  - list.weather.main Group of weather parameters (Rain, Snow, Extreme etc.)
  - list.weather.description Weather condition within the group. You can get the output in your language. Learn more.
  - list.weather.icon Weather icon id
- list.speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour.
- list.deg Wind direction, degrees (meteorological)
- list.gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour.
- list.clouds Cloudiness, %
- list.rain Precipitation volume, mm
- list.snow Snow volume, mm
- list.pop Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%

XML

Example of API response

                   
    <weatherdata>
    <location>
    <name>Zocca</name>
    <type/>
    <country>IT</country>
    <timezone>7200</timezone>
    <location altitude="0" latitude="44.34" longitude="10.99" geobase="geonames" geobaseid="3163858"/>
    </location>
    <credit/>
    <meta>
    <lastupdate/>
    <calctime>0</calctime>
    <nextupdate/>
    </meta>
    <sun rise="2022-08-30T04:36:27" set="2022-08-30T17:57:28"/>
    <forecast>
    <time day="2022-08-30">
    <sun rise="2022-08-30T04:36:27" set="2022-08-30T17:57:28"/>
    <symbol number="500" name="light rain" var="10d"/>
    <precipitation probability="0.7" value="2.51" type="rain"/>
    <windDirection deg="209" code="SSW" name="South-southwest"/>
    <windSpeed mps="2.7" unit="m/s" name="Light breeze"/>
    <windGust gust="3.58" unit="m/s"/>
    <temperature day="299.65" min="288.93" max="299.65" night="290.31" eve="297.15" morn="288.93" unit="kelvin"/>
    <feels_like day="299.65" night="290.3" eve="297.09" morn="288.73" unit="kelvin"/>
    <pressure unit="hPa" value="1017"/>
    <humidity value="44" unit="%"/>
    <clouds value="broken clouds" all="53" unit="%"/>
    </time>
    <time day="2022-08-31">
    <sun rise="2022-08-31T04:37:36" set="2022-08-31T17:55:42"/>
    <symbol number="500" name="light rain" var="10d"/>
    <precipitation probability="0.82" value="5.32" type="rain"/>
    <windDirection deg="215" code="SW" name="Southwest"/>
    <windSpeed mps="2.29" unit="m/s" name="Light breeze"/>
    <windGust gust="3.27" unit="m/s"/>
    <temperature day="295.76" min="287.73" max="295.76" night="289.37" eve="292.76" morn="287.73" unit="kelvin"/>
    <feels_like day="295.64" night="289.45" eve="292.97" morn="287.59" unit="kelvin"/>
    <pressure unit="hPa" value="1014"/>
    <humidity value="60" unit="%"/>
    <clouds value="broken clouds" all="66" unit="%"/>
    </time>
    <time day="2022-09-01">
    <sun rise="2022-09-01T04:38:46" set="2022-09-01T17:53:55"/>
    <symbol number="500" name="light rain" var="10d"/>
    <precipitation probability="0.84" value="4.49" type="rain"/>
    <windDirection deg="60" code="ENE" name="East-northeast"/>
    <windSpeed mps="2.67" unit="m/s" name="Light breeze"/>
    <windGust gust="2.66" unit="m/s"/>
    <temperature day="293.38" min="287.06" max="293.38" night="287.06" eve="289.01" morn="287.84" unit="kelvin"/>
    <feels_like day="293.31" night="287.01" eve="289.05" morn="287.85" unit="kelvin"/>
    <pressure unit="hPa" value="1014"/>
    <humidity value="71" unit="%"/>
    <clouds value="overcast clouds" all="97" unit="%"/>
    </time>
    ...
    </time>
    </forecast>
    </weatherdata>

Fields in API response

location
- location.name City name. Please note that built-in geocoder functionality has been deprecated. Learn more here.
- location.type Prototype parameter
- location.country Country code (GB, JP etc.). Please note that built-in geocoder functionality has been deprecated. Learn more here.
- location.timezone Shift in seconds from UTC
- location.location
  - location.location.altitude City geo location, altitude above the sea level
  - location.location.latitude City geo location, latitude
  - location.location.longitude City geo location, longitude
  - location.location.geobase Internal parameter
  - location.location.geobaseid Internal parameter
meta
- meta.lastupdate Internal parameter
- meta.calctime Speed of data calculation
- meta.nextupdate Internal parameter
sun
- sun.rise Sunrise time
- sun.set Sunset time
forecast
- forecast.time
  - forecast.time.day Date of weather data forecasted
- forecast.symbol
  - forecast.symbol.number Weather condition id
  - forecast.symbol.name Weather condition
  - forecast.symbol.var Weather icon id
- forecast.precipitation
  - forecast.precipitation.value Precipitation volume for the last day, mm
  - forecast.precipitation.type Type of precipitation. Possible value is rain, snow.
  - forecast.precipitation.probability Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%
- forecast.windDirection
  - forecast.windDirection.deg Wind direction, degrees (meteorological)
  - forecast.windDirection.code Code of the wind direction. Possible value is WSW, N, S etc.
  - forecast.windDirection.name Full name of the wind direction.
- forecast.windSpeed
  - forecast.windSpeed.mps Wind speed, meters per second
  - forecast.windSpeed.unit Wind speed units, m/s
  - forecast.windSpeed.nameType of wind
- forecast.windGust
  - forecast.windGust.gust Wind gust, meters per second
  - forecast.windGust.unit Wind gust units, m/s
- forecast.temperature
  - forecast.temperature.day Temperature at 12:00 local time for forecasted day. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.temperature.min Min daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.temperature.max Max daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.temperature.night Temperature at 00:00 local time for forecasted day. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.temperature.eve Temperature at 18:00 local time for forecasted day. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.temperature.morn Temperature at 06:00 local time for forecasted day. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.temperature.unit Unit of measurements. Possible values are Celsius, Kelvin, Fahrenheit.
- forecast.feels_like
  - forecast.feels_like.day Temperature at 12:00 local time for forecasted day. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.feels_like.night Temperature at 00:00 local time for forecasted day. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.feels_like.eve Temperature at 18:00 local time for forecasted day. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.feels_like.morn Temperature at 06:00 local time for forecasted day. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - forecast.feels_like.unit Unit of measurements. Possible values are Celsius, Kelvin, Fahrenheit. Unit Default: Kelvin
- forecast.pressure
  - forecast.pressure.unit hPa
  - forecast.pressure.value Pressure value
- forecast.humidity
  - forecast.humidity.unit %
  - forecast.humidity.value Humidity value
- forecast.clouds
  - forecast.pressure.value Name of the cloudiness
  - forecast.pressure.all Cloudiness
  - forecast.pressure.unit %

List of condition codes

List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere including extreme conditions like tornado, hurricane etc.)

Min/max temperature in current weather API and forecast API

Please, do not confuse min/max parameters in our weather APIs.

In 16 Day forecast - min and max mean maximum and minimum temperature in the day.
In Current weather API, Hourly forecast API and 5 day / 3 hour forecast API - temp_min and temp_max are optional parameters mean min / max temperature in the city at the current moment to see deviation from current temp just for your reference. For large cities and megalopolises geographically expanded it might be applicable. In most cases both temp_min and temp_max parameters have the same volume as 'temp'. Please, use temp_min and temp_max parameters in current weather API optionally.


                     Example of current weather API response

                      
"main":{
   "temp":306.15, //current temperature
   "pressure":1013,
   "humidity":44,
   "temp_min":306, //min current temperature in the city
   "temp_max":306 //max current temperature in the city
},

For comparison, take a look at the example of daily forecast weather API response:


                      Example of daily forecast weather API response

                      
"dt":1406080800,
"temp":{
   "day":297.77,  //daily averaged temperature
   "min":293.52, //daily min temperature
   "max":297.77, //daily max temperature
   "night":293.52, //night temperature
   "eve":297.77, //evening temperature
   "morn":297.77 //morning temperature
}

Other features

Geocoding API

Requesting API calls by geographical coordinates is the most accurate way to specify any location. If you need to convert city names and zip-codes to geo coordinates and the other way around automatically, please use our Geocoding API.

Built-in geocoding

Please use Geocoder API if you need automatic convert city names and zip-codes to geo coordinates and the other way around.

Please note that API requests by city name, zip-codes and city id have been deprecated. Although they are still available for use, bug fixing and updates are no longer available for this functionality.

Built-in API request by city name

You can search 16 day weather forecast with daily average parameters by city name. All weather data can be obtained in JSON and XML formats.

API calls


                   api.openweathermap.org/data/2.5/forecast/daily?q={city name}&cnt={cnt}&appid={API key}


                   api.openweathermap.org/data/2.5/forecast/daily?q={city name},{country code}&cnt={cnt}&appid={API key}


                   api.openweathermap.org/data/2.5/forecast/daily?q={city name},{state code},{country code}&cnt={cnt}&appid={API key}

Parameters
`q`	required	City name, state code and country code divided by comma, use ISO 3166 country codes. You can specify the parameter not only in English. In this case, the API response should be returned in the same language as the language of requested location name if the location is in our predefined list of more than 200,000 locations.
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`cnt`	optional	A number of days, which will be returned in the API response (from `1` to `16`). Learn more
`mode`	optional	Data format. Possible values are: `json`, `xml`. If the `mode` parameter is empty the format is JSON by default. Learn more
`units`	optional	Units of measurement. `standard`, `metric` and `imperial` units are available. If you do not use the `units` parameter, `standard` units will be applied by default. Learn more
`lang`	optional	Language code. Learn more

Examples of API calls

Call 7 days forecast by city name in metric units


                      api.openweathermap.org/data/2.5/forecast/daily?q=London&units=metric&cnt=7&appid={API key}

                      
{
  "city": {
    "id": 2643743,
    "name": "London",
    "coord": {
      "lon": -0.1257,
      "lat": 51.5085
    },
    "country": "GB",
    "population": 1000000,
    "timezone": 3600
  },
  "cod": "200",
  "message": 0.0610271,
  "cnt": 7,
  "list": [
    {
      "dt": 1625140800,
      "sunrise": 1625111254,
      "sunset": 1625170853,
      "temp": {
        "day": 19.55,
        "min": 11.96,
        "max": 19.77,
        "night": 16.09,
        "eve": 19.47,
        "morn": 13.33
      },
      "feels_like": {
        "day": 19.15,
        "night": 15.43,
        "eve": 18.93,
        "morn": 12.7
      },
      "pressure": 1018,
      "humidity": 61,
      "weather": [
        {
          "id": 803,
          "main": "Clouds",
          "description": "broken clouds",
          "icon": "04d"
        }
      ],
      "speed": 2.71,
      "deg": 335,
      "gust": 3.8,
      "clouds": 69,
      "pop": 0.15
    },
    {
      "dt": 1625227200,
      "sunrise": 1625197696,
      "sunset": 1625257232,
      "temp": {
        "day": 21.51,
        "min": 14.46,
        "max": 22.73,
        "night": 16.56,
        "eve": 20.83,
        "morn": 15.21
      },
      "feels_like": {
        "day": 21.36,
        "night": 16.54,
        "eve": 20.69,
        "morn": 14.72
      },
      "pressure": 1016,
      "humidity": 63,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 4.01,
      "deg": 216,
      "gust": 6.08,
      "clouds": 58,
      "pop": 0.77,
      "rain": 2.32
    },
    {
      "dt": 1625313600,
      "sunrise": 1625284141,
      "sunset": 1625343609,
      "temp": {
        "day": 17.31,
        "min": 15.75,
        "max": 21.21,
        "night": 16.17,
        "eve": 18.97,
        "morn": 15.81
      },
      "feels_like": {
        "day": 17.34,
        "night": 16.24,
        "eve": 19.09,
        "morn": 15.56
      },
      "pressure": 1014,
      "humidity": 86,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 3.84,
      "deg": 212,
      "gust": 7.93,
      "clouds": 100,
      "pop": 0.81,
      "rain": 3.83
    },
    {
      "dt": 1625400000,
      "sunrise": 1625370588,
      "sunset": 1625429982,
      "temp": {
        "day": 19.05,
        "min": 14.03,
        "max": 19.58,
        "night": 15.56,
        "eve": 18.49,
        "morn": 15.69
      },
      "feels_like": {
        "day": 19.13,
        "night": 15.52,
        "eve": 18.51,
        "morn": 15.61
      },
      "pressure": 1008,
      "humidity": 81,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10d"
        }
      ],
      "speed": 3.62,
      "deg": 193,
      "gust": 7.41,
      "clouds": 99,
      "pop": 0.96,
      "rain": 5.95
    },
    {
      "dt": 1625486400,
      "sunrise": 1625457037,
      "sunset": 1625516353,
      "temp": {
        "day": 19.8,
        "min": 13.43,
        "max": 19.8,
        "night": 17.49,
        "eve": 16.04,
        "morn": 14.3
      },
      "feels_like": {
        "day": 19.27,
        "night": 17.7,
        "eve": 16.21,
        "morn": 14.06
      },
      "pressure": 1008,
      "humidity": 55,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 7.51,
      "deg": 188,
      "gust": 16.28,
      "clouds": 98,
      "pop": 1,
      "rain": 4.79
    },
    {
      "dt": 1625572800,
      "sunrise": 1625543489,
      "sunset": 1625602720,
      "temp": {
        "day": 19.68,
        "min": 13.27,
        "max": 20.38,
        "night": 15.47,
        "eve": 18.33,
        "morn": 14.21
      },
      "feels_like": {
        "day": 19.3,
        "night": 15.03,
        "eve": 17.86,
        "morn": 13.83
      },
      "pressure": 1009,
      "humidity": 61,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 8.19,
      "deg": 211,
      "gust": 16.75,
      "clouds": 32,
      "pop": 1,
      "rain": 1.91
    },
    {
      "dt": 1625659200,
      "sunrise": 1625629943,
      "sunset": 1625689085,
      "temp": {
        "day": 19.64,
        "min": 14.35,
        "max": 20.32,
        "night": 15.98,
        "eve": 19.61,
        "morn": 15.25
      },
      "feels_like": {
        "day": 19.3,
        "night": 15.77,
        "eve": 19.27,
        "morn": 15
      },
      "pressure": 1016,
      "humidity": 63,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 5.04,
      "deg": 202,
      "gust": 12.18,
      "clouds": 86,
      "pop": 0.21,
      "rain": 0.13
    }
  ]
}

Please note, that searching by states available only for the USA locations.

There is a possibility to receive a central district of the city/town with its own parameters (geographic coordinates/id/name) in API response. Please see the example below

Call 16 days forecast by geographic coordinates


                  api.openweathermap.org/data/2.5/forecast/daily?q=München,DE&appid={API key}

                  
{
  "city": {
    "id": 2867714,
    "name": "Munich",
    "coord": {
      "lon": 11.5755,
      "lat": 48.1374
    },
    "country": "DE",
    "population": 1260391,
    "timezone": 7200
  },
  "cod": "200",
  "message": 0.0518182,
  "cnt": 7,
  "list": [
    {
      "dt": 1625137200,
      "sunrise": 1625109452,
      "sunset": 1625167037,
      "temp": {
        "day": 287.91,
        "min": 284.05,
        "max": 287.91,
        "night": 285.11,
        "eve": 286.19,
        "morn": 284.05
      },
      "feels_like": {
        "day": 287.53,
        "night": 284.84,
        "eve": 285.95,
        "morn": 283.65
      },
      "pressure": 1015,
      "humidity": 80,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10d"
        }
      ],
      "speed": 6.27,
      "deg": 258,
      "gust": 12.42,
      "clouds": 100,
      "pop": 1,
      "rain": 10.96
    },
    {
      "dt": 1625223600,
      "sunrise": 1625195889,
      "sunset": 1625253422,
      "temp": {
        "day": 291.94,
        "min": 283.54,
        "max": 293.73,
        "night": 285.73,
        "eve": 292.25,
        "morn": 284.92
      },
      "feels_like": {
        "day": 291.47,
        "night": 285.29,
        "eve": 291.91,
        "morn": 284.58
      },
      "pressure": 1019,
      "humidity": 61,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 3.73,
      "deg": 320,
      "gust": 5.28,
      "clouds": 70,
      "pop": 0.38,
      "rain": 0.15
    },
    {
      "dt": 1625310000,
      "sunrise": 1625282329,
      "sunset": 1625339804,
      "temp": {
        "day": 295.56,
        "min": 284.31,
        "max": 295.88,
        "night": 288.83,
        "eve": 291.49,
        "morn": 288.28
      },
      "feels_like": {
        "day": 295.24,
        "night": 288.86,
        "eve": 291.39,
        "morn": 287.86
      },
      "pressure": 1016,
      "humidity": 53,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 2.55,
      "deg": 51,
      "gust": 2.39,
      "clouds": 96,
      "pop": 0.36,
      "rain": 0.61
    },
    {
      "dt": 1625396400,
      "sunrise": 1625368770,
      "sunset": 1625426183,
      "temp": {
        "day": 291.78,
        "min": 287.26,
        "max": 293.98,
        "night": 288.35,
        "eve": 291.19,
        "morn": 287.32
      },
      "feels_like": {
        "day": 291.79,
        "night": 288.41,
        "eve": 291.37,
        "morn": 287.38
      },
      "pressure": 1012,
      "humidity": 80,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10d"
        }
      ],
      "speed": 2.23,
      "deg": 78,
      "gust": 4,
      "clouds": 98,
      "pop": 0.99,
      "rain": 8.53
    },
    {
      "dt": 1625482800,
      "sunrise": 1625455214,
      "sunset": 1625512559,
      "temp": {
        "day": 292.64,
        "min": 286.76,
        "max": 294.28,
        "night": 287.83,
        "eve": 292.05,
        "morn": 286.76
      },
      "feels_like": {
        "day": 292.45,
        "night": 287.76,
        "eve": 292.03,
        "morn": 286.71
      },
      "pressure": 1016,
      "humidity": 69,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 4.59,
      "deg": 271,
      "gust": 10.71,
      "clouds": 100,
      "pop": 1,
      "rain": 5.28
    },
    {
      "dt": 1625569200,
      "sunrise": 1625541659,
      "sunset": 1625598933,
      "temp": {
        "day": 300.23,
        "min": 286.07,
        "max": 300.43,
        "night": 291.23,
        "eve": 296.12,
        "morn": 290.35
      },
      "feels_like": {
        "day": 300.58,
        "night": 291.34,
        "eve": 296.51,
        "morn": 290.16
      },
      "pressure": 1016,
      "humidity": 49,
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "sky is clear",
          "icon": "01d"
        }
      ],
      "speed": 3.36,
      "deg": 85,
      "gust": 7.31,
      "clouds": 0,
      "pop": 0
    },
    {
      "dt": 1625655600,
      "sunrise": 1625628107,
      "sunset": 1625685304,
      "temp": {
        "day": 301.22,
        "min": 288.54,
        "max": 301.62,
        "night": 293.1,
        "eve": 297.38,
        "morn": 292.67
      },
      "feels_like": {
        "day": 301.96,
        "night": 293.14,
        "eve": 297.76,
        "morn": 292.74
      },
      "pressure": 1017,
      "humidity": 53,
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "sky is clear",
          "icon": "01d"
        }
      ],
      "speed": 3.82,
      "deg": 76,
      "gust": 7.32,
      "clouds": 0,
      "pop": 0
    }
  ]
}

Built-in API request by city ID

You can seach 16 day weather forecast with daily average parameters by city ID. All weather data can be obtained in JSON and XML format.

List of city ID 'city.list.json.gz' can be downloaded here.

We recommend to call API by city ID to get unambiguous result for your city.

API call


                   api.openweathermap.org/data/2.5/forecast/daily?id={city ID}&cnt={cnt}&appid={API key}

Parameters
`id`	required	city ID
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`cnt`	optional	A number of days, which will be returned in the API response (from `1` to `16`). Learn more
`mode`	optional	Data format. Possible values are: `json`, `xml`. If the `mode` parameter is empty the format is JSON by default. Learn more
`units`	optional	Units of measurement. `standard`, `metric` and `imperial` units are available. If you do not use the `units` parameter, `standard` units will be applied by default. Learn more
`lang`	optional	Language code. Learn more

Example of API call

api.openweathermap.org/data/2.5/forecast/daily?id=524901&appid={API key}

                      
{
   "cod":"200",
   "message":0,
   "city":{
      "geoname_id":524901,
      "name":"Moscow",
      "lat":55.7522,
      "lon":37.6156,
      "country":"RU",
      "iso2":"RU",
      "type":"city",
      "population":0
   },
   "cnt":7,
   "list":[
      {
         "dt":1485766800,
         "temp":{
            "day":262.65,
            "min":261.41,
            "max":262.65,
            "night":261.41,
            "eve":262.65,
            "morn":262.65
         },
         "pressure":1024.53,
         "humidity":76,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":4.57,
         "deg":225,
         "gust": 8.3,
         "clouds":0,
         "snow":0.01
      },
      {
         "dt":1485853200,
         "temp":{
            "day":262.31,
            "min":260.98,
            "max":265.44,
            "night":265.44,
            "eve":264.18,
            "morn":261.46
         },
         "pressure":1018.1,
         "humidity":91,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":4.1,
         "deg":249,
         "gust": 6.3,
         "clouds":88,
         "snow":1.44
      },
      {
         "dt":1485939600,
         "temp":{
            "day":270.27,
            "min":266.9,
            "max":270.59,
            "night":268.06,
            "eve":269.66,
            "morn":266.9
         },
         "pressure":1010.85,
         "humidity":92,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":4.53,
         "deg":298,
         "gust": 5.3,
         "clouds":64,
         "snow":0.92
      },
      {
         "dt":1486026000,
         "temp":{
            "day":263.46,
            "min":255.19,
            "max":264.02,
            "night":255.59,
            "eve":259.68,
            "morn":263.38
         },
         "pressure":1019.32,
         "humidity":84,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":3.06,
         "deg":344,
         "gust": 5.3,
         "clouds":0
      },
      {
         "dt":1486112400,
         "temp":{
            "day":265.69,
            "min":256.55,
            "max":266,
            "night":256.55,
            "eve":260.09,
            "morn":266
         },
         "pressure":1012.2,
         "humidity":0,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":7.35,
         "deg":24,
         "gust": 5.3,
         "clouds":45,
         "snow":0.21
      },
      {
         "dt":1486198800,
         "temp":{
            "day":259.95,
            "min":254.73,
            "max":259.95,
            "night":257.13,
            "eve":254.73,
            "morn":257.02
         },
         "pressure":1029.5,
         "humidity":0,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":2.6,
         "deg":331,
         "gust": 5.3,
         "clouds":29
      },
      {
         "dt":1486285200,
         "temp":{
            "day":263.13,
            "min":259.11,
            "max":263.13,
            "night":262.01,
            "eve":261.32,
            "morn":259.11
         },
         "pressure":1023.21,
         "humidity":0,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":5.33,
         "deg":234,
         "gust": 8.9,
         "clouds":46,
         "snow":0.04
      }
   ]
}

Built-in API request by ZIP code

Please note if country is not specified then the search works for USA as a default.

API call


                   api.openweathermap.org/data/2.5/forecast/daily?zip={zip code},{country code}&appid={API key}

Parameters
`zip`	required	Zip code
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`cnt`	optional	A number of days, which will be returned in the API response (from `1` to `16`). Learn more
`mode`	optional	Data format. Possible values are: `json`, `xml`. If the `mode` parameter is empty the format is JSON by default. Learn more
`units`	optional	Units of measurement. `standard`, `metric` and `imperial` units are available. If you do not use the `units` parameter, `standard` units will be applied by default. Learn more
`lang`	optional	Language code. Learn more

Example of API call


                      api.openweathermap.org/data/2.5/forecast/daily?zip=94040,us&appid={API key}

                      
{
   "city":{
      "id":0,
      "name":"Mountain View",
      "coord":{
         "lon":-122.088,
         "lat":37.3855
      },
      "country":"US",
      "population":0
   },
   "cod":"200",
   "message":2.1505307,
   "cnt":7,
   "list":[
      {
         "dt":1519070400,
         "temp":{
            "day":283.99,
            "min":271.86,
            "max":283.99,
            "night":271.86,
            "eve":278.3,
            "morn":280.44
         },
         "pressure":989.94,
         "humidity":52,
         "weather":[
            {
               "id":500,
               "main":"Rain",
               "description":"light rain",
               "icon":"10d"
            }
         ],
         "speed":3.36,
         "deg":325,
         "gust": 5.3,
         "clouds":20,
         "rain":0.31
      },
      {
         "dt":1519156800,
         "temp":{
            "day":282.68,
            "min":268.17,
            "max":282.68,
            "night":271.62,
            "eve":277.16,
            "morn":268.17
         },
         "pressure":996.36,
         "humidity":50,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":1.25,
         "deg":245,
         "gust": 1.3,
         "clouds":0
      },
      {
         "dt":1519243200,
         "temp":{
            "day":280.88,
            "min":271.62,
            "max":280.98,
            "night":274.19,
            "eve":277.8,
            "morn":271.62
         },
         "pressure":996.59,
         "humidity":84,
         "weather":[
            {
               "id":500,
               "main":"Rain",
               "description":"light rain",
               "icon":"10d"
            }
         ],
         "speed":1.46,
         "deg":232,
         "gust": 2.3,
         "clouds":92,
         "rain":1.3
      },
      {
         "dt":1519329600,
         "temp":{
            "day":283.8,
            "min":282.02,
            "max":285.94,
            "night":284.02,
            "eve":285.94,
            "morn":282.02
         },
         "pressure":1014.12,
         "humidity":0,
         "weather":[
            {
               "id":501,
               "main":"Rain",
               "description":"moderate rain",
               "icon":"10d"
            }
         ],
         "speed":6.4,
         "deg":173,
         "gust": 7.3,
         "clouds":57,
         "rain":11.41
      },
      {
         "dt":1519416000,
         "temp":{
            "day":284.36,
            "min":281.5,
            "max":285.85,
            "night":281.5,
            "eve":285.85,
            "morn":283.32
         },
         "pressure":1014.73,
         "humidity":0,
         "weather":[
            {
               "id":501,
               "main":"Rain",
               "description":"moderate rain",
               "icon":"10d"
            }
         ],
         "speed":4.23,
         "deg":114,
         "gust": 5.3,
         "clouds":89,
         "rain":9.29
      },
      {
         "dt":1519502400,
         "temp":{
            "day":285.58,
            "min":279.27,
            "max":288.96,
            "night":282.02,
            "eve":288.96,
            "morn":279.27
         },
         "pressure":1015.81,
         "humidity":0,
         "weather":[
            {
               "id":500,
               "main":"Rain",
               "description":"light rain",
               "icon":"10d"
            }
         ],
         "speed":1.27,
         "deg":57,
         "gust": 3.3,
         "clouds":9
      },
      {
         "dt":1519588800,
         "temp":{
            "day":287.05,
            "min":279.96,
            "max":290.51,
            "night":282.65,
            "eve":290.51,
            "morn":279.96
         },
         "pressure":1012.12,
         "humidity":0,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":1.75,
         "deg":54,
         "gust": 4.1,
         "clouds":1
      }
   ]
}

Format

Data format. JSON format is used by default. To get data in XML format use mode=xml.

Parameters
`mode`	optional	Data format. Possible values are: `json`, `xml`. If the `mode` parameter is empty the format is JSON by default.

Examples of API calls

JSON


                   api.openweathermap.org/data/2.5/weather?q=London&appid={API key}

                   
{
   "coord":{
      "lon":-0.13,
      "lat":51.51
   },
   "weather":[
      {
         "id":300,
         "main":"Drizzle",
         "description":"light intensity drizzle",
         "icon":"09d"
      }
   ],
   "base":"stations",
   "main":{
      "temp":280.32,
      "pressure":1012,
      "humidity":81,
      "temp_min":279.15,
      "temp_max":281.15
   },
   "visibility":10000,
   "wind":{
      "speed":4.1,
      "deg":80,
      "gust":10
   },
   "clouds":{
      "all":90
   },
   "dt":1485789600,
   "sys":{
      "type":1,
      "id":5091,
      "message":0.0103,
      "country":"GB",
      "sunrise":1485762037,
      "sunset":1485794875
   },
   "id":2643743,
   "name":"London",
   "cod":200
}

XML


                   api.openweathermap.org/data/2.5/weather?q=London&mode=xml

                   
<weatherdata>
<location>
<name>London</name>
<type />
<country>GB</country>
<timezone />
<location altitude="0" latitude="51.5085" longitude="-0.1258" geobase="geonames" geobaseid="2643743" />
</location>
<credit />
<meta>
<lastupdate />
<calctime>0.0117</calctime>
<nextupdate />
</meta>
<sun rise="2017-01-30T07:40:34" set="2017-01-30T16:47:56" />
<forecast>
<time day="2017-01-30">
 <symbol number="500" name="light rain" var="10d" />
 <precipitation value="1.64" type="rain" />
 <windDirection deg="85" code="E" name="East" />
 <windSpeed mps="1.97" name="Light breeze" />
 <windGust gust="3.31" unit="m/s"/>
 <temperature day="7" min="4.34" max="7" night="4.91" eve="5.05" morn="7" />
 <pressure unit="hPa" value="1016.99" />
 <humidity value="100" unit="%" />
 <clouds value="few clouds" all="12" unit="%" />
</time>
<time day="2017-01-31">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="9.42" type="rain" />
 <windDirection deg="140" code="SE" name="SouthEast" />
 <windSpeed mps="3.37" name="" />
 <windGust gust="6.31" unit="m/s"/>
 <temperature day="9.66" min="6.16" max="11.51" night="10.63" eve="10.85" morn="6.16" />
 <pressure unit="hPa" value="1018.15" />
 <humidity value="100" unit="%" />
 <clouds value="overcast clouds" all="92" unit="%" />
</time>
<time day="2017-02-01">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="9.11" type="rain" />
 <windDirection deg="197" code="SSW" name="South-southwest" />
 <windSpeed mps="5.01" name="Gentle Breeze" />
 <windGust gust="6.31" unit="m/s"/>
 <temperature day="9.81" min="9.64" max="10.23" night="10.08" eve="9.81" morn="10.03" />
 <pressure unit="hPa" value="1011.7" />
 <humidity value="99" unit="%" />
 <clouds value="scattered clouds" all="44" unit="%" />
 </time>
 <time day="2017-02-02">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="3.98" type="rain" />
 <windDirection deg="184" code="S" name="South" />
 <windSpeed mps="8.42" name="Fresh Breeze" />
 <windGust gust="10.31" unit="m/s"/>
 <temperature day="11.44" min="8.86" max="11.53" night="8.86" eve="10.99" morn="10.05" />
 <pressure unit="hPa" value="999.34" />
 <humidity value="96" unit="%" />
 <clouds value="overcast clouds" all="92" unit="%" />
</time>
<time day="2017-02-03">
 <symbol number="500" name="light rain" var="10d" />
 <precipitation value="1.65" type="rain" />
 <windDirection deg="213" code="SSW" name="South-southwest" />
 <windSpeed mps="8.51" name="Fresh Breeze" />
 <windGust gust="11.31" unit="m/s"/>
 <temperature day="10.66" min="8.63" max="10.66" night="8.63" eve="9.14" morn="10.18" />
 <pressure unit="hPa" value="1010.98" />
 <humidity value="0" unit="%" />
 <clouds value="scattered clouds" all="48" unit="%" />
</time>
<time day="2017-02-04">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="7.25" type="rain" />
 <windDirection deg="172" code="S" name="South" />
 <windSpeed mps="10.39" name="Fresh Breeze" />
 <temperature day="8.68" min="7.07" max="10.4" night="8.48" eve="10.4" morn="7.07" />
 <pressure unit="hPa" value="1001.13" />
 <humidity value="0" unit="%" />
 <clouds value="overcast clouds" all="96" unit="%" />
</time>
<time day="2017-02-05">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="4.24" type="rain" />
 <windDirection deg="274" code="W" name="West" />
 <windSpeed mps="6.21" name="Moderate breeze" />
 <windGust gust="9.31" unit="m/s"/>
 <temperature day="8.5" min="4.86" max="8.5" night="4.86" eve="6.25" morn="8.26" />
 <pressure unit="hPa" value="995.24" />
 <humidity value="0" unit="%" />
 <clouds value="broken clouds" all="64" unit="%" />
</time>
</forecast>
</weatherd

Limitation of result

To limit the number of returned days please use cnt parameter.

Parameters
`cnt`		A number of days, which will be returned in the API response

Example of API call


                   http://api.openweathermap.org/data/2.5/forecast/daily?q=London&cnt=3&appid={API key}

                   
{
  "city": {
    "id": 2643743,
    "name": "London",
    "coord": {
      "lon": -0.1257,
      "lat": 51.5085
    },
    "country": "GB",
    "population": 1000000,
    "timezone": 3600
  },
  "cod": "200",
  "message": 0.05491,
  "cnt": 3,
  "list": [
    {
      "dt": 1599735600,
      "sunrise": 1599715685,
      "sunset": 1599762420,
      "temp": {
        "day": 292.05,
        "min": 286.3,
        "max": 292.77,
        "night": 289.72,
        "eve": 291.46,
        "morn": 286.3
      },
      "feels_like": {
        "day": 289.68,
        "night": 288,
        "eve": 288.78,
        "morn": 284.19
      },
      "pressure": 1023,
      "humidity": 40,
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "sky is clear",
          "icon": "01d"
        }
      ],
      "speed": 1.78,
      "deg": 332,
      "gust": 7.74,
      "clouds": 0,
      "pop": 0
    },
    {
      "dt": 1599822000,
      "sunrise": 1599802180,
      "sunset": 1599848682,
      "temp": {
        "day": 292.26,
        "min": 286.58,
        "max": 293.36,
        "night": 288.83,
        "eve": 290.65,
        "morn": 286.58
      },
      "feels_like": {
        "day": 289.07,
        "night": 286.12,
        "eve": 287.85,
        "morn": 284.39
      },
      "pressure": 1016,
      "humidity": 48,
      "weather": [
        {
          "id": 802,
          "main": "Clouds",
          "description": "scattered clouds",
          "icon": "03d"
        }
      ],
      "speed": 3.84,
      "deg": 242,
      "gust": 7.74,
      "clouds": 50,
      "pop": 0
    },
    {
      "dt": 1599908400,
      "sunrise": 1599888675,
      "sunset": 1599934943,
      "temp": {
        "day": 292.86,
        "min": 285.62,
        "max": 293.08,
        "night": 290.3,
        "eve": 292.15,
        "morn": 285.62
      },
      "feels_like": {
        "day": 290.24,
        "night": 289.13,
        "eve": 290.42,
        "morn": 282.9
      },
      "pressure": 1018,
      "humidity": 57,
      "weather": [
        {
          "id": 803,
          "main": "Clouds",
          "description": "broken clouds",
          "icon": "04d"
        }
      ],
      "speed": 4.19,
      "deg": 258,
      "gust": 7.74,
      "clouds": 74,
      "pop": 0
    }
  ]
}

Units of measurement

standard, metric, and imperial units are available. List of all API parameters with available units.

Parameters
`units`	optional	Units of measurement. `standard`, `metric` and `imperial` units are available. If you do not use the `units` parameter, `standard` units will be applied by default.

Temperature is available in Fahrenheit, Celsius and Kelvin units.

Wind speed is available in miles/hour and meter/sec.

For temperature in Fahrenheit and wind speed in miles/hour, use units=imperial
For temperature in Celsius and wind speed in meter/sec, use units=metric
Temperature in Kelvin and wind speed in meter/sec is used by default, so there is no need to use the units parameter in the API call if you want this

Examples of API calls:

Standard


                      https://api.openweathermap.org/data/2.5/forecast/daily?lat=57&lon=-2.15&appid={API key}

                      
{
  "city": {
    "id": 2641549,
    "name": "Newtonhill",
    "coord": {
      "lon": -2.15,
      "lat": 57
    },
    "country": "GB",
    "population": 3284,
    "timezone": 0
  },
  "cod": "200",
  "message": 18.6725653,
  "cnt": 3,
  "list": [
    {
      "dt": 1647345600,
      "sunrise": 1647325488,
      "sunset": 1647367827,
      "temp": {
        "day": 281.19,
        "min": 277.08,
        "max": 282.35,
        "night": 280.36,
        "eve": 281.38,
        "morn": 277.18
      },
      "feels_like": {
        "day": 277.4,
        "night": 276.74,
        "eve": 278.04,
        "morn": 273.02
      },
      "pressure": 1015,
      "humidity": 79,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 7.61,
      "deg": 194,
      "gust": 13.48,
      "clouds": 96,
      "pop": 0.42,
      "rain": 0.29
    },
    {
      "dt": 1647432000,
      "sunrise": 1647411724,
      "sunset": 1647454355,
      "temp": {
        "day": 277.19,
        "min": 276.21,
        "max": 280.35,
        "night": 276.21,
        "eve": 277.45,
        "morn": 280.17
      },
      "feels_like": {
        "day": 273.32,
        "night": 273.57,
        "eve": 274.5,
        "morn": 277.64
      },
      "pressure": 1017,
      "humidity": 97,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10d"
        }
      ],
      "speed": 5.98,
      "deg": 197,
      "gust": 12.39,
      "clouds": 100,
      "pop": 1,
      "rain": 11.28
    },
    {
      "dt": 1647518400,
      "sunrise": 1647497960,
      "sunset": 1647540883,
      "temp": {
        "day": 280.48,
        "min": 275.63,
        "max": 281.96,
        "night": 277.17,
        "eve": 280.4,
        "morn": 275.63
      },
      "feels_like": {
        "day": 275.95,
        "night": 274.37,
        "eve": 276.42,
        "morn": 271.27
      },
      "pressure": 1020,
      "humidity": 77,
      "weather": [
        {
          "id": 803,
          "main": "Clouds",
          "description": "broken clouds",
          "icon": "04d"
        }
      ],
      "speed": 11.13,
      "deg": 234,
      "gust": 18.4,
      "clouds": 52,
      "pop": 0
    }
  ]
}

metric


                      https://api.openweathermap.org/data/2.5/forecast/daily?lat=57&lon=-2.15&appid={API key}&units=metric

                      
{
  "city": {
    "id": 2641549,
    "name": "Newtonhill",
    "coord": {
      "lon": -2.15,
      "lat": 57
    },
    "country": "GB",
    "population": 3284,
    "timezone": 0
  },
  "cod": "200",
  "message": 18.7713997,
  "cnt": 3,
  "list": [
    {
      "dt": 1647345600,
      "sunrise": 1647325488,
      "sunset": 1647367827,
      "temp": {
        "day": 7.89,
        "min": 3.93,
        "max": 8.83,
        "night": 7.21,
        "eve": 8.08,
        "morn": 4.03
      },
      "feels_like": {
        "day": 4.06,
        "night": 3.59,
        "eve": 4.7,
        "morn": -0.13
      },
      "pressure": 1015,
      "humidity": 78,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 7.61,
      "deg": 194,
      "gust": 13.48,
      "clouds": 96,
      "pop": 0.42,
      "rain": 0.29
    },
    {
      "dt": 1647432000,
      "sunrise": 1647411724,
      "sunset": 1647454355,
      "temp": {
        "day": 4.04,
        "min": 3.06,
        "max": 7.2,
        "night": 3.06,
        "eve": 4.3,
        "morn": 7.02
      },
      "feels_like": {
        "day": 0.17,
        "night": 0.42,
        "eve": 1.35,
        "morn": 4.49
      },
      "pressure": 1017,
      "humidity": 97,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10d"
        }
      ],
      "speed": 5.98,
      "deg": 197,
      "gust": 12.39,
      "clouds": 100,
      "pop": 1,
      "rain": 11.28
    },
    {
      "dt": 1647518400,
      "sunrise": 1647497960,
      "sunset": 1647540883,
      "temp": {
        "day": 7.33,
        "min": 2.48,
        "max": 8.81,
        "night": 4.02,
        "eve": 7.25,
        "morn": 2.48
      },
      "feels_like": {
        "day": 2.8,
        "night": 1.22,
        "eve": 3.27,
        "morn": -1.88
      },
      "pressure": 1020,
      "humidity": 77,
      "weather": [
        {
          "id": 803,
          "main": "Clouds",
          "description": "broken clouds",
          "icon": "04d"
        }
      ],
      "speed": 11.13,
      "deg": 234,
      "gust": 18.4,
      "clouds": 52,
      "pop": 0
    }
  ]
}

imperial


                      https://api.openweathermap.org/data/2.5/forecast/daily?lat=57&lon=-2.15&appid={API key}&units=imperial

                      
{
  "city": {
    "id": 2641549,
    "name": "Newtonhill",
    "coord": {
      "lon": -2.15,
      "lat": 57
    },
    "country": "GB",
    "population": 3284,
    "timezone": 0
  },
  "cod": "200",
  "message": 17.7929425,
  "cnt": 3,
  "list": [
    {
      "dt": 1647345600,
      "sunrise": 1647325488,
      "sunset": 1647367827,
      "temp": {
        "day": 46.2,
        "min": 39.07,
        "max": 47.89,
        "night": 44.98,
        "eve": 46.54,
        "morn": 39.25
      },
      "feels_like": {
        "day": 39.31,
        "night": 38.46,
        "eve": 40.46,
        "morn": 31.77
      },
      "pressure": 1015,
      "humidity": 78,
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "speed": 17.02,
      "deg": 194,
      "gust": 30.15,
      "clouds": 96,
      "pop": 0.42,
      "rain": 0.29
    },
    {
      "dt": 1647432000,
      "sunrise": 1647411724,
      "sunset": 1647454355,
      "temp": {
        "day": 39.27,
        "min": 37.51,
        "max": 44.96,
        "night": 37.51,
        "eve": 39.74,
        "morn": 44.64
      },
      "feels_like": {
        "day": 32.31,
        "night": 32.76,
        "eve": 34.43,
        "morn": 40.08
      },
      "pressure": 1017,
      "humidity": 97,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10d"
        }
      ],
      "speed": 13.38,
      "deg": 197,
      "gust": 27.72,
      "clouds": 100,
      "pop": 1,
      "rain": 11.28
    },
    {
      "dt": 1647518400,
      "sunrise": 1647497960,
      "sunset": 1647540883,
      "temp": {
        "day": 45.19,
        "min": 36.46,
        "max": 47.86,
        "night": 39.24,
        "eve": 45.05,
        "morn": 36.46
      },
      "feels_like": {
        "day": 37.04,
        "night": 34.2,
        "eve": 37.89,
        "morn": 28.62
      },
      "pressure": 1020,
      "humidity": 77,
      "weather": [
        {
          "id": 803,
          "main": "Clouds",
          "description": "broken clouds",
          "icon": "04d"
        }
      ],
      "speed": 24.9,
      "deg": 234,
      "gust": 41.16,
      "clouds": 52,
      "pop": 0
    }
  ]
}

Multilingual support

You can use lang parameter to get the output in your language.

Translation is applied for the city name and description fields.

API call

https://api.openweathermap.org/data/2.5/forecast/daily?id=524901&lang={lang}

Parameters
`lang`	optional	Language code

Example of API call


                https://api.openweathermap.org/data/2.5/forecast/daily?id=524901&lang=zh_cn&appid={API key}

                
{
   "cod":"200",
   "message":0,
   "city":{
      "geoname_id":524901,
      "name":"Moscow",
      "lat":55.7522,
      "lon":37.6156,
      "country":"RU",
      "iso2":"RU",
      "type":"city",
      "population":0
   },
   "cnt":7,
   "list":[
      {
         "dt":1485766800,
         "temp":{
            "day":262.65,
            "min":261.41,
            "max":262.65,
            "night":261.41,
            "eve":262.65,
            "morn":262.65
         },
         "pressure":1024.53,
         "humidity":76,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":4.57,
         "deg":225,
         "gust": 7.74,
         "clouds":0,
         "snow":0.01
      },
      {
         "dt":1485853200,
         "temp":{
            "day":262.31,
            "min":260.98,
            "max":265.44,
            "night":265.44,
            "eve":264.18,
            "morn":261.46
         },
         "pressure":1018.1,
         "humidity":91,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":4.1,
         "deg":249,
         "gust": 7.74,
         "clouds":88,
         "snow":1.44
      },
      {
         "dt":1485939600,
         "temp":{
            "day":270.27,
            "min":266.9,
            "max":270.59,
            "night":268.06,
            "eve":269.66,
            "morn":266.9
         },
         "pressure":1010.85,
         "humidity":92,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":4.53,
         "deg":298,
         "gust": 7.74,
         "clouds":64,
         "snow":0.92
      },
      {
         "dt":1486026000,
         "temp":{
            "day":263.46,
            "min":255.19,
            "max":264.02,
            "night":255.59,
            "eve":259.68,
            "morn":263.38
         },
         "pressure":1019.32,
         "humidity":84,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":3.06,
         "deg":344,
         "gust": 7.74,
         "clouds":0
      },
      {
         "dt":1486112400,
         "temp":{
            "day":265.69,
            "min":256.55,
            "max":266,
            "night":256.55,
            "eve":260.09,
            "morn":266
         },
         "pressure":1012.2,
         "humidity":0,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":7.35,
         "deg":24,
         "gust": 7.74,
         "clouds":45,
         "snow":0.21
      },
      {
         "dt":1486198800,
         "temp":{
            "day":259.95,
            "min":254.73,
            "max":259.95,
            "night":257.13,
            "eve":254.73,
            "morn":257.02
         },
         "pressure":1029.5,
         "humidity":0,
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"sky is clear",
               "icon":"01d"
            }
         ],
         "speed":2.6,
         "deg":331,
         "gust": 7.74,
         "clouds":29
      },
      {
         "dt":1486285200,
         "temp":{
            "day":263.13,
            "min":259.11,
            "max":263.13,
            "night":262.01,
            "eve":261.32,
            "morn":259.11
         },
         "pressure":1023.21,
         "humidity":0,
         "weather":[
            {
               "id":600,
               "main":"Snow",
               "description":"light snow",
               "icon":"13d"
            }
         ],
         "speed":5.33,
         "deg":234,
         "gust": 7.74,
         "clouds":46,
         "snow":0.04
      }
   ]
}

We support the following languages that you can use with the corresponded lang values:

af Afrikaans
al Albanian
ar Arabic
az Azerbaijani
bg Bulgarian
ca Catalan
cz Czech
da Danish
de German
el Greek
en English
eu Basque
fa Persian (Farsi)
fi Finnish
fr French
gl Galician
he Hebrew
hi Hindi
hr Croatian
hu Hungarian
id Indonesian
it Italian
ja Japanese
kr Korean
la Latvian
lt Lithuanian
mk Macedonian
no Norwegian
nl Dutch
pl Polish
pt Portuguese
pt_br Português Brasil
ro Romanian
ru Russian
sv, se Swedish
sk Slovak
sl Slovenian
sp, es Spanish
sr Serbian
th Thai
tr Turkish
ua, uk Ukrainian
vi Vietnamese
zh_cn Chinese Simplified
zh_tw Chinese Traditional
zu Zulu

Call back function for JavaScript code

To use JavaScript code you can transfer callback functionName to JSONP callback.

Example of API call


                   api.openweathermap.org/data/2.5/weather?q=London,uk&callback=test&appid={API key}

                   
test(
{
 "coord":{
    "lon":-0.13,
    "lat":51.51
 },
 "weather":[
    {
       "id":300,
       "main":"Drizzle",
       "description":"light intensity drizzle",
       "icon":"09d"
    }
 ],
 "base":"stations",
 "main":{
    "temp":280.32,
    "pressure":1012,
    "humidity":81,
    "temp_min":279.15,
    "temp_max":281.15
 },
 "visibility":10000,
 "wind":{
    "speed":4.1,
    "deg":80,
    "gust":6.1
 },
 "clouds":{
    "all":90
 },
 "dt":1485789600,
 "sys":{
    "type":1,
    "id":5091,
    "message":0.0103,
    "country":"GB",
    "sunrise":1485762037,
    "sunset":1485794875
 },
 "id":2643743,
 "name":"London",
 "cod":200
}
)