<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"/>
<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"/>
<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"/>
<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"/>
<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>
5 day weather forecast
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}
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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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.
Examples of bulk files
Weather fields 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
},
"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 parametermessage
Internal parametercnt
A 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, hPalist.main.sea_level
Atmospheric pressure on the sea level, hPalist.main.grnd_level
Atmospheric pressure on the ground level, hPalist.main.humidity
Humidity, %list.main.temp_kf
Internal parameter
-
list.weather
list.weather.id
Weather condition idlist.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.visibility
Average visibility, metreslist.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.sys.pod
Part of the day (n - night, d - day)list.dt_txt
Time of data forecasted, ISO, UTC
-
city
city.id
City IDcity.name
City name-
city.coord
city.coord.lat
City geo location, latitudecity.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"/>
<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"/>
<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 IDlocation.type
Prototype parameterlocation.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 levellocation.location.latitude
City geo location, latitudelocation.location.longitude
City geo location, longitudelocation.location.geobase
Prototype parameterlocation.location.geobaseid
Prototype parameter
-
meta
meta.lastupdate
Prototype parametermeta.calctime
Speed of data calculationmeta.nextupdate
Prototype parameter
-
sun
sun.rise
Sunrise timesun.set
Sunset time
-
forecast
-
forecast.time
forecast.time.from
Beginning of the period of data forecastedforecast.time.to
End of the period of data forecasted
-
forecast.symbol
forecast.symbol.number
Weather condition idforecast.symbol.name
Weather conditionforecast.symbol.var
Weather icon id
-
forecast.precipitation
forecast.precipitation.value
Precipitation volume for the last 3 hours, mmforecast.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 secondforecast.windSpeed.name
Type of the wind
-
forecast.temperature
forecast.temperature.unit
Unit of measurements. Possilbe valure is Celsius, Kelvin, Fahrenheit.forecast.temperature.value
Temperatureforecast.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: Kelvinforecast.pressure.value
Temperature. This temperature parameter accounts for the human perception of weather.
-
forecast.pressure
forecast.pressure.unit
hPaforecast.pressure.value
Pressure value
-
forecast.humidity
forecast.humidity.unit
%forecast.humidity.value
Humidity value
-
forecast.clouds
forecast.pressure.value
Name of the cloudinessforecast.pressure.all
Cloudinessforecast.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
- 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
},
"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"/>
<gusts/>
<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 |
- 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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
},
"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
Afrikaansal
Albanianar
Arabicaz
Azerbaijanibg
Bulgarianca
Catalancz
Czechda
Danishde
Germanel
Greeken
Englisheu
Basquefa
Persian (Farsi)fi
Finnishfr
Frenchgl
Galicianhe
Hebrewhi
Hindihr
Croatianhu
Hungarianid
Indonesianit
Italianja
Japanesekr
Koreanla
Latvianlt
Lithuanianmk
Macedonianno
Norwegiannl
Dutchpl
Polishpt
Portuguesept_br
Português Brasilro
Romanianru
Russiansv, se
Swedishsk
Slovaksl
Sloveniansp, es
Spanishsr
Serbianth
Thaitr
Turkishua, uk
Ukrainianvi
Vietnamesezh_cn
Chinese Simplifiedzh_tw
Chinese Traditionalzu
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
},
"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
},
"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
},
"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
}
})