Current Conditions
Guide
The Current Conditions API provides real-time weather observations for any location, including temperature, weather text, and precipitation data.
For full request and response field details, see Current Conditions Parameters.
Base URLs
- Production: api.accuweather.com
- Development: apidev.accuweather.com
Examples below use the production host. Swap in apidev.accuweather.com for development.
| Endpoint | Description |
|---|---|
| Current conditions by location key | Current weather for a specific location |
| Historical current conditions (past 6 hours) | Past 6 hours of observations |
| Historical current conditions (past 24 hours) | Past 24 hours of observations |
| Top cities current conditions | Current weather for top cities |
Current conditions by location key
Codehttps://{baseUrl}/currentconditions/{version}/{locationKey}{.format}?apikey={your key}&language={language code}&details={true or false}&getphotos={true or false}
Examples
Basic request:
Codehttps://api.accuweather.com/currentconditions/v1/335315.json?apikey={your key}
Code[ { "LocalObservationDateTime": "2018-11-01T14:11:00-04:00", "EpochTime": 1541095860, "WeatherText": "Cloudy", "WeatherIcon": 7, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": true, "Temperature": { "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us", "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us" } ]
Request with photos:
Codehttps://api.accuweather.com/currentconditions/v1/349727.json?apikey={your key}&getphotos=true
Code[ { "LocalObservationDateTime": "2018-11-01T14:11:00-04:00", "EpochTime": 1541095860, "WeatherText": "Partly sunny", "WeatherIcon": 3, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": true, "Temperature": { "Metric": { "Value": 20.6, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 69, "Unit": "F", "UnitType": 18 } }, "Photos": [ { "DateTaken": null, "Source": "iStockphoto/Thinkstock", "Description": "Architecture, Beautiful People, Beauty, Blue, Buil", "PortraitLink": "https://cityscapes.accuweather.com/cityscapes/USA/NewYork_146819736_P_L.jpg", "LandscapeLink": "https://cityscapes.accuweather.com/cityscapes/USA/NewYork_146819736_L_L.jpg" } ], "MobileLink": "https://m.accuweather.com/en/us/new-york-ny/10007/current-weather/349727?lang=en-us", "Link": "https://www.accuweather.com/en/us/new-york-ny/10007/current-weather/349727?lang=en-us" } ]
Request with details in Spanish:
Codehttps://api.accuweather.com/currentconditions/v1/335315.json?apikey={your key}&language=es&details=true
Code[ { "LocalObservationDateTime": "2025-09-26T09:27:00-04:00", "EpochTime": 1758893220, "WeatherText": "Mayormente nublado", "WeatherIcon": 6, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": true, "Temperature": { "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 } }, "RealFeelTemperature": { "Metric": { "Value": 21.2, "Unit": "C", "UnitType": 17, "Phrase": "Agradable" }, "Imperial": { "Value": 70.0, "Unit": "F", "UnitType": 18, "Phrase": "Agradable" } }, "RealFeelTemperatureShade": { "Metric": { "Value": 18.0, "Unit": "C", "UnitType": 17, "Phrase": "Agradable" }, "Imperial": { "Value": 64.0, "Unit": "F", "UnitType": 18, "Phrase": "Agradable" } }, "RelativeHumidity": 100, "IndoorRelativeHumidity": 84, "DewPoint": { "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 } }, "Wind": { "Direction": { "Degrees": 225, "Localized": "SO", "English": "SW" }, "Speed": { "Metric": { "Value": 5.6, "Unit": "km/h", "UnitType": 7 }, "Imperial": { "Value": 3.5, "Unit": "mi/h", "UnitType": 9 } } }, "WindGust": { "Speed": { "Metric": { "Value": 5.6, "Unit": "km/h", "UnitType": 7 }, "Imperial": { "Value": 3.5, "Unit": "mi/h", "UnitType": 9 } } }, "UVIndex": 3, "UVIndexFloat": 2.6, "UVIndexText": "Moderado", "Visibility": { "Metric": { "Value": 16.1, "Unit": "km", "UnitType": 6 }, "Imperial": { "Value": 10.0, "Unit": "mi", "UnitType": 2 } }, "ObstructionsToVisibility": "", "CloudCover": 76, "Ceiling": { "Metric": { "Value": 12192.0, "Unit": "m", "UnitType": 5 }, "Imperial": { "Value": 40000.0, "Unit": "ft", "UnitType": 0 } }, "Pressure": { "Metric": { "Value": 1013.2, "Unit": "mb", "UnitType": 14 }, "Imperial": { "Value": 29.92, "Unit": "inHg", "UnitType": 12 } }, "PressureTendency": { "LocalizedText": "Constante", "Code": "S" }, "Past24HourTemperatureDeparture": { "Metric": { "Value": -2.8, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": -5.0, "Unit": "F", "UnitType": 18 } }, "ApparentTemperature": { "Metric": { "Value": 19.4, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 67.0, "Unit": "F", "UnitType": 18 } }, "WindChillTemperature": { "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 } }, "WetBulbTemperature": { "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 } }, "WetBulbGlobeTemperature": { "Metric": { "Value": 19.1, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 66.0, "Unit": "F", "UnitType": 18 } }, "Precip1hr": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "PrecipitationSummary": { "Precipitation": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "PastHour": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past3Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past6Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past9Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past12Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past18Hours": { "Metric": { "Value": 1.1, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.04, "Unit": "in", "UnitType": 1 } }, "Past24Hours": { "Metric": { "Value": 16.2, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.64, "Unit": "in", "UnitType": 1 } } }, "TemperatureSummary": { "Past6HourRange": { "Minimum": { "Metric": { "Value": 15.0, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 59.0, "Unit": "F", "UnitType": 18 } }, "Maximum": { "Metric": { "Value": 17.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 } } }, "Past12HourRange": { "..." : "..." }, "Past24HourRange": { "..." : "..." } }, "MobileLink": "http://www.accuweather.com/es/us/state-college-pa/16801/current-weather/335315", "Link": "http://www.accuweather.com/es/us/state-college-pa/16801/current-weather/335315" } ]
Historical current conditions (past 6 hours) By LocationKey
Codehttps://{baseUrl}/currentconditions/{version}/{locationKey}/historical{.format}?apikey={your key}&language={language code}&details={true or false}
Examples
Basic request:
Codehttps://api.accuweather.com/currentconditions/v1/335315/historical.json?apikey={your key}
Code[ { "LocalObservationDateTime": "2018-11-02T07:41:00-04:00", "EpochTime": 1541158860, "WeatherText": "Cloudy", "WeatherIcon": 7, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": false, "Temperature": { "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us", "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us" }, { "LocalObservationDateTime": "2018-11-02T07:03:00-04:00", "EpochTime": 1541156580, "WeatherText": "Cloudy", "WeatherIcon": 7, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": false, "Temperature": { "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us", "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us" } ]
Request with details:
Codehttps://api.accuweather.com/currentconditions/v1/335315/historical.json?apikey={your key}&details=true
Code[ { "LocalObservationDateTime": "2025-09-26T12:58:00-04:00", "EpochTime": 1758905880, "WeatherText": "Mostly sunny", "WeatherIcon": 2, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": true, "Temperature": { "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 } }, "RealFeelTemperature": { "Metric": { "Value": 25.0, "Unit": "C", "UnitType": 17, "Phrase": "Pleasant" }, "Imperial": { "Value": 77.0, "Unit": "F", "UnitType": 18, "Phrase": "Pleasant" } }, "RealFeelTemperatureShade": { "Metric": { "Value": 20.9, "Unit": "C", "UnitType": 17, "Phrase": "Pleasant" }, "Imperial": { "Value": 70.0, "Unit": "F", "UnitType": 18, "Phrase": "Pleasant" } }, "RelativeHumidity": 60, "IndoorRelativeHumidity": 60, "DewPoint": { "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 57.0, "Unit": "F", "UnitType": 18 } }, "Wind": { "Direction": { "Degrees": 315, "Localized": "NW", "English": "NW" }, "Speed": { "Metric": { "Value": 9.3, "Unit": "km/h", "UnitType": 7 }, "Imperial": { "Value": 5.8, "Unit": "mi/h", "UnitType": 9 } } }, "WindGust": { "Speed": { "Metric": { "Value": 11.3, "Unit": "km/h", "UnitType": 7 }, "Imperial": { "Value": 7.0, "Unit": "mi/h", "UnitType": 9 } } }, "UVIndex": 5, "UVIndexFloat": 4.6, "UVIndexText": "Moderate", "Visibility": { "Metric": { "Value": 16.1, "Unit": "km", "UnitType": 6 }, "Imperial": { "Value": 10.0, "Unit": "mi", "UnitType": 2 } }, "ObstructionsToVisibility": "", "CloudCover": 21, "Ceiling": { "Metric": { "Value": 12192.0, "Unit": "m", "UnitType": 5 }, "Imperial": { "Value": 40000.0, "Unit": "ft", "UnitType": 0 } }, "Pressure": { "Metric": { "Value": 1013.9, "Unit": "mb", "UnitType": 14 }, "Imperial": { "Value": 29.94, "Unit": "inHg", "UnitType": 12 } }, "PressureTendency": { "LocalizedText": "Steady", "Code": "S" }, "Past24HourTemperatureDeparture": { "Metric": { "Value": 2.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 4.0, "Unit": "F", "UnitType": 18 } }, "ApparentTemperature": { "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 } }, "WindChillTemperature": { "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 } }, "WetBulbTemperature": { "Metric": { "Value": 17.0, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 63.0, "Unit": "F", "UnitType": 18 } }, "WetBulbGlobeTemperature": { "Metric": { "Value": 21.4, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 71.0, "Unit": "F", "UnitType": 18 } }, "Precip1hr": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "PrecipitationSummary": { "Precipitation": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "PastHour": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past3Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past6Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past9Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past12Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past18Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } }, "Past24Hours": { "Metric": { "Value": 0.0, "Unit": "mm", "UnitType": 3 }, "Imperial": { "Value": 0.0, "Unit": "in", "UnitType": 1 } } }, "TemperatureSummary": { "Past6HourRange": { "Minimum": { "Metric": { "Value": 15.0, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 59.0, "Unit": "F", "UnitType": 18 } }, "Maximum": { "Metric": { "Value": 22.2, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 72.0, "Unit": "F", "UnitType": 18 } } }, "Past12HourRange": { "...": "..." }, "Past24HourRange": { "...": "..." } }, "MobileLink": "http://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315", "Link": "http://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315" } // ...additional observations omitted ]
Historical current conditions (past 24 hours) By LocationKey
Codehttps://{baseUrl}/currentconditions/{version}/{locationKey}/historical/24{.format}?apikey={your key}&language={language code}&details={true or false}
Examples
Basic request:
Codehttps://api.accuweather.com/currentconditions/v1/335315/historical/24.json?apikey={your key}
Code[ { "LocalObservationDateTime": "2018-11-02T08:02:00-04:00", "EpochTime": 1541160120, "WeatherText": "Cloudy", "WeatherIcon": 7, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": true, "Temperature": { "Metric": { "Value": 12.8, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 55, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us", "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us" }, { "LocalObservationDateTime": "2018-11-02T07:03:00-04:00", "EpochTime": 1541156580, "WeatherText": "Cloudy", "WeatherIcon": 7, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": false, "Temperature": { "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us", "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us" }, { "LocalObservationDateTime": "2018-11-02T06:03:00-04:00", "EpochTime": 1541152980, "WeatherText": "Light rain", "WeatherIcon": 12, "HasPrecipitation": true, "PrecipitationType": "Rain", "IsDayTime": false, "Temperature": { "Metric": { "Value": 13.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 57, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us", "Link": "https://www.accuweather.com/en/us/state-college-pa/16801/current-weather/335315?lang=en-us" } // ...up to 24 observation entries ]
Request with details:
Codehttps://api.accuweather.com/currentconditions/v1/335315/historical/24.json?apikey={your key}&details=true
Returns the full detailed response for each observation (the same field set as the 6-hour detailed response above), with up to 24 entries covering the past 24 hours.
Current conditions for top cities
Codehttps://{baseUrl}/currentconditions/{version}/topcities/{group}{.format}?apikey={your key}&language={language code}
Example
Codehttps://api.accuweather.com/currentconditions/v1/topcities/50.json?apikey={your key}
Code[ { "Key": "28143", "LocalizedName": "Dhaka", "EnglishName": "Dhaka", "Country": { "ID": "BD", "LocalizedName": "Bangladesh", "EnglishName": "Bangladesh" }, "TimeZone": { "Code": "BDT", "Name": "Asia/Dhaka", "GmtOffset": 6, "IsDaylightSaving": false, "NextOffsetChange": null }, "GeoPosition": { "Latitude": 23.7098, "Longitude": 90.40711, "Elevation": { "Metric": { "Value": 5, "Unit": "m", "UnitType": 5 }, "Imperial": { "Value": 16, "Unit": "ft", "UnitType": 0 } } }, "LocalObservationDateTime": "2018-11-02T18:20:00+06:00", "EpochTime": 1541161200, "WeatherText": "Mostly cloudy", "WeatherIcon": 38, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": false, "Temperature": { "Metric": { "Value": 27.8, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 82, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/bd/dhaka/28143/current-weather/28143?lang=en-us", "Link": "https://www.accuweather.com/en/bd/dhaka/28143/current-weather/28143?lang=en-us" }, { "Key": "113487", "LocalizedName": "Kinshasa", "EnglishName": "Kinshasa", "Country": { "ID": "CD", "LocalizedName": "Democratic Republic of the Congo", "EnglishName": "Democratic Republic of the Congo" }, "TimeZone": { "Code": "WAT", "Name": "Africa/Kinshasa", "GmtOffset": 1, "IsDaylightSaving": false, "NextOffsetChange": null }, "GeoPosition": { "Latitude": -4.323, "Longitude": 15.308, "Elevation": { "Metric": { "Value": 280, "Unit": "m", "UnitType": 5 }, "Imperial": { "Value": 918, "Unit": "ft", "UnitType": 0 } } }, "LocalObservationDateTime": "2018-11-02T13:20:00+01:00", "EpochTime": 1541161200, "WeatherText": "Partly sunny", "WeatherIcon": 3, "HasPrecipitation": false, "PrecipitationType": null, "IsDayTime": true, "Temperature": { "Metric": { "Value": 28.9, "Unit": "C", "UnitType": 17 }, "Imperial": { "Value": 84, "Unit": "F", "UnitType": 18 } }, "MobileLink": "https://m.accuweather.com/en/cd/kinshasa/113487/current-weather/113487?lang=en-us", "Link": "https://www.accuweather.com/en/cd/kinshasa/113487/current-weather/113487?lang=en-us" } // ...remaining cities (up to `group`) ]
Available group values are 50, 100, or 150.
Last modified on