16 day forecasts is available at any location or city. Forecasts include daily weather and available in JSON or XML format.
There is a possibility to receive a central district of the city/town with its own parameters (geographic coordinates/id/name) in API response. Example
q city name and country code divided by comma, use ISO 3166 country codes
cnt number of days returned (from 1 to 16)
You can seach 16 day weather forecast with daily average parameters by city ID. API responds with exact result. All weather data can be obtained in JSON and XML format.
List of city ID city.list.json.gz can be downloaded here http://bulk.openweathermap.org/sample/
We recommend to call API by city ID to get unambiguous result for your city.
id city ID
cnt number of days returned (from 1 to 16)
lat, lon coordinates of the location of your interest
cnt number of days returned (from 1 to 16)
Please note if country is not specified then the search works for USA as a default.
zip zip code
api.openweathermap.org/data/2.5/forecast/daily?zip=94040,us
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.
If you do not see some of the parameters in your API respond 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 respond.
{"cod":"200","message":0.0032,
"city":{"id":1851632,"name":"Shuzenji",
"coord":{"lon":138.933334,"lat":34.966671},
"country":"JP"},
"cnt":10,
"list":[{
"dt":1406080800,
"temp":{
"day":297.77,
"min":293.52,
"max":297.77,
"night":293.52,
"eve":297.77,
"morn":297.77},
"pressure":925.04,
"humidity":76,
"weather":[{"id":803,"main":"Clouds","description":"broken clouds","icon":"04d"}],}
]}
city
city.id City IDcity.name City namecity.coord
city.coord.lat City geo location, latitudecity.coord.lon City geo location, longitudecity.country Country code (GB, JP etc.)cod Internal parametermessage Internal parametercnt Number of lines returned by this API calllist
list.dt Time of data forecastedlist.temp
list.temp.day Day temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.list.temp.min Min daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.list.temp.max Max daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.list.temp.night Night temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.list.temp.eve Evening temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.list.temp.morn Morning temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.list.pressure Atmospheric pressure on the sea level, hPalist.humidity Humidity, %list.weather (more info Weather condition codes)
list.weather.id Weather condition idlist.weather.main Group of weather parameters (Rain, Snow, Extreme etc.)list.weather.description Weather condition within the grouplist.weather.icon Weather icon idlist.speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour.list.deg Wind direction, degrees (meteorological)list.clouds Cloudiness, %
<weatherdata>
<location>
<name>London</name>
<type/>
<country>GB</country>
<timezone/>
<location altitude="0" latitude="51.50853" longitude="-0.12574" geobase="geonames" geobaseid="0"/>
</location>
<credit/>
<meta>
<lastupdate/>
<calctime>0.0091</calctime>
<nextupdate/>
</meta>
<sun rise="2015-06-04T03:46:26" set="2015-06-04T20:11:17"/>
<forecast>
<time day="2015-06-04">
<symbol number="802" name="scattered clouds" var="03d"/>
<precipitation/>
<windDirection deg="148" code="SSE" name="South-southeast"/>
<windSpeed mps="5.12" name="Gentle Breeze"/>
<temperature day="23.65" min="17.27" max="23.74" night="17.27" eve="22.94" morn="17.54"/>
<pressure unit="hPa" value="1032.24"/>
<humidity value="70" unit="%"/>
<clouds value="scattered clouds" all="36" unit="%"/>
</time>
</forecast>
</weatherdata>
location
location.name City IDlocation.type Prototype parameterlocation.country Country code (GB, JP etc.)location.timezone Prototype parameterlocation.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 parametermeta
meta.lastupdate Prototype parameter meta.calctime Speed of data calculation meta.nextupdate Prototype parametersun
sun.rise Sunrise timesun.set Sunset timeforecast
forecast.time
forecast.time.day Date of weather data forecastedforecast.symbol
forecast.symbol.number Weather condition idforecast.symbol.name Weather conditionforecast.symbol.var Weather icon idforecast.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, mpsforecast.windSpeed.name Type of the windforecast.temperature
forecast.temperature.day Day temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.forecast.temperature.min Min daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.forecast.temperature.max Max daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.forecast.temperature.night Night temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.forecast.temperature.eve Evening temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.forecast.temperature.morn Morning temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.forecast.pressure
forecast.pressure.unit hPaforecast.pressure.value Pressure valueforecast.humidity
forecast.humidity.unit %forecast.humidity.value Humidity valueforecast.clouds
forecast.pressure.value Name of the cloudinessforecast.pressure.all Cloudinessforecast.pressure.unit %List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere including extreme conditions like tornado, hurricane etc.)
Please, do not confuse min/max parameters in current weather API and forecast API. In current weather API temp_min and temp_max are optional parameters mean min / max temperature in the city at the current moment to see deviation from current temp just for your reference. For large cities and megalopolises geographically expanded it might be applicable. In most cases both temp_min and temp_max parameters have the same volume as 'temp'. Please, use temp_min and temp_max parameters in current weather API optionally.
"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
},
"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
JSON format is used by default. To get data in XML format just set up mode = xml.
JSON api.openweathermap.org/data/2.5/weather?q=London
XML api.openweathermap.org/data/2.5/weather?q=London&mode=xml
You can use our geocoding system to find cities by name, country, zip-code or geographic coordinates. You can call also by part of the city name. To make the result more accurate just put the city name and country divided by comma.
To set the accuracy level either use the 'accurate' or 'like' type parameter.
'accurate' returns exact match values. 'like' returns results by searching for
that substring.
like close result
accurate accurate result
Like api.openweathermap.org/data/2.5/find?q=London&type=like&mode=xml
Accurate api.openweathermap.org/data/2.5/find?q=London&type=accurate&mode=xml
To limit number of listed cities please setup 'cnt' parameter that specifies the number of lines returned.
cnt=3 api.openweathermap.org/data/2.5/find?lat=57&lon=-2.15&cnt=3
Standard, metric, and imperial units are available.
units metric, imperial. When you do not use units parameter, format is Standard by default.
Temperature is available in Fahrenheit, Celsius and Kelvin units.
List of all API parameters with units openweathermap.org/weather-data
standard api.openweathermap.org/data/2.5/find?q=London
metric api.openweathermap.org/data/2.5/find?q=London&units=metric
imperial api.openweathermap.org/data/2.5/find?q=London&units=imperial
You can use lang parameter to get the output in your language. We support the following languages that you can use with the corresponded lang values:
Arabic - ar, Bulgarian - bg, Catalan - ca, Czech - cz, German - de, Greek - el, English - en, Persian (Farsi) - fa, Finnish - fi, French - fr, Galician - gl, Croatian - hr, Hungarian - hu, Italian - it, Japanese - ja, Korean - kr, Latvian - la, Lithuanian - lt, Macedonian - mk, Dutch - nl, Polish - pl, Portuguese - pt, Romanian - ro, Russian - ru, Swedish - se, Slovak - sk, Slovenian - sl, Spanish - es, Turkish - tr, Ukrainian - ua, Vietnamese - vi, Chinese Simplified - zh_cn, Chinese Traditional - zh_tw.
NOTE: Translation is only applied for the "description" field.
To use JavaScript code you can transfer callback functionName to JSONP callback.