5 day weather forecast - OpenWeatherMap

5 day forecast is available at any location or city. It includes weather forecast data with 3-hour step. Forecast is available in JSON or XML format.

Call 5 day / 3 hour forecast data

By city name

You can search weather forecast for 5 days with data every 3 hours by city name. All weather data can be obtained in JSON and XML formats.

API call


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


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


                        api.openweathermap.org/data/2.5/forecast?q={city name},{state code},{country code}&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)
`mode`	optional	Response format. JSON format is used by default. To get data in XML format use `mode=xml`. Learn more
`cnt`	optional	A number of timestamps, which will be returned in the API response. 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	You can use the `lang` parameter to get the output in your language. Learn more

Examples of API calls


                           api.openweathermap.org/data/2.5/forecast?q=London,us&mode=xml&appid={API key}

                    
<weatherdata>
  <location>
   <name>London</name>
   <type/>
   <country>US</country>
   <timezone/>
   <location altitude="0" latitude="39.8865" longitude="-83.4483" 
   geobase="geonames" geobaseid="4517009"/>
  </location>
  <credit/>
  <meta>
   <lastupdate/>
   <calctime>0.0028</calctime>
   <nextupdate/>
  </meta>
  <sun rise="2017-03-03T12:03:03" set="2017-03-03T23:28:37"/>
  <forecast>
    <time from="2017-03-03T06:00:00" to="2017-03-03T09:00:00">
      <symbol number="600" name="light snow" var="13n"/>
      <precipitation unit="3h" value="0.03125" type="snow"/>
      <windDirection deg="303.004" code="WNW" 
      name="West-northwest"/>
      <windSpeed mps="2.29" name="Light breeze"/>
      <windGust gust="7.87" unit="m/s"/>
      <temperature unit="kelvin" value="269.91" min="269.91" 
      max="270.877"/>
      <pressure unit="hPa" value="1005.61"/>
      <humidity value="93" unit="%"/>
      <clouds value="scattered clouds" all="32" unit="%"/>
    </time>
    <time from="2017-03-03T09:00:00" to="2017-03-03T12:00:00">
      <symbol number="800" name="clear sky" var="01n"/>
      <precipitation unit="3h" value="0.0225" type="snow"/>
      <windDirection deg="293.503" code="WNW" 
      name="West-northwest"/>
      <windSpeed mps="3.55" name="Gentle Breeze"/>
      <windGust gust="7.87" unit="m/s"/>
      <temperature unit="kelvin" value="269.23" min="269.23" 
      max="269.957"/>
      <pressure unit="hPa" value="1007.39"/>
      <humidity value="90" unit="%"/>
      <clouds value="scattered clouds" all="36" unit="%"/>
    </time>
    <time from="2017-03-03T12:00:00" to="2017-03-03T15:00:00">
      <symbol number="800" name="clear sky" var="01d"/>
      <precipitation unit="3h" value="0.0125" type="snow"/>
      <windDirection deg="301.5" code="WNW" 
      name="West-northwest"/>
      <windSpeed mps="6.26" name="Moderate breeze"/>
      <windGust gust="7.87" unit="m/s"/>
      <temperature unit="kelvin" value="270.93" min="270.93" 
      max="271.416"/>
      <pressure unit="hPa" value="1009.81"/>
      <humidity value="100" unit="%"/>
      <clouds value="few clouds" all="24" unit="%"/>
    </time>
    ....
    <time from="2017-03-07T18:00:00" to="2017-03-07T21:00:00">
      <symbol number="804" name="overcast clouds" var="04d"/>
      <precipitation/>
      <windDirection deg="229.5" code="SW" name="Southwest"/>
      <windSpeed mps="7.46" name="Moderate breeze"/>
      <windGust gust="7.87" unit="m/s"/>
      <temperature unit="kelvin" value="288.788" min="288.788" 
      max="288.788"/>
      <pressure unit="hPa" value="993.15"/>
      <humidity value="100" unit="%"/>
      <clouds value="overcast clouds" all="88" unit="%"/>
    </time>
  </forecast>
</weatherdata>

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.

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

                          
{
   "cod":"200",
   "message":0.0032,
   "cnt":36,
   "list":[
      {
         "dt":1487246400,
         "main":{
            "temp":286.67,
            "temp_min":281.556,
            "temp_max":286.67,
            "pressure":972.73,
            "sea_level":1046.46,
            "grnd_level":972.73,
            "humidity":75,
            "temp_kf":5.11
         },
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"clear sky",
               "icon":"01d"
            }
         ],
         "clouds":{
            "all":0
         },
         "wind":{
            "speed":1.81,
            "deg":247.501,
            "gust": 7.87
         },
         "sys":{
            "pod":"d"
         },
         "dt_txt":"2017-02-16 12:00:00"
      },
      {
         "dt":1487257200,
         "main":{
            "temp":285.66,
            "temp_min":281.821,
            "temp_max":285.66,
            "pressure":970.91,
            "sea_level":1044.32,
            "grnd_level":970.91,
            "humidity":70,
            "temp_kf":3.84
         },
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"clear sky",
               "icon":"01d"
            }
         ],
         "clouds":{
            "all":0
         },
         "wind":{
            "speed":1.59,
            "deg":290.501,
            "gust": 7.87
         },
         "sys":{
            "pod":"d"
         },
         "dt_txt":"2017-02-16 15:00:00"
      },
      {
         "dt":1487268000,
         "main":{
            "temp":277.05,
            "temp_min":274.498,
            "temp_max":277.05,
            "pressure":970.44,
            "sea_level":1044.7,
            "grnd_level":970.44,
            "humidity":90,
            "temp_kf":2.56
         },
         "weather":[
            {
               "id":800,
               "main":"Clear",
               "description":"clear sky",
               "icon":"01n"
            }
         ],
         "clouds":{
            "all":0
         },
         "wind":{
            "speed":1.41,
            "deg":263.5,
            "gust": 7.87
         },
         "sys":{
            "pod":"n"
         },
         "dt_txt":"2017-02-16 18:00:00"
      },
      ....
      {
         "dt":1487624400,
         "main":{
            "temp":272.424,
            "temp_min":272.424,
            "temp_max":272.424,
            "pressure":968.38,
            "sea_level":1043.17,
            "grnd_level":968.38,
            "humidity":85,
            "temp_kf":0
         },
         "weather":[
            {
               "id":801,
               "main":"Clouds",
               "description":"few clouds",
               "icon":"02n"
            }
         ],
         "clouds":{
            "all":20
         },
         "wind":{
            "speed":3.57,
            "deg":255.503,
            "gust": 7.87
         },
         "rain":{

         },
         "snow":{

         },
         "sys":{
            "pod":"n"
         },
         "dt_txt":"2017-02-20 21:00:00"
      }
   ],
   "city":{
      "id":6940463,
      "name":"Altstadt",
      "coord":{
         "lat":48.137,
         "lon":11.5752
      },
      "country":"none"
   }
}

