{
"lat": 39.31,
"lon": -74.5,
"timezone": "America/New_York",
"timezone_offset": -18000,
"current": {
"dt": 1646318698,
"sunrise": 1646306882,
"sunset": 1646347929,
"temp": 282.21,
"feels_like": 278.41,
"pressure": 1014,
"humidity": 65,
"dew_point": 275.99,
"uvi": 2.55,
"clouds": 40,
"visibility": 10000,
"wind_speed": 8.75,
"wind_deg": 360,
"wind_gust": 13.89,
"weather": [
{
"id": 802,
"main": "Clouds",
"description": "scattered clouds",
"icon": "03d"
}
]
},
"minutely": [
{
"dt": 1646318700,
"precipitation": 0
},
...
},
"hourly": [
{
"dt": 1646316000,
"temp": 281.94,
"feels_like": 278.49,
"pressure": 1014,
"humidity": 67,
"dew_point": 276.16,
"uvi": 1.49,
"clouds": 52,
"visibility": 10000,
"wind_speed": 7.16,
"wind_deg": 313,
"wind_gust": 10.71,
"weather": [
{
"id": 803,
"main": "Clouds",
"description": "broken clouds",
"icon": "04d"
}
],
"pop": 0.03
},
...
}
"daily": [
{
"dt": 1646326800,
"sunrise": 1646306882,
"sunset": 1646347929,
"moonrise": 1646309880,
"moonset": 1646352120,
"moon_phase": 0.03,
"temp": {
"day": 281.63,
"min": 271.72,
"max": 282.21,
"night": 271.72,
"eve": 277.99,
"morn": 280.92
},
"feels_like": {
"day": 277.83,
"night": 264.72,
"eve": 273.35,
"morn": 277.66
},
"pressure": 1016,
"humidity": 55,
"dew_point": 273.12,
"wind_speed": 9.29,
"wind_deg": 3,
"wind_gust": 16.48,
"weather": [
{
"id": 500,
"main": "Rain",
"description": "light rain",
"icon": "10d"
}
],
"clouds": 49,
"pop": 0.25,
"rain": 0.11,
"uvi": 3.38
},
...
},
"alerts": [
{
"sender_name": "NWS Philadelphia - Mount Holly (New Jersey, Delaware, Southeastern Pennsylvania)",
"event": "Small Craft Advisory",
"start": 1646344800,
"end": 1646380800,
"description": "...SMALL CRAFT ADVISORY REMAINS IN EFFECT FROM 5 PM THIS\nAFTERNOON TO 3 AM EST FRIDAY...\n* WHAT...North winds 15 to 20 kt with gusts up to 25 kt and seas\n3 to 5 ft expected.\n* WHERE...Coastal waters from Little Egg Inlet to Great Egg\nInlet NJ out 20 nm, Coastal waters from Great Egg Inlet to\nCape May NJ out 20 nm and Coastal waters from Manasquan Inlet\nto Little Egg Inlet NJ out 20 nm.\n* WHEN...From 5 PM this afternoon to 3 AM EST Friday.\n* IMPACTS...Conditions will be hazardous to small craft.",
"tags": [
]
},
...
]
One Call API 3.0
Make just one API call and get all your essential weather data for a specific location with our new OpenWeather One Call API 3.0.
Easy migration from the Dark Sky API.
The One Call API provides the following weather data for any geographical coordinates:
- Current weather
- Minute forecast for 1 hour
- Hourly forecast for 48 hours
- Daily forecast for 8 days
- National weather alerts
- Historical weather data for 40+ years back (since January 1, 1979)
Please note, that One Call API 3.0 is included in the "One Call by Call" subscription only. This separate subscription includes 1,000 calls/day for free and allows you to pay only for the number of API calls made to this product. Please find more details on the pricing page and FAQ.
Current and forecast weather data
To get access to current weather, minute forecast for 1 hour, hourly forecast for 48 hours, daily forecast for 8 days and government weather alerts, please use this section of the documentation.
If you are interested in historical weather data, please read the "Historical weather data" section.
How to make an API call
API call
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&exclude={part}&appid={API key}
Parameters | ||
---|---|---|
lat, lon |
required | Geographical coordinates (latitude, longitude). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API. |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
exclude |
optional | By using this parameter you can exclude some parts of the weather data from the API response. It should be a comma-delimited list (without spaces).
Available values:
|
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 |
Example of API call
Before making an API call, please note, that One Call 3.0 is included in the "One Call by Call" subscription only. Learn more
https://api.openweathermap.org/data/3.0/onecall?lat=33.44&lon=-94.04&exclude=hourly,daily&appid={API key}
Example of API response
Example of API response
Fields in API response
lat
Geographical coordinates of the location (latitude)lon
Geographical coordinates of the location (longitude)timezone
Timezone name for the requested locationtimezone_offset
Shift in seconds from UTCcurrent
Current weather data API responsecurrent.dt
Current time, Unix, UTCcurrent.sunrise
Sunrise time, Unix, UTCcurrent.sunset
Sunset time, Unix, UTCcurrent.temp
Temperature. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedcurrent.feels_like
Temperature. This temperature parameter accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.current.pressure
Atmospheric pressure on the sea level, hPacurrent.humidity
Humidity, %current.dew_point
Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.current.clouds
Cloudiness, %current.uvi
Current UV indexcurrent.visibility
Average visibility, metres. The maximum value of the visibility is 10kmcurrent.wind_speed
Wind speed. Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units usedcurrent.wind_gust
(where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units usedcurrent.wind_deg
Wind direction, degrees (meteorological)current.rain
current.rain.1h
(where available) Precipitation, mm/hcurrent.snow
current.snow.1h
(where available) Precipitation, mm/h-
current.weather
current.weather.id
Weather condition idcurrent.weather.main
Group of weather parameters (Rain, Snow, Extreme etc.)current.weather.description
Weather condition within the group (full list of weather conditions). Get the output in your languagecurrent.weather.icon
Weather icon id. How to get icons
minutely
Minute forecast weather data API responseminutely.dt
Time of the forecasted data, unix, UTCminutely.precipitation
Precipitation, mm/hhourly
Hourly forecast weather data API responsehourly.dt
Time of the forecasted data, Unix, UTChourly.temp
Temperature. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedhourly.feels_like
Temperature. This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.hourly.pressure
Atmospheric pressure on the sea level, hPahourly.humidity
Humidity, %hourly.dew_point
Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.hourly.uvi
UV indexhourly.clouds
Cloudiness, %hourly.visibility
Average visibility, metres. The maximum value of the visibility is 10kmhourly.wind_speed
Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour.How to change units usedhourly.wind_gust
(where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units usedchourly.wind_deg
Wind direction, degrees (meteorological)hourly.pop
Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%hourly.rain
hourly.rain.1h
(where available) Precipitation, mm/hhourly.snow
hourly.snow.1h
(where available) Precipitation, mm/h-
hourly.weather
hourly.weather.id
Weather condition idhourly.weather.main
Group of weather parameters (Rain, Snow, Extreme etc.)hourly.weather.description
Weather condition within the group (full list of weather conditions). Get the output in your languagehourly.weather.icon
Weather icon id. How to get icons
-
daily
Daily forecast weather data API responsedaily.dt
Time of the forecasted data, Unix, UTCdaily.sunrise
Sunrise time, Unix, UTCdaily.sunset
Sunset time, Unix, UTCdaily.moonrise
The time of when the moon rises for this day, Unix, UTCdaily.moonset
The time of when the moon sets for this day, Unix, UTCdaily.moon_phase
Moon phase.0
and1
are 'new moon',0.25
is 'first quarter moon',0.5
is 'full moon' and0.75
is 'last quarter moon'. The periods in between are called 'waxing crescent', 'waxing gibous', 'waning gibous', and 'waning crescent', respectively.daily.temp
Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units useddaily.temp.morn
Morning temperature.daily.temp.day
Day temperature.daily.temp.eve
Evening temperature.daily.temp.night
Night temperature.daily.temp.min
Min daily temperature.daily.temp.max
Max daily temperature.-
daily.feels_like
This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units useddaily.feels_like.morn
Morning temperature.daily.feels_like.day
Day temperature.daily.feels_like.eve
Evening temperature.daily.feels_like.night
Night temperature.
daily.pressure
Atmospheric pressure on the sea level, hPadaily.humidity
Humidity, %daily.dew_point
Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.daily.wind_speed
Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddaily.wind_gust
(where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddaily.wind_deg
Wind direction, degrees (meteorological)daily.clouds
Cloudiness, %daily.uvi
The maximum value of UV index for the daydaily.pop
Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%daily.rain
(where available) Precipitation volume, mmdaily.snow
(where available) Snow volume, mmdaily.weather
daily.weather.id
Weather condition iddaily.weather.main
Group of weather parameters (Rain, Snow, Extreme etc.)daily.weather.description
Weather condition within the group (full list of weather conditions). Get the output in your languagedaily.weather.icon
Weather icon id. How to get icons
-
alerts
National weather alerts data from major national weather warning systemsalerts.sender_name
Name of the alert source. Please read here the full list of alert sourcesalerts.event
Alert event namealerts.start
Date and time of the start of the alert, Unix, UTCalerts.end
Date and time of the end of the alert, Unix, UTCalerts.description
Description of the alertalerts.tags
Type of severe weather
Please note that some agencies provide the alert’s description only in a local language.
Historical weather data
To learn about how get access to historical weather data for more that 40 years back, please use this section of the documentation.
If you are interested in current weather data, forecasts and weather alerts please read the "Current and forecast weather data" section.
How to make an API call
API call
https://api.openweathermap.org/data/3.0/onecall/timemachine?lat={lat}&lon={lon}&dt={time}&appid={API key}
Parameters | ||
---|---|---|
lat, lon |
required | Geographical coordinates (latitude, longitude) |
dt |
required | Timestamp (Unix time, UTC time zone), e.g. dt=1586468027. Data is available from January 1st, 1979. |
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 |
lang |
optional | You can use the lang parameter to get the output in your language. Learn more |
Example of API call
Before making an API call, please note, that One Call 3.0 is included in the "One Call by Call" subscription only. Learn more
https://api.openweathermap.org/data/3.0/onecall/timemachine?lat=39.099724&lon=-94.578331&dt=1643803200&appid={API key}
Example of API response
Example of API response
{
"lat": 52.2297,
"lon": 21.0122,
"timezone": "Europe/Warsaw",
"timezone_offset": 3600,
"data": [
{
"dt": 1645888976,
"sunrise": 1645853361,
"sunset": 1645891727,
"temp": 279.13,
"feels_like": 276.44,
"pressure": 1029,
"humidity": 64,
"dew_point": 272.88,
"uvi": 0.06,
"clouds": 0,
"visibility": 10000,
"wind_speed": 3.6,
"wind_deg": 340,
"weather": [
{
"id": 800,
"main": "Clear",
"description": "clear sky",
"icon": "01d"
}
]
}
]
}
Fields in API response
lat
Geographical coordinates of the location (latitude)lon
Geographical coordinates of the location (longitude)timezone
Timezone name for the requested locationtimezone_offset
Shift in seconds from UTCdata
data.dt
Requested time, Unix, UTCdata.sunrise
Sunrise time, Unix, UTCdata.sunset
Sunset time, Unix, UTCdata.temp
Temperature. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units useddata.feels_like
Temperature. This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.data.pressure
Atmospheric pressure on the sea level, hPadata.humidity
Humidity, %data.dew_point
Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.data.clouds
Cloudiness, %data.uvi
(where available) UV indexdata.visibility
Average visibility, metres. The maximum value of the visibility is 10kmdata.wind_speed
Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddata.wind_gust
(where available) Wind gust. Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddata.wind_deg
Wind direction, degrees (meteorological)data.weather
data.weather.id
Weather condition iddata.weather.main
Group of weather parameters (Rain, Snow, Extreme etc.)data.weather.description
Weather condition within the group (full list of weather conditions). Get the output in your languagedata.weather.icon
Weather icon id. How to get icons
data.rain
(where available) Precipitation, mm/hdata.snow
(where available) Precipitation, mm/h
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.)
Other features
Units of measurement
standard
, metric
and imperial
units are available.
API call
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&units={units}
Parameters | ||
---|---|---|
units |
optional | Units of measurement. standard , metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default. |
Wind speed is available in miles/hour and meter/sec.
- For temperature in Fahrenheit and wind speed in miles/hour, use
units=imperial
- For temperature in Celsius and wind speed in meter/sec, use
units=metric
- Temperature in Kelvin and wind speed in meter/sec is used by default, so there is no need to use the units parameter in the API call if you want this
Examples of API calls
Standard (default)
api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335
Metric
api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335&units=metric
Imperial
api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335&units=imperial
Multilingual support
You can use lang
parameter to get the output in your language.
The contents of the description
field will be translated.
API call
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&lang={lang}
Parameters | ||
---|---|---|
lang |
optional | You can use the lang parameter to get the output in your language. |
Example of API call
Before making an API call, please note, that One Call 3.0 is included in the "One Call by Call" subscription only. Learn more
https://api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335&lang=zh_cn
We support the following languages. To select one, you can use the corresponding language code:
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
List of national weather alerts sources
Country | Agency |
---|---|
Afghanistan | National Disaster Management Authority |
Albania | Institute of GeoSciences, Energy, Water and Environment |
Algeria | National Meteorological Office |
Anguilla | Disaster Management Anguilla |
Antigua and Barbuda | Meteorological Services |
Argentina | Servicio Meteorologico Nacional |
Aruba | Meteorological Department of Aruba |
Austria | |
Barbados | Department of Emergency Management |
Belgium | Royal Meteorological Institute |
Bosnia and Herzegovin | |
Botswana | Department of Meteorological Services |
Brazil | National Meteorological Institute - INMET |
Bulgaria | National Institute of Meteorology and Hydrology - Plovdiv branch |
Canada | |
Colombia | UNGRD (National Unit for Disaster Risk Management) |
Croatia | State Hydrometeorological Institute (DHMZ) |
Cyprus | Meteorological Service |
Czech Republic | Czech Hydrometeorological Institute |
Denmark | Danmarks Meteorologiske Instituts |
Estonia | State Weather Service |
Federated States of Micronesia |
|
Finland | Finnish Meteorological Institute |
France | Meteo-France |
Germany | German Meteorological Office |
Greece | Hellenic National Meteorological Service |
Guyana | Hydrometeorological Service |
Hungary | Hungarian Meteorological Service |
Iceland | Icelandic Meteorological Office |
India | Meteorological Department |
Indonesia | |
Ireland | Met Eireann - Irish Meteorological Service |
Israel | Meteorological Service |
Italy | National Center of Meteorology and Aeronautical Climatology (CNMCA) |
Jamaica | Meteorological Service |
Kenya | Meteorological Department |
Kuwait | Meteorological Department |
Latvia | Latvian Environment, Geology and Meteorology Center |
Lithuania | Lithuanian Hydrometeorological Service |
Luxembourg | Luxembourg Airport Administration |
Madagascar | Operational Meteorology |
Malawi | Meteorological Services |
Malta | Meteorological Office |
Marshall Islands | Majuro Weather Service Office |
Mexico | CONAGUA - National Meteorological Service of Mexico |
Moldova | State Hydrometeorological Service |
Mongolia | National Agency for Meteorology and Environmental Monitoring |
Montenegro | Institute of Hydrometeorology and Seismology |
Myanmar | Department of Meteorology and Hydrology |
Netherlands | Royal Netherlands Meteorological Institute |
New Zealand | |
North Macedonia | Republic Hydrometeorological Organization |
Norway | |
Oman | Directorate General of Meteorology |
Palau | Weather Service Office |
Papua New Guinea | Papua New Guinea Meteorological Service |
Paraguay | Directorate of Meteorology and Hydrology |
Philippines | Philippine Atmospheric Geophysical and Astronomical Services Administration |
Poland | Institute of Meteorology and Water Management |
Portugal | Portuguese Institute of Sea and Atmosphere, I.P. |
Romania | National Meteorological Administration |
Russia | Russian Federal Service for Hydrometeorology and Environmental Monitoring |
Saint Lucia | Meteorological Services |
Saint Vincent and the Grenadines | Meteorological Services |
Samoa | Meteorology Division |
Senegal | National Agency of Civil Aviation and Meteorology |
Serbia | Republic Hydrometeorological Institute |
Slovakia | Slovak Hydrometeorological Institute |
Slovenia | National Meteorological Service |
Solomon Islands | Meteorological Service |
South Africa | South Africa Weather Service |
Spain | Meteorology Statal Agency |
Suriname | Suriname Meteorological Service |
Sweden | Swedish Meteorological and Hydrological Institute |
Switzerland | MeteoSwiss, Bundesamt für Meteorologie und Klimatologie |
Tanzania | Meteorological Authority |
Thailand | Thai Meteorological Department |
Tonga | Tonga Meteorological Service |
Trinidad and Tobago | Trinidad and Tobago Meteorological Service |
United Kingdom of Great Britain and Northern Ireland | Met Office |
United States | |
Vanuatu | Meteorological Services |
Zimbabwe | Meteorological Services Department |
Please note that some agencies from the list may cease to provide us the weather alert information.
In case you don’t receive alerts from any agency, please contact us.
We constantly work on our product’s improvement and keep expanding the list of partner agencies.
Call back function for JavaScript code
To use JavaScript code you can transfer callback
functionName to JSONP callback.
API call example
api.openweathermap.org/data/3.0/onecall?lat=38.8&lon=12.09&callback=test
test({
"lat": 40.12,
"lon": -96.66,
"timezone": "America/Chicago",
"timezone_offset": -18000,
"current": {
"dt": 1595243443,
"sunrise": 1595243663,
"sunset": 1595296278,
"temp": 293.28,
"feels_like": 293.82,
"pressure": 1016,
"humidity": 100,
"dew_point": 293.28,
"uvi": 10.64,
"clouds": 90,
"visibility": 10000,
"wind_speed": 4.6,
"wind_deg": 310,
"weather": [
{
"id": 501,
"main": "Rain",
"description": "moderate rain",
"icon": "10n"
},
{
"id": 201,
"main": "Thunderstorm",
"description": "thunderstorm with rain",
"icon": "11n"
}
],
"rain": {
"1h": 2.93
}
},
"minutely": [
{
"dt": 1595243460,
"precipitation": 2.928
},
...
},
"hourly": [
{
"dt": 1595242800,
"temp": 293.28,
"feels_like": 293.82,
"pressure": 1016,
"humidity": 100,
"dew_point": 293.28,
"clouds": 90,
"visibility": 10000,
"wind_speed": 4.6,
"wind_deg": 123,
"weather": [
{
"id": 501,
"main": "Rain",
"description": "moderate rain",
"icon": "10n"
}
],
"pop": 0.99,
"rain": {
"1h": 2.46
}
},
...
}
"daily": [
{
"dt": 1595268000,
"sunrise": 1595243663,
"sunset": 1595296278,
"temp": {
"day": 298.82,
"min": 293.25,
"max": 301.9,
"night": 293.25,
"eve": 299.72,
"morn": 293.48
},
"feels_like": {
"day": 300.06,
"night": 292.46,
"eve": 300.87,
"morn": 293.75
},
"pressure": 1014,
"humidity": 82,
"dew_point": 295.52,
"wind_speed": 5.22,
"wind_deg": 146,
"weather": [
{
"id": 502,
"main": "Rain",
"description": "heavy intensity rain",
"icon": "10d"
}
],
"clouds": 97,
"pop": 1,
"rain": 12.57,
"uvi": 10.64
},
...
},
"alerts": [
{
"sender_name": "NWS Tulsa (Eastern Oklahoma)",
"event": "Heat Advisory",
"start": 1597341600,
"end": 1597366800,
"description": "...HEAT ADVISORY REMAINS IN EFFECT FROM 1 PM THIS AFTERNOON TO\n8 PM CDT THIS EVENING...\n* WHAT...Heat index values of 105 to 109 degrees expected.\n* WHERE...Creek, Okfuskee, Okmulgee, McIntosh, Pittsburg,\nLatimer, Pushmataha, and Choctaw Counties.\n* WHEN...From 1 PM to 8 PM CDT Thursday.\n* IMPACTS...The combination of hot temperatures and high\nhumidity will combine to create a dangerous situation in which\nheat illnesses are possible."
},
...
]
})