Historical
Guide
The Historical API provides archived weather observation data going back to January 1, 1990, with support for JSON and CSV output.
For full request and response field details, see Historical 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 |
|---|---|
| Daily historical search (meteorological day) | Daily weather records for a specific date, covering the meteorological day (7 AM to 7 AM local time). |
| Daily historical search (calendar day) | Daily weather records for a specific date, covering the calendar day (midnight to midnight local time). |
| Hourly historical search | Hourly weather records for a specific date and time range up to 365 days. |
Daily historical search (meteorological day)
By default, the Historical API returns data for the meteorological day: the 24-hour period from 7:00 AM local time on the requested date to 7:00 AM local time the following day. This convention aligns with standard meteorological observation practice.
Codehttps://{baseUrl}/historical/weather/{version}/daily/{location key}{.format}?apikey={your key}&date={date}&details={true or false}&metric={true or false}&language={language code}
Example
Codehttps://api.accuweather.com/historical/weather/v1/daily/335315?apikey={your key}&date=2016-04-21
Response
Code[ { "date": "2016-04-21T00:00:00-04:00", "epochDate": 1461211200, "temperature": { "minimum": { "value": 46.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 70.0, "unit": "F", "unitType": 18 }, "average": { "value": 59.0, "unit": "F", "unitType": 18 }, "departure": { "value": 8.0, "unit": "F", "unitType": 18 } }, "dewPoint": { "minimum": { "value": 37.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 53.0, "unit": "F", "unitType": 18 }, "average": { "value": 48.0, "unit": "F", "unitType": 18 }, "departure": { "value": 16.0, "unit": "F", "unitType": 18 } }, "relativeHumidity": { "minimum": 43.0, "maximum": 93.0, "average": 68.0, "departure": 19.0 }, "pressure": { "minimum": { "value": 28.66, "unit": "inHg", "unitType": 12 }, "maximum": { "value": 28.86, "unit": "inHg", "unitType": 12 }, "average": { "value": 28.76, "unit": "inHg", "unitType": 12 }, "departure": { "value": -0.19, "unit": "inHg", "unitType": 12 } }, "windSpeed": { "minimum": { "value": 1.7, "unit": "mi/h", "unitType": 9 }, "maximum": { "value": 6.0, "unit": "mi/h", "unitType": 9 }, "average": { "value": 3.7, "unit": "mi/h", "unitType": 9 }, "departure": { "value": 0.5, "unit": "mi/h", "unitType": 9 } }, "windGust": { "minimum": { "value": 7.7, "unit": "mi/h", "unitType": 9 }, "maximum": { "value": 20.0, "unit": "mi/h", "unitType": 9 }, "average": { "value": 12.7, "unit": "mi/h", "unitType": 9 }, "departure": { "value": 2.1, "unit": "mi/h", "unitType": 9 } }, "windDirection": { "degrees": 185, "localized": "S", "english": "S" }, "dominantPrecipitationType": "No precipitation", "precipitation": { "value": 0.122, "unit": "in", "unitType": 1 }, "precipitationRate": { "minimum": { "value": 0.0, "unit": "in/hr", "unitType": 38 }, "maximum": { "value": 0.12, "unit": "in/hr", "unitType": 38 }, "average": { "value": 0.01, "unit": "in/hr", "unitType": 38 } }, "snowCover": { "minimum": 0.0, "maximum": 0.0, "average": 0.0, "departure": 0.0 }, "snowDepth": { "minimum": { "value": 0.0, "unit": "in", "unitType": 1 }, "maximum": { "value": 0.0, "unit": "in", "unitType": 1 }, "average": { "value": 0.0, "unit": "in", "unitType": 1 } }, "snowLiquid": { "value": 0.0, "unit": "in", "unitType": 1 }, "snowLiquidRate": { "minimum": { "value": 0.0, "unit": "in/hr", "unitType": 38 }, "maximum": { "value": 0.0, "unit": "in/hr", "unitType": 38 }, "average": { "value": 0.0, "unit": "in/hr", "unitType": 38 } } } ]
Daily historical search (calendar day)
Pass calendar=true to retrieve data for the calendar day instead: the 24-hour period from midnight to midnight local time on the requested date. Use this when aligning historical data with business or consumer day-based reporting.
Codehttps://{baseUrl}/historical/weather/{version}/daily/{location key}{.format}?apikey={your key}&date={date}&calendar=true&details={true or false}&metric={true or false}&language={language code}
Example (JSON)
Codehttps://api.accuweather.com/historical/weather/v1/daily/335315.json?apikey={your key}&date=2016-04-21&calendar=true
Response
Code[ { "date": "2016-04-21T00:00:00-04:00", "epochDate": 1461211200, "temperature": { "minimum": { "value": 40.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 70.0, "unit": "F", "unitType": 18 }, "average": { "value": 56.0, "unit": "F", "unitType": 18 }, "departure": { "value": 5.0, "unit": "F", "unitType": 18 } }, "dewPoint": { "minimum": { "value": 28.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 53.0, "unit": "F", "unitType": 18 }, "average": { "value": 42.0, "unit": "F", "unitType": 18 }, "departure": { "value": 11.0, "unit": "F", "unitType": 18 } }, "relativeHumidity": { "minimum": 43.0, "maximum": 84.0, "average": 60.0, "departure": 10.0 }, "pressure": { "minimum": { "value": 28.71, "unit": "inHg", "unitType": 12 }, "maximum": { "value": 28.88, "unit": "inHg", "unitType": 12 }, "average": { "value": 28.81, "unit": "inHg", "unitType": 12 }, "departure": { "value": -0.18, "unit": "inHg", "unitType": 12 } }, "windSpeed": { "minimum": { "value": 2.4, "unit": "mi/h", "unitType": 9 }, "maximum": { "value": 6.0, "unit": "mi/h", "unitType": 9 }, "average": { "value": 4.4, "unit": "mi/h", "unitType": 9 }, "departure": { "value": 1.5, "unit": "mi/h", "unitType": 9 } }, "windGust": { "minimum": { "value": 9.4, "unit": "mi/h", "unitType": 9 }, "maximum": { "value": 20.0, "unit": "mi/h", "unitType": 9 }, "average": { "value": 13.6, "unit": "mi/h", "unitType": 9 }, "departure": { "value": 3.4, "unit": "mi/h", "unitType": 9 } }, "windDirection": { "degrees": 177, "localized": "S", "english": "S" }, "dominantPrecipitationType": "No precipitation", "precipitation": { "value": 0.056, "unit": "in", "unitType": 1 }, "precipitationRate": { "minimum": { "value": 0.0, "unit": "in/hr", "unitType": 38 }, "maximum": { "value": 0.03, "unit": "in/hr", "unitType": 38 }, "average": { "value": 0.0, "unit": "in/hr", "unitType": 38 } }, "snowCover": { "minimum": 0.0, "maximum": 0.0, "average": 0.0, "departure": 0.0 }, "snowDepth": { "minimum": { "value": 0.0, "unit": "in", "unitType": 1 }, "maximum": { "value": 0.0, "unit": "in", "unitType": 1 }, "average": { "value": 0.0, "unit": "in", "unitType": 1 } }, "snowLiquid": { "value": 0.0, "unit": "in", "unitType": 1 }, "snowLiquidRate": { "minimum": { "value": 0.0, "unit": "in/hr", "unitType": 38 }, "maximum": { "value": 0.0, "unit": "in/hr", "unitType": 38 }, "average": { "value": 0.0, "unit": "in/hr", "unitType": 38 } } } ]
Example (CSV)
Codehttps://api.accuweather.com/historical/weather/v1/daily/335315.csv?apikey={your key}&date=2020-03-09&details=true
Response
Code"date","epochdate","temperature_min","temperature_max","temperature_avg","temperature_dep","realfeel_min","realfeel_max","realfeel_avg","realfeel_dep","realfeelshade_min","realfeelshade_max","realfeelshade_avg","realfeelshade_dep","heatindex_min","heatindex_max","heatindex_avg","heatindex_dep","dewpoint_min","dewpoint_max","dewpoint_avg","dewpoint_dep","windchill_min","windchill_max","windchill_avg","windchill_dep","wetbulb_min","wetbulb_max","wetbulb_avg","wetbulb_dep","soiltemperature_min","soiltemperature_max","soiltemperature_avg","soiltemperature_dep","soilmoisture_min","soilmoisture_max","soilmoisture_avg","relativehumidity_min","relativehumidity_max","relativehumidity_avg","relativehumidity_dep","pressure_min","pressure_max","pressure_avg","pressure_dep","meansealevelpressure_min","meansealevelpressure_max","meansealevelpressure_avg","meansealevelpressure_dep","windspeed_min","windspeed_max","windspeed_avg","windspeed_dep","windgust_min","windgust_max","windgust_avg","windgust_dep","winddirection_degrees","winddirection_localized","winddirection_english","cloudbase_min","cloudbase_max","cloudbase_avg","cloudbase_dep","cloudcover_min","cloudcover_max","cloudcover_avg","cloudcover_dep","uvindex_min","uvindex_max","uvindex_avg","uvindex_dep","precipitation","dominantprecipitationtype","precipitationrate_min","precipitationrate_max","precipitationrate_avg","snowcover_min","snowcover_max","snowcover_avg","snowcover_dep","snowdepth_min","snowdepth_max","snowdepth_avg","snowliquid","snowliquidrate_min","snowliquidrate_max","snowliquidrate_avg","solarirradiance_max","solarirradiance_avg","solarirradiance_total","solarradiation_max","solarradiation_avg","solarradiation_total","evapotranspiration","minutesofsun","minutesofprecipitation","minutesofsnow","degreedays_cooling","degreedays_effective","degreedays_freezing","degreedays_growing","degreedays_heating" "3/9/2020 12:00:00 AM -04:00","1583726400","35.16","62.89","47.93","8.7","33.12","67.36","48.26","8.16","33.12","63.78","46.81","8.49","","","","","22.58","40.55","32.16","7.84","16.89","24.06","19.79","2","29.86","49.85","39.96","7.64","33.72","52.4","39.18","2.28","0.35","0.4","0.38","38","69","54","-1","28.78","28.88","28.83","-0.09","30.21","30.38","30.3","-0.13","4.6","7.9","5.9","1.1","13.8","25.6","18.4","3.2","245.3000030517578","WSW","WSW","18600","32000","23400","-800","0","100","53","35","0","4.3","1.1","-0.1","0","No precipitation","0","0","0","0","1","0","-1","0","0","0","0","0","0","0","238.44","68.44","1642.46","203.91","58.52","1404.46","0.105","400","60","0","0","18","0","0","17"
Hourly historical search
Specify a date and time range to return hourly records for any location.
Codehttps://{baseUrl}/historical/weather/{version}/hourly/{location key}{.format}?apikey={your key}&startdatetime={yyyy-mm-ddThh:mm:ss}&enddatetime={yyyy-mm-ddThh:mm:ss}&offset=&language={language code}&metric={boolean}&details={boolean}
Example
Codehttps://api.accuweather.com/historical/weather/v1/hourly/335315?apikey={your key}&startdatetime=1990-01-01T04:00:00&enddatetime=1990-01-02T15:00:00&language=en-us&metric=true&details=true
Response
Code{ "pageCount": 0, "totalCount": 36, "resultsCount": 36, "observations": [ { "date": "1990-01-01T04:00:00-04:00", "epochDate": 631180800, "temperature": { "value": -1.6, "unit": "C", "unitType": 17 }, "dewPoint": { "value": -3.1, "unit": "C", "unitType": 17 }, "pressure": { "value": 721.1, "unit": "mmHg", "unitType": 15 }, "windSpeed": { "value": 15.3, "unit": "km/h", "unitType": 7 }, "windGust": { "value": 49.6, "unit": "km/h", "unitType": 7 }, "windDirection": { "degrees": 282, "localized": "WNW", "english": "WNW" }, "precipitationType": "No precipitation", "precipitation": { "value": 0.0, "unit": "mm", "unitType": 3 }, "precipitationRate": { "value": 0.0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0.0, "unit": "cm", "unitType": 4 }, "snowCover": 99.0, "snowDepth": { "value": 10.84, "unit": "cm", "unitType": 4 }, "snowLiquidRate": { "value": 0.0, "unit": "cm", "unitType": 4 }, "realFeel": { "value": -6.0, "unit": "C", "unitType": 17 }, "realFeelShade": { "value": -1.6, "unit": "C", "unitType": 17 }, "heatIndex": null, "windChill": { "value": -2.3, "unit": "C", "unitType": 17 }, "soilTemperature1": { "value": -1.9, "unit": "C", "unitType": 17 }, "soilTemperature2": { "value": -1.8, "unit": "C", "unitType": 17 }, "soilTemperature3": { "value": 0.3, "unit": "C", "unitType": 17 }, "soilTemperature4": { "value": 6.9, "unit": "C", "unitType": 17 }, "soilMoisture1": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "soilMoisture2": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "soilMoisture3": { "value": 0.3, "unit": "m³/m³", "unitType": 35 }, "soilMoisture4": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "wetBulb": { "value": -2.6, "unit": "C", "unitType": 17 }, "meanSeaLevelPressure": { "value": 753.9, "unit": "mmHg", "unitType": 15 }, "lowCloudCover": 97, "mediumCloudCover": 0, "highCloudCover": 0, "cloudCover": 97, "cloudBase": { "value": 305.0, "unit": "m", "unitType": 5 }, "uvIndex": 0.0, "solarIrradiance": { "value": 0.0, "unit": "W/m²", "unitType": 33 }, "solarRadiance": { "value": 0.0, "unit": "W/m²", "unitType": 33 }, "evapotranspiration": { "value": 0.0, "unit": "mm", "unitType": 3 }, "minutesOfSun": 0, "minutesOfPrecipitation": 0, "minutesOfSnow": 0 }, { "date": "1990-01-01T05:00:00-04:00", "epochDate": 631184400, "temperature": { "value": -2.2, "unit": "C", "unitType": 17 }, "dewPoint": { "value": -4.0, "unit": "C", "unitType": 17 }, "pressure": { "value": 721.4, "unit": "mmHg", "unitType": 15 }, "windSpeed": { "value": 15.8, "unit": "km/h", "unitType": 7 }, "windGust": { "value": 51.8, "unit": "km/h", "unitType": 7 }, "windDirection": { "degrees": 283, "localized": "WNW", "english": "WNW" }, "precipitationType": "No precipitation", "precipitation": { "value": 0.0, "unit": "mm", "unitType": 3 }, "precipitationRate": { "value": 0.0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0.0, "unit": "cm", "unitType": 4 }, "snowCover": 99.0, "snowDepth": { "value": 10.84, "unit": "cm", "unitType": 4 }, "snowLiquidRate": { "value": 0.0, "unit": "cm", "unitType": 4 }, "realFeel": { "value": -6.9, "unit": "C", "unitType": 17 }, "realFeelShade": { "value": -2.2, "unit": "C", "unitType": 17 }, "heatIndex": null, "windChill": { "value": -3.0, "unit": "C", "unitType": 17 }, "soilTemperature1": { "value": -1.9, "unit": "C", "unitType": 17 }, "soilTemperature2": { "value": -1.8, "unit": "C", "unitType": 17 }, "soilTemperature3": { "value": 0.3, "unit": "C", "unitType": 17 }, "soilTemperature4": { "value": 6.9, "unit": "C", "unitType": 17 }, "soilMoisture1": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "soilMoisture2": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "soilMoisture3": { "value": 0.3, "unit": "m³/m³", "unitType": 35 }, "soilMoisture4": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "wetBulb": { "value": -3.3, "unit": "C", "unitType": 17 }, "meanSeaLevelPressure": { "value": 754.1, "unit": "mmHg", "unitType": 15 }, "lowCloudCover": 99, "mediumCloudCover": 0, "highCloudCover": 0, "cloudCover": 99, "cloudBase": { "value": 366.0, "unit": "m", "unitType": 5 }, "uvIndex": 0.0, "solarIrradiance": { "value": 0.0, "unit": "W/m²", "unitType": 33 }, "solarRadiance": { "value": 0.0, "unit": "W/m²", "unitType": 33 }, "evapotranspiration": { "value": 0.0, "unit": "mm", "unitType": 3 }, "minutesOfSun": 0, "minutesOfPrecipitation": 0, "minutesOfSnow": 0 }, { "date": "1990-01-01T06:00:00-04:00", "epochDate": 631188000, "temperature": { "value": -2.7, "unit": "C", "unitType": 17 }, "dewPoint": { "value": -4.7, "unit": "C", "unitType": 17 }, "pressure": { "value": 722.9, "unit": "mmHg", "unitType": 15 }, "windSpeed": { "value": 15.7, "unit": "km/h", "unitType": 7 }, "windGust": { "value": 51.9, "unit": "km/h", "unitType": 7 }, "windDirection": { "degrees": 282, "localized": "WNW", "english": "WNW" }, "precipitationType": "No precipitation", "precipitation": { "value": 0.0, "unit": "mm", "unitType": 3 }, "precipitationRate": { "value": 0.0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0.0, "unit": "cm", "unitType": 4 }, "snowCover": 99.0, "snowDepth": { "value": 10.84, "unit": "cm", "unitType": 4 }, "snowLiquidRate": { "value": 0.0, "unit": "cm", "unitType": 4 }, "realFeel": { "value": -7.5, "unit": "C", "unitType": 17 }, "realFeelShade": { "value": -2.7, "unit": "C", "unitType": 17 }, "heatIndex": null, "windChill": { "value": -3.5, "unit": "C", "unitType": 17 }, "soilTemperature1": { "value": -1.9, "unit": "C", "unitType": 17 }, "soilTemperature2": { "value": -1.8, "unit": "C", "unitType": 17 }, "soilTemperature3": { "value": 0.3, "unit": "C", "unitType": 17 }, "soilTemperature4": { "value": 6.9, "unit": "C", "unitType": 17 }, "soilMoisture1": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "soilMoisture2": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "soilMoisture3": { "value": 0.3, "unit": "m³/m³", "unitType": 35 }, "soilMoisture4": { "value": 0.4, "unit": "m³/m³", "unitType": 35 }, "wetBulb": { "value": -3.9, "unit": "C", "unitType": 17 }, "meanSeaLevelPressure": { "value": 755.6, "unit": "mmHg", "unitType": 15 }, "lowCloudCover": 99, "mediumCloudCover": 0, "highCloudCover": 0, "cloudCover": 99, "cloudBase": { "value": 488.0, "unit": "m", "unitType": 5 }, "uvIndex": 0.0, "solarIrradiance": { "value": 0.0, "unit": "W/m²", "unitType": 33 }, "solarRadiance": { "value": 0.0, "unit": "W/m²", "unitType": 33 }, "evapotranspiration": { "value": 0.0, "unit": "mm", "unitType": 3 }, "minutesOfSun": 0, "minutesOfPrecipitation": 0, "minutesOfSnow": 0 }, {... } ] }
Last modified on