By city ID

You can search weather forecast for 5 days with data every 3 hours by city ID. All weather data can be obtained in JSON and XML formats.

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?id={city ID}&appid={API key}

Parameters
`id`	required	City ID. The list of city IDs 'city.list.json.gz' can be downloaded here.
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`mode`	optional	Response format. JSON format is used by default. To get data in XML format use `mode=xml`. Learn more
`cnt`	optional	A number of timestamps, which will be returned in the API response. 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	You can use the `lang` parameter to get the output in your language. Learn more

Examples of API calls


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

                      
{
  "cod": "200",
  "message": 0.0036,
  "cnt": 40,
  "list": [
    {
      "dt": 1485799200,
      "main": {
        "temp": 261.45,
        "temp_min": 259.086,
        "temp_max": 261.45,
        "pressure": 1023.48,
        "sea_level": 1045.39,
        "grnd_level": 1023.48,
        "humidity": 79,
        "temp_kf": 2.37
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "02n"
        }
      ],
      "clouds": {
        "all": 8
      },
      "wind": {
        "speed": 4.77,
        "deg": 232.505,
        "gust": 7.87
      },
      "snow": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2017-01-30 18:00:00"
    },
    {
      "dt": 1485810000,
      "main": {
        "temp": 261.41,
        "temp_min": 259.638,
        "temp_max": 261.41,
        "pressure": 1022.41,
        "sea_level": 1044.35,
        "grnd_level": 1022.41,
        "humidity": 76,
        "temp_kf": 1.78
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 32
      },
      "wind": {
        "speed": 4.76,
        "deg": 240.503,
        "gust": 7.87
      },
      "snow": {
        "3h": 0.011
      },
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2017-01-30 21:00:00"
    },
    {
      "dt": 1485820800,
      "main": {
        "temp": 261.76,
        "temp_min": 260.571,
        "temp_max": 261.76,
        "pressure": 1021.34,
        "sea_level": 1043.21,
        "grnd_level": 1021.34,
        "humidity": 84,
        "temp_kf": 1.18
      },
      "weather": [
        {
          "id": 600,
          "main": "Snow",
          "description": "light snow",
          "icon": "13n"
        }
      ],
      "clouds": {
        "all": 68
      },
      "wind": {
        "speed": 4.71,
        "deg": 243,
        "gust": 7.87
      },
      "snow": {
        "3h": 0.058
      },
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2017-01-31 00:00:00"
    },
   ....
    {
      "dt": 1486220400,
      "main": {
        "temp": 260.26,
        "temp_min": 260.26,
        "temp_max": 260.26,
        "pressure": 1021,
        "sea_level": 1042.96,
        "grnd_level": 1021,
        "humidity": 86,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 803,
          "main": "Clouds",
          "description": "broken clouds",
          "icon": "04n"
        }
      ],
      "clouds": {
        "all": 56
      },
      "wind": {
        "speed": 2.47,
        "deg": 180.501,
        "gust": 7.87
      },
      "snow": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2017-02-04 15:00:00"
    }
  ],
  "city": {
    "id": 524901,
    "name": "Moscow",
    "coord": {
      "lat": 55.7522,
      "lon": 37.6156
    },
    "country": "none"
  }
}

By geographic coordinates

You can search weather forecast for 5 days with data every 3 hours by geographic coordinates. All weather data can be obtained in JSON and XML formats.

API call


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

Parameters
`lat`, `lon`	required	Geographical coordinates (latitude, longitude)
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)
`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
`mode`	optional	Response format. JSON format is used by default. To get data in XML format use `mode=xml`. Learn more
`cnt`	optional	A number of timestamps, which will be returned in the API response. 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	You can use the `lang` parameter to get the output in your language. Learn more

Examples of API calls


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

                      
{
  "cod": "200",
  "message": 0.0082,
  "cnt": 40,
  "list": [
    {
      "dt": 1485799200,
      "main": {
        "temp": 283.76,
        "temp_min": 283.76,
        "temp_max": 283.761,
        "pressure": 1017.24,
        "sea_level": 1026.83,
        "grnd_level": 1017.24,
        "humidity": 100,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 7.27,
        "deg": 15.0048,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2017-01-30 18:00:00"
    },
    {
      "dt": 1485810000,
      "main": {
        "temp": 282.56,
        "temp_min": 282.56,
        "temp_max": 282.563,
        "pressure": 1020.06,
        "sea_level": 1029.63,
        "grnd_level": 1020.06,
        "humidity": 100,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 6.21,
        "deg": 31.5035,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2017-01-30 21:00:00"
    },
    {
      "dt": 1485820800,
      "main": {
        "temp": 282.3,
        "temp_min": 282.296,
        "temp_max": 282.3,
        "pressure": 1022.71,
        "sea_level": 1032.27,
        "grnd_level": 1022.71,
        "humidity": 100,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 6.71,
        "deg": 51.0002,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2017-01-31 00:00:00"
    },
    ....
    {
      "dt": 1486220400,
      "main": {
        "temp": 285.51,
        "temp_min": 285.51,
        "temp_max": 285.51,
        "pressure": 1016.46,
        "sea_level": 1026.16,
        "grnd_level": 1016.46,
        "humidity": 100,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 802,
          "main": "Clouds",
          "description": "scattered clouds",
          "icon": "03n"
        }
      ],
      "clouds": {
        "all": 44
      },
      "wind": {
        "speed": 2.97,
        "deg": 283.001,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2017-02-04 15:00:00"
    }
  ],
  "city": {
    "id": 1907296,
    "name": "Tawarano",
    "coord": {
      "lat": 35.0164,
      "lon": 139.0077
    },
    "country": "none"
  }
}

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?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)
`mode`	optional	Response format. JSON format is used by default. To get data in XML format use `mode=xml`. Learn more
`cnt`	optional	A number of timestamps, which will be returned in the API response. 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	You can use the `lang` parameter to get the output in your language. Learn more

Examples of API calls


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

                      
{
  "cod": "200",
  "message": 0.0122,
  "cnt": 40,
  "list": [
    {
      "dt": 1519074000,
      "main": {
        "temp": 283.99,
        "temp_min": 281.801,
        "temp_max": 283.99,
        "pressure": 989.94,
        "sea_level": 1029.29,
        "grnd_level": 989.94,
        "humidity": 52,
        "temp_kf": 2.19
      },
      "weather": [
        {
          "id": 801,
          "main": "Clouds",
          "description": "few clouds",
          "icon": "02d"
        }
      ],
      "clouds": {
        "all": 20
      },
      "wind": {
        "speed": 3.36,
        "deg": 325.001,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-02-19 21:00:00"
    },
    {
      "dt": 1519084800,
      "main": {
        "temp": 282.64,
        "temp_min": 281.177,
        "temp_max": 282.64,
        "pressure": 990.6,
        "sea_level": 1029.94,
        "grnd_level": 990.6,
        "humidity": 47,
        "temp_kf": 1.46
      },
      "weather": [
        {
          "id": 802,
          "main": "Clouds",
          "description": "scattered clouds",
          "icon": "03n"
        }
      ],
      "clouds": {
        "all": 36
      },
      "wind": {
        "speed": 3.17,
        "deg": 319.502,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-02-20 00:00:00"
    },
    {
      "dt": 1519095600,
      "main": {
        "temp": 278.3,
        "temp_min": 277.566,
        "temp_max": 278.3,
        "pressure": 992.46,
        "sea_level": 1032.01,
        "grnd_level": 992.46,
        "humidity": 53,
        "temp_kf": 0.73
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.12,
        "deg": 309.009,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-02-20 03:00:00"
    },
    ....
    {
      "dt": 1519495200,
      "main": {
        "temp": 280.831,
        "temp_min": 280.831,
        "temp_max": 280.831,
        "pressure": 997.47,
        "sea_level": 1037.05,
        "grnd_level": 997.47,
        "humidity": 91,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.01,
        "deg": 192.506,
        "gust": 7.87
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-02-24 18:00:00"
    }
  ],
  "city": {
    "name": "Mountain View",
    "coord": {
      "lat": 37.3855,
      "lon": -122.088
    },
    "country": "US"
  }
}

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 response

      
{
  "cod": "200",
  "message": 0,
  "cnt": 40,
  "list": [
    {
      "dt": 1596564000,
      "main": {
        "temp": 293.55,
        "feels_like": 293.13,
        "temp_min": 293.55,
        "temp_max": 294.05,
        "pressure": 1013,
        "sea_level": 1013,
        "grnd_level": 976,
        "humidity": 84,
        "temp_kf": -0.5
      },
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "light rain",
          "icon": "10d"
        }
      ],
      "clouds": {
        "all": 38
      },
      "wind": {
        "speed": 4.35,
        "deg": 309,
        "gust": 7.87
      },
      "visibility": 10000,
      "pop": 0.49,
      "rain": {
        "3h": 0.53
      },
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2020-08-04 18:00:00"
    },

    ...

"city": {
    "id": 2643743,
    "name": "London",
    "coord": {
      "lat": 51.5073,
      "lon": -0.1277
    },
    "country": "GB",
    "timezone": 0,
    "sunrise": 1578384285,
    "sunset": 1578413272
  }
}

Fields in API response

cod Internal parameter
message Internal parameter
cntA number of timestamps returned in the API response
list
- list.dt Time of data forecasted, unix, UTC
- list.main
  - list.main.temp Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.main.feels_like This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.main.temp_min Minimum temperature at the moment of calculation. This is minimal forecasted temperature (within large megalopolises and urban areas), use this parameter optionally. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.main.temp_max Maximum temperature at the moment of calculation. This is maximal forecasted temperature (within large megalopolises and urban areas), use this parameter optionally. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
  - list.main.pressure Atmospheric pressure on the sea level by default, hPa
  - list.main.sea_level Atmospheric pressure on the sea level, hPa
  - list.main.grnd_level Atmospheric pressure on the ground level, hPa
  - list.main.humidity Humidity, %
  - list.main.temp_kf Internal parameter
- list.weather
  - 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.clouds
  - list.clouds.all Cloudiness, %
- list.wind
  - list.wind.speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour.
  - list.wind.deg Wind direction, degrees (meteorological)
  - list.wind.gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour
- list.visibility Average visibility, metres
- list.pop Probability of precipitation
- list.rain
  - list.rain.3h Rain volume for last 3 hours, mm
- list.snow
  - list.snow.3h Snow volume for last 3 hours
- list.sys
- list.dt_txt Time of data forecasted, ISO, UTC
city
- city.id City ID
- city.name City name
- city.coord
  - city.coord.lat City geo location, latitude
  - city.coord.lon City geo location, longitude
- city.country Country code (GB, JP etc.)
- city.timezone Shift in seconds from UTC

XML


                           Example of API response

  
<weatherdata>
  <location>
    <name>London</name>
    <type/>
    <country>GB</country>
    <timezone>3600</timezone>
    <location altitude="0" latitude="51.5085" longitude="-0.1258"
    geobase="geonames" geobaseid="2643743"/>
  </location>
  <meta>...</meta>
  <sun rise="2015-06-30T10:08:46" set="2015-07-01T01:06:20"/>
  <forecast>
   <time from="2015-06-30T09:00:00" to="2015-06-30T12:00:00">
   <symbol number="500" name="light rain" var="10n"/>
   <precipitation value="5" unit="3h" type="rain"/>
   <windDirection deg="253.5" code="WSW" name="West-southwest"/>
   <windSpeed mps="4.9" name="Gentle Breeze"/>
   <windGust gust="7.87" unit="m/s"/>
   <temperature unit="celsius" value="16.89" min="16.89" max="17.375"/>
   <feels_like value="281.37" unit="kelvin"/>
   <pressure unit="hPa" value="989.51"/>
   <humidity value="96" unit="%"/>
   <clouds value="broken clouds" all="64" unit="%"/>
  </time>
   <time from="2015-06-30T12:00:00" to="2015-06-30T15:00:00">
   <symbol number="500" name="light rain" var="10d"/>
   <precipitation value="99" unit="3h" type="rain"/>
   <windDirection deg="248.001" code="WSW" name="West-southwest"/>
   <windSpeed mps="4.86" name="Gentle Breeze"/>
   <windGust gust="7.87" unit="m/s"/>
   <temperature unit="celsius" value="17.23" min="17.23" max="17.614"/>
   <pressure unit="hPa" value="991.29"/>
   <humidity value="97" unit="%"/>
   <clouds value="scattered clouds" all="44" unit="%"/>
   </time>

  ...

  </forecast>
</weatherdata>

Fields in API response

location
- location.name City ID
- location.type Prototype parameter
- location.country Country code (GB, JP etc.)
- 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 Prototype parameter
  - location.location.geobaseid Prototype parameter
meta
- meta.lastupdate Prototype parameter
- meta.calctime Speed of data calculation
- meta.nextupdate Prototype parameter
sun
- sun.rise Sunrise time
- sun.set Sunset time
forecast
- forecast.time
  - forecast.time.from Beginning of the period of data forecasted
  - forecast.time.to End of the period of 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 3 hours, mm
  - forecast.precipitation.unit Period of measurements. Possilbe value is 1 hour, 3 hours.
  - forecast.precipitation.type Type of precipitation. Possible value is rain, snow.
- forecast.windDirection
  - forecast.windDirection.deg Wind direction, degrees (meteorological)
  - forecast.windDirection.code Code of the wind direction. Possilbe 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.unit Unit of measurements. Possilbe valure is Celsius, Kelvin, Fahrenheit.
  - forecast.temperature.value Temperature
  - forecast.temperature.min Minimum temperature at the moment of calculation. This is minimal forecasted temperature (within large megalopolises and urban areas), use this parameter optionally.
  - forecast.temperature.max Maximum temperature at the moment of calculation. This is maximal forecasted temperature (within large megalopolises and urban areas), use this parameter optionally.
- forecast.feels_like
  - forecast.pressure.unit Unit of measurements. Possilbe valure is Celsius, Kelvin, Fahrenheit. Unit Default: Kelvin
  - forecast.pressure.value Temperature. This temperature parameter accounts for the human perception of weather.
- 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 weather 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 5 day / 3 hour forecast API, Hourly forecast API and Current weather API - temp_min and temp_max are optional parameters mean min / max temperature in the city at the current moment 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.
In 16 Day forecast - min and max mean maximum and minimum temperature in the day.


                           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 example of Daily Forecast Weather API response:


                           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

Format

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

Parameters
`mode`	optional	Response format. JSON format is used by default. To get data in XML format use `mode=xml`.

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": 7.4
  },
  "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

                      
<current>
  <city id="2643743" name="London">
    <coord lon="-0.13" lat="51.51"/>
    <country>GB</country>
    <sun rise="2017-01-30T07:40:36" set="2017-01-30T16:47:56"/>
  </city>
  <temperature value="280.15" min="278.15" max="281.15" unit="kelvin"/>
  <humidity value="81" unit="%"/>
  <pressure value="1012" unit="hPa"/>
  <wind>
    <speed value="4.6" name="Gentle Breeze"/>
    <direction value="90" code="E" name="East"/>
  </wind>
  <clouds value="90" name="overcast clouds"/>
  <visibility value="10000"/>
  <precipitation mode="no"/>
  <weather number="701" value="mist" icon="50d"/>
<lastupdate value="2017-01-30T15:50:00"/>
</current>

Limitation of result

To limit number of timestamps in the API response please setup cnt.

Parameters
`cnt`	optional	A number of timestamps, which will be returned in the API response.

Examples of API calls


                           api.openweathermap.org/data/2.5/find?lat=57&lon=-2.15&cnt=3&appid={API key}

                      
{
  "message": "accurate",
  "cod": "200",
  "count": 3,
  "list": [
    {
      "id": 2641549,
      "name": "Newtonhill",
      "coord": {
        "lat": 57.0333,
        "lon": -2.15
      },
      "main": {
        "temp": 275.15,
        "pressure": 1010,
        "humidity": 93,
        "temp_min": 275.15,
        "temp_max": 275.15
      },
      "dt": 1521204600,
      "wind": {
        "speed": 9.3,
        "deg": 120,
        "gust": 18
      },
      "sys": {
        "country": ""
      },
      "rain": null,
      "snow": null,
      "clouds": {
        "all": 75
      },
      "weather": [
        {
          "id": 311,
          "main": "Drizzle",
          "description": "rain and drizzle",
          "icon": "09d"
        }
      ]
    },
    {
      "id": 2636814,
      "name": "Stonehaven",
      "coord": {
        "lat": 56.9637,
        "lon": -2.2118
      },
      "main": {
        "temp": 275.15,
        "pressure": 1010,
        "humidity": 93,
        "temp_min": 275.15,
        "temp_max": 275.15
      },
      "dt": 1521204600,
      "wind": {
        "speed": 9.3,
        "deg": 120,
        "gust": 18
      },
      "sys": {
        "country": ""
      },
      "rain": null,
      "snow": null,
      "clouds": {
        "all": 75
      },
      "weather": [
        {
          "id": 311,
          "main": "Drizzle",
          "description": "rain and drizzle",
          "icon": "09d"
        }
      ]
    },
    {
      "id": 2640030,
      "name": "Portlethen",
      "coord": {
        "lat": 57.0547,
        "lon": -2.1307
      },
      "main": {
        "temp": 275.15,
        "pressure": 1010,
        "humidity": 93,
        "temp_min": 275.15,
        "temp_max": 275.15
      },
      "dt": 1521204600,
      "wind": {
        "speed": 9.3,
        "deg": 120,
        "gust": 18
      },
      "sys": {
        "country": ""
      },
      "rain": null,
      "snow": null,
      "clouds": {
        "all": 75
      },
      "weather": [
        {
          "id": 311,
          "main": "Drizzle",
          "description": "rain and drizzle",
          "icon": "09d"
        }
      ]
    }
  ]
}

Units of measurement

standard, metric, and imperial units are available.

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.

For temperature in Fahrenheit use units=imperial
For temperature in Celsius use units=metric
Temperature in Kelvin is used by default, no need to use units parameter in API call

List of all API parameters with units openweathermap.org/weather-data

Examples of API calls

Standard


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

                      
{
  "message": "accurate",
  "cod": "200",
  "count": 1,
  "list": [
    {
      "id": 2643743,
      "name": "London",
      "coord": {
        "lat": 51.5085,
        "lon": -0.1258
      },
      "main": {
        "temp": 280.15,
        "pressure": 1012,
        "humidity": 81,
        "temp_min": 278.15,
        "temp_max": 281.15
      },
      "dt": 1485791400,
      "wind": {
        "speed": 4.6,
        "deg": 90,
        "gust": 90
      },
      "sys": {
        "country": "GB"
      },
      "rain": null,
      "snow": null,
      "clouds": {
        "all": 90
      },
      "weather": [
        {
          "id": 701,
          "main": "Mist",
          "description": "mist",
          "icon": "50d"
        },
        {
          "id": 300,
          "main": "Drizzle",
          "description": "light intensity drizzle",
          "icon": "09d"
        }
      ]
    }
  ]
}

Metric


                           api.openweathermap.org/data/2.5/find?q=London&units=metric

                      
{
  "message": "accurate",
  "cod": "200",
  "count": 1,
  "list": [
    {
      "id": 2643743,
      "name": "London",
      "coord": {
        "lat": 51.5085,
        "lon": -0.1258
      },
      "main": {
        "temp": 7,
        "pressure": 1012,
        "humidity": 81,
        "temp_min": 5,
        "temp_max": 8
      },
      "dt": 1485791400,
      "wind": {
        "speed": 4.6,
        "deg": 90,
        "gust": 4.9
      },
      "sys": {
        "country": "GB"
      },
      "rain": null,
      "snow": null,
      "clouds": {
        "all": 90
      },
      "weather": [
        {
          "id": 701,
          "main": "Mist",
          "description": "mist",
          "icon": "50d"
        },
        {
          "id": 300,
          "main": "Drizzle",
          "description": "light intensity drizzle",
          "icon": "09d"
        }
      ]
    }
  ]
}

Imperial


                           api.openweathermap.org/data/2.5/find?q=London&units=imperial

                      
{
  "message": "accurate",
  "cod": "200",
  "count": 1,
  "list": [
    {
      "id": 2643743,
      "name": "London",
      "coord": {
        "lat": 51.5085,
        "lon": -0.1258
      },
      "main": {
        "temp": 7,
        "pressure": 1012,
        "humidity": 81,
        "temp_min": 5,
        "temp_max": 8
      },
      "dt": 1485791400,
      "wind": {
        "speed": 4.6,
        "deg": 90,
        "gust": 6.5
      },
      "sys": {
        "country": "GB"
      },
      "rain": null,
      "snow": null,
      "clouds": {
        "all": 90
      },
      "weather": [
        {
          "id": 701,
          "main": "Mist",
          "description": "mist",
          "icon": "50d"
        },
        {
          "id": 300,
          "main": "Drizzle",
          "description": "light intensity drizzle",
          "icon": "09d"
        }
      ]
    }
  ]
}

Multilingual support

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

Translation is applied to the city name and description fields.

API call


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

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

Examples of API calls


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

                      
{
  "cod": "200",
  "message": 0.0119,
  "cnt": 40,
  "list": [
    {
      "dt": 1534852800,
      "main": {
        "temp": 290.19,
        "temp_min": 290.19,
        "temp_max": 291.928,
        "pressure": 999.46,
        "sea_level": 1018.59,
        "grnd_level": 999.46,
        "humidity": 97,
        "temp_kf": -1.74
      },
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "中雨",
          "icon": "10d"
        }
      ],
      "clouds": {
        "all": 92
      },
      "wind": {
        "speed": 5.01,
        "deg": 252.501,
        "gust": 9.6
      },
      "rain": {
        "3h": 8.56
      },
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-21 12:00:00"
    },
    {
      "dt": 1534863600,
      "main": {
        "temp": 288.67,
        "temp_min": 288.67,
        "temp_max": 289.834,
        "pressure": 999.9,
        "sea_level": 1019.25,
        "grnd_level": 999.9,
        "humidity": 96,
        "temp_kf": -1.16
      },
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "小雨",
          "icon": "10d"
        }
      ],
      "clouds": {
        "all": 92
      },
      "wind": {
        "speed": 4.36,
        "deg": 278.003,
        "gust": 4.6
      },
      "rain": {
        "3h": 1.76
      },
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-21 15:00:00"
    },
    {
      "dt": 1534874400,
      "main": {
        "temp": 286.65,
        "temp_min": 286.65,
        "temp_max": 287.227,
        "pressure": 1001.68,
        "sea_level": 1021.04,
        "grnd_level": 1001.68,
        "humidity": 92,
        "temp_kf": -0.58
      },
      "weather": [
        {
          "id": 500,
          "main": "Rain",
          "description": "小雨",
          "icon": "10n"
        }
      ],
      "clouds": {
        "all": 12
      },
      "wind": {
        "speed": 4.81,
        "deg": 286.007,
        "gust": 10.6
      },
      "rain": {
        "3h": 0.21
      },
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-21 18:00:00"
    },
    {
      "dt": 1534885200,
      "main": {
        "temp": 285.533,
        "temp_min": 285.533,
        "temp_max": 285.533,
        "pressure": 1002.95,
        "sea_level": 1022.41,
        "grnd_level": 1002.95,
        "humidity": 87,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 4.66,
        "deg": 297.001,
        "gust": 8.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-21 21:00:00"
    },
    {
      "dt": 1534896000,
      "main": {
        "temp": 283.811,
        "temp_min": 283.811,
        "temp_max": 283.811,
        "pressure": 1004.14,
        "sea_level": 1023.75,
        "grnd_level": 1004.14,
        "humidity": 90,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 4.21,
        "deg": 293.001,
        "gust": 4.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-22 00:00:00"
    },
    {
      "dt": 1534906800,
      "main": {
        "temp": 283.338,
        "temp_min": 283.338,
        "temp_max": 283.338,
        "pressure": 1005.48,
        "sea_level": 1025.11,
        "grnd_level": 1005.48,
        "humidity": 90,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 4.71,
        "deg": 295.504,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-22 03:00:00"
    },
    {
      "dt": 1534917600,
      "main": {
        "temp": 286.376,
        "temp_min": 286.376,
        "temp_max": 286.376,
        "pressure": 1007.05,
        "sea_level": 1026.57,
        "grnd_level": 1007.05,
        "humidity": 87,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 801,
          "main": "Clouds",
          "description": "晴，少云",
          "icon": "02d"
        }
      ],
      "clouds": {
        "all": 24
      },
      "wind": {
        "speed": 5.56,
        "deg": 305.001,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-22 06:00:00"
    },
    {
      "dt": 1534928400,
      "main": {
        "temp": 288.105,
        "temp_min": 288.105,
        "temp_max": 288.105,
        "pressure": 1008.46,
        "sea_level": 1027.89,
        "grnd_level": 1008.46,
        "humidity": 79,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 802,
          "main": "Clouds",
          "description": "多云",
          "icon": "03d"
        }
      ],
      "clouds": {
        "all": 32
      },
      "wind": {
        "speed": 5.86,
        "deg": 307.001,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-22 09:00:00"
    },
    {
      "dt": 1534939200,
      "main": {
        "temp": 289.193,
        "temp_min": 289.193,
        "temp_max": 289.193,
        "pressure": 1009.62,
        "sea_level": 1029.07,
        "grnd_level": 1009.62,
        "humidity": 68,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 802,
          "main": "Clouds",
          "description": "多云",
          "icon": "03d"
        }
      ],
      "clouds": {
        "all": 32
      },
      "wind": {
        "speed": 5.92,
        "deg": 304.001,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-22 12:00:00"
    },
    {
      "dt": 1534950000,
      "main": {
        "temp": 288.757,
        "temp_min": 288.757,
        "temp_max": 288.757,
        "pressure": 1010.72,
        "sea_level": 1030.23,
        "grnd_level": 1010.72,
        "humidity": 61,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 5.22,
        "deg": 306.508,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-22 15:00:00"
    },
    {
      "dt": 1534960800,
      "main": {
        "temp": 285.994,
        "temp_min": 285.994,
        "temp_max": 285.994,
        "pressure": 1012.51,
        "sea_level": 1032.18,
        "grnd_level": 1012.51,
        "humidity": 64,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 801,
          "main": "Clouds",
          "description": "晴，少云",
          "icon": "02n"
        }
      ],
      "clouds": {
        "all": 12
      },
      "wind": {
        "speed": 3.97,
        "deg": 319.501,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-22 18:00:00"
    },
    {
      "dt": 1534971600,
      "main": {
        "temp": 283.83,
        "temp_min": 283.83,
        "temp_max": 283.83,
        "pressure": 1013.8,
        "sea_level": 1033.67,
        "grnd_level": 1013.8,
        "humidity": 69,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.77,
        "deg": 311.002,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-22 21:00:00"
    },
    {
      "dt": 1534982400,
      "main": {
        "temp": 280.79,
        "temp_min": 280.79,
        "temp_max": 280.79,
        "pressure": 1015.15,
        "sea_level": 1035.12,
        "grnd_level": 1015.15,
        "humidity": 87,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.62,
        "deg": 278.504,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-23 00:00:00"
    },
    {
      "dt": 1534993200,
      "main": {
        "temp": 279.927,
        "temp_min": 279.927,
        "temp_max": 279.927,
        "pressure": 1016.1,
        "sea_level": 1036.23,
        "grnd_level": 1016.1,
        "humidity": 84,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.51,
        "deg": 260.001,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-23 03:00:00"
    },
    {
      "dt": 1535004000,
      "main": {
        "temp": 288.022,
        "temp_min": 288.022,
        "temp_max": 288.022,
        "pressure": 1016.9,
        "sea_level": 1036.59,
        "grnd_level": 1016.9,
        "humidity": 69,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.91,
        "deg": 271.501,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-23 06:00:00"
    },
    {
      "dt": 1535014800,
      "main": {
        "temp": 291.545,
        "temp_min": 291.545,
        "temp_max": 291.545,
        "pressure": 1016.57,
        "sea_level": 1036.13,
        "grnd_level": 1016.57,
        "humidity": 63,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 3.01,
        "deg": 273,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-23 09:00:00"
    },
    {
      "dt": 1535025600,
      "main": {
        "temp": 292.897,
        "temp_min": 292.897,
        "temp_max": 292.897,
        "pressure": 1016.07,
        "sea_level": 1035.55,
        "grnd_level": 1016.07,
        "humidity": 57,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 3.47,
        "deg": 273.009,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-23 12:00:00"
    },
    {
      "dt": 1535036400,
      "main": {
        "temp": 292.581,
        "temp_min": 292.581,
        "temp_max": 292.581,
        "pressure": 1015.32,
        "sea_level": 1034.86,
        "grnd_level": 1015.32,
        "humidity": 52,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.91,
        "deg": 269.501,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-23 15:00:00"
    },
    {
      "dt": 1535047200,
      "main": {
        "temp": 287.309,
        "temp_min": 287.309,
        "temp_max": 287.309,
        "pressure": 1015.46,
        "sea_level": 1035.23,
        "grnd_level": 1015.46,
        "humidity": 62,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.71,
        "deg": 244.502,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-23 18:00:00"
    },
    {
      "dt": 1535058000,
      "main": {
        "temp": 284.037,
        "temp_min": 284.037,
        "temp_max": 284.037,
        "pressure": 1015.87,
        "sea_level": 1035.68,
        "grnd_level": 1015.87,
        "humidity": 81,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.76,
        "deg": 235.002,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-23 21:00:00"
    },
    {
      "dt": 1535068800,
      "main": {
        "temp": 281.757,
        "temp_min": 281.757,
        "temp_max": 281.757,
        "pressure": 1016.1,
        "sea_level": 1036.03,
        "grnd_level": 1016.1,
        "humidity": 85,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.86,
        "deg": 213.006,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-24 00:00:00"
    },
    {
      "dt": 1535079600,
      "main": {
        "temp": 282.04,
        "temp_min": 282.04,
        "temp_max": 282.04,
        "pressure": 1016.15,
        "sea_level": 1036.16,
        "grnd_level": 1016.15,
        "humidity": 87,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.12,
        "deg": 208.503,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-24 03:00:00"
    },
    {
      "dt": 1535090400,
      "main": {
        "temp": 290.889,
        "temp_min": 290.889,
        "temp_max": 290.889,
        "pressure": 1016.12,
        "sea_level": 1035.76,
        "grnd_level": 1016.12,
        "humidity": 64,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.96,
        "deg": 215.001,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-24 06:00:00"
    },
    {
      "dt": 1535101200,
      "main": {
        "temp": 294.577,
        "temp_min": 294.577,
        "temp_max": 294.577,
        "pressure": 1015.45,
        "sea_level": 1034.81,
        "grnd_level": 1015.45,
        "humidity": 57,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 3.21,
        "deg": 223,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-24 09:00:00"
    },
    {
      "dt": 1535112000,
      "main": {
        "temp": 295.792,
        "temp_min": 295.792,
        "temp_max": 295.792,
        "pressure": 1014.39,
        "sea_level": 1033.87,
        "grnd_level": 1014.39,
        "humidity": 49,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 3.48,
        "deg": 227.5,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-24 12:00:00"
    },
    {
      "dt": 1535122800,
      "main": {
        "temp": 295.236,
        "temp_min": 295.236,
        "temp_max": 295.236,
        "pressure": 1013.53,
        "sea_level": 1032.87,
        "grnd_level": 1013.53,
        "humidity": 44,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.42,
        "deg": 226.501,
        "gust": 6.6
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-24 15:00:00"
    },
    {
      "dt": 1535133600,
      "main": {
        "temp": 287.35,
        "temp_min": 287.35,
        "temp_max": 287.35,
        "pressure": 1013.15,
        "sea_level": 1032.79,
        "grnd_level": 1013.15,
        "humidity": 71,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.17,
        "deg": 195,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-24 18:00:00"
    },
    {
      "dt": 1535144400,
      "main": {
        "temp": 283.65,
        "temp_min": 283.65,
        "temp_max": 283.65,
        "pressure": 1013.01,
        "sea_level": 1032.71,
        "grnd_level": 1013.01,
        "humidity": 76,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.15,
        "deg": 113.003,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-24 21:00:00"
    },
    {
      "dt": 1535155200,
      "main": {
        "temp": 283.05,
        "temp_min": 283.05,
        "temp_max": 283.05,
        "pressure": 1012.86,
        "sea_level": 1032.66,
        "grnd_level": 1012.86,
        "humidity": 69,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.23,
        "deg": 119.008,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-25 00:00:00"
    },
    {
      "dt": 1535166000,
      "main": {
        "temp": 283.376,
        "temp_min": 283.376,
        "temp_max": 283.376,
        "pressure": 1013.08,
        "sea_level": 1032.86,
        "grnd_level": 1013.08,
        "humidity": 60,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 3.31,
        "deg": 154.001,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-25 03:00:00"
    },
    {
      "dt": 1535176800,
      "main": {
        "temp": 292.886,
        "temp_min": 292.886,
        "temp_max": 292.886,
        "pressure": 1013.34,
        "sea_level": 1032.82,
        "grnd_level": 1013.34,
        "humidity": 50,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.58,
        "deg": 176.001,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-25 06:00:00"
    },
    {
      "dt": 1535187600,
      "main": {
        "temp": 297.582,
        "temp_min": 297.582,
        "temp_max": 297.582,
        "pressure": 1013.07,
        "sea_level": 1032.44,
        "grnd_level": 1013.07,
        "humidity": 45,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 3.47,
        "deg": 182.003,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-25 09:00:00"
    },
    {
      "dt": 1535198400,
      "main": {
        "temp": 299.17,
        "temp_min": 299.17,
        "temp_max": 299.17,
        "pressure": 1012.37,
        "sea_level": 1031.66,
        "grnd_level": 1012.37,
        "humidity": 36,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 4.02,
        "deg": 196.004,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-25 12:00:00"
    },
    {
      "dt": 1535209200,
      "main": {
        "temp": 298.365,
        "temp_min": 298.365,
        "temp_max": 298.365,
        "pressure": 1011.66,
        "sea_level": 1030.97,
        "grnd_level": 1011.66,
        "humidity": 34,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 2.66,
        "deg": 197.002,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-25 15:00:00"
    },
    {
      "dt": 1535220000,
      "main": {
        "temp": 289.844,
        "temp_min": 289.844,
        "temp_max": 289.844,
        "pressure": 1011.76,
        "sea_level": 1031.34,
        "grnd_level": 1011.76,
        "humidity": 59,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "01n"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 1.56,
        "deg": 170.501,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-25 18:00:00"
    },
    {
      "dt": 1535230800,
      "main": {
        "temp": 285.594,
        "temp_min": 285.594,
        "temp_max": 285.594,
        "pressure": 1012.22,
        "sea_level": 1031.88,
        "grnd_level": 1012.22,
        "humidity": 66,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "02n"
        }
      ],
      "clouds": {
        "all": 8
      },
      "wind": {
        "speed": 1.16,
        "deg": 147.009,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-25 21:00:00"
    },
    {
      "dt": 1535241600,
      "main": {
        "temp": 284.763,
        "temp_min": 284.763,
        "temp_max": 284.763,
        "pressure": 1012.77,
        "sea_level": 1032.52,
        "grnd_level": 1012.77,
        "humidity": 58,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "02n"
        }
      ],
      "clouds": {
        "all": 8
      },
      "wind": {
        "speed": 2.46,
        "deg": 145,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2018-08-26 00:00:00"
    },
    {
      "dt": 1535252400,
      "main": {
        "temp": 285.566,
        "temp_min": 285.566,
        "temp_max": 285.566,
        "pressure": 1013.52,
        "sea_level": 1033.21,
        "grnd_level": 1013.52,
        "humidity": 56,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "02d"
        }
      ],
      "clouds": {
        "all": 8
      },
      "wind": {
        "speed": 2.66,
        "deg": 147.002,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-26 03:00:00"
    },
    {
      "dt": 1535263200,
      "main": {
        "temp": 294.371,
        "temp_min": 294.371,
        "temp_max": 294.371,
        "pressure": 1013.93,
        "sea_level": 1033.5,
        "grnd_level": 1013.93,
        "humidity": 45,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "02d"
        }
      ],
      "clouds": {
        "all": 8
      },
      "wind": {
        "speed": 1.96,
        "deg": 150.002,
        "gust": 4.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-26 06:00:00"
    },
    {
      "dt": 1535274000,
      "main": {
        "temp": 300.013,
        "temp_min": 300.013,
        "temp_max": 300.013,
        "pressure": 1014,
        "sea_level": 1033.37,
        "grnd_level": 1014,
        "humidity": 40,
        "temp_kf": 0
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "晴",
          "icon": "02d"
        }
      ],
      "clouds": {
        "all": 8
      },
      "wind": {
        "speed": 3.16,
        "deg": 166.008,
        "gust": 5.3
      },
      "rain": {},
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2018-08-26 09:00:00"
    }
  ],
  "city": {
    "id": 524901,
    "name": "Moscow",
    "coord": {
      "lat": 55.7522,
      "lon": 37.6156
    },
    "country": "RU"
  }
}

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.

Examples of API calls


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

                      
test({
  "cod": "200",
  "message": 0,
  "cnt": 3,
  "list": [
    {
      "dt": 1599760800,
      "main": {
        "temp": 66.09,
        "feels_like": 61.48,
        "temp_min": 64.67,
        "temp_max": 66.09,
        "pressure": 1021,
        "sea_level": 1020,
        "grnd_level": 1017,
        "humidity": 44,
        "temp_kf": 0.79
      },
      "weather": [
        {
          "id": 802,
          "main": "Clouds",
          "description": "多云",
          "icon": "03d"
        }
      ],
      "clouds": {
        "all": 37
      },
      "wind": {
        "speed": 5.53,
        "deg": 314,
        "gust": 8.3
      },
      "visibility": 10000,
      "pop": 0,
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2020-09-10 18:00:00"
    },
    {
      "dt": 1599771600,
      "main": {
        "temp": 61.43,
        "feels_like": 57.49,
        "temp_min": 59.77,
        "temp_max": 61.43,
        "pressure": 1021,
        "sea_level": 1021,
        "grnd_level": 1018,
        "humidity": 54,
        "temp_kf": 0.92
      },
      "weather": [
        {
          "id": 801,
          "main": "Clouds",
          "description": "晴，少云",
          "icon": "02n"
        }
      ],
      "clouds": {
        "all": 22
      },
      "wind": {
        "speed": 4.76,
        "deg": 15,
        "gust": 5.3
      },
      "visibility": 10000,
      "pop": 0,
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2020-09-10 21:00:00"
    },
    {
      "dt": 1599782400,
      "main": {
        "temp": 59.18,
        "feels_like": 56.8,
        "temp_min": 58.62,
        "temp_max": 59.18,
        "pressure": 1019,
        "sea_level": 1019,
        "grnd_level": 1016,
        "humidity": 57,
        "temp_kf": 0.31
      },
      "weather": [
        {
          "id": 802,
          "main": "Clouds",
          "description": "多云",
          "icon": "03n"
        }
      ],
      "clouds": {
        "all": 46
      },
      "wind": {
        "speed": 1.74,
        "deg": 106,
        "gust": 5.3
      },
      "visibility": 10000,
      "pop": 0,
      "sys": {
        "pod": "n"
      },
      "dt_txt": "2020-09-11 00:00:00"
    }
  ],
  "city": {
    "id": 2643743,
    "name": "London",
    "coord": {
      "lat": 51.5085,
      "lon": -0.1257
    },
    "country": "GB",
    "population": 1000000,
    "timezone": 3600,
    "sunrise": 1599715685,
    "sunset": 1599762420
  }
})