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) |
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/{locationKey}{.format}?apikey={your key}&date={date}&details={true or false}&metric={true or false}&language={language code}
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/{locationKey}{.format}?apikey={your key}&date={date}&calendar=true&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&calendar=true
Examples
JSON format
Codehttps://api.accuweather.com/historical/weather/v1/daily/335315.json?apikey={your key}&date=2020-03-09&details=true
Response:
Code[ { "date": "2020-03-09T00:00:00-04:00", "epochDate": 1583726400, "temperature": { "minimum": { "value": 35.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 63.0, "unit": "F", "unitType": 18 }, "average": { "value": 48.0, "unit": "F", "unitType": 18 }, "departure": { "value": 9.0, "unit": "F", "unitType": 18 } }, "dewPoint": { "minimum": { "value": 23.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 41.0, "unit": "F", "unitType": 18 }, "average": { "value": 32.0, "unit": "F", "unitType": 18 }, "departure": { "value": 8.0, "unit": "F", "unitType": 18 } }, "relativeHumidity": { "minimum": 38.0, "maximum": 69.0, "average": 54.0, "departure": -1.0 }, "pressure": { "minimum": { "value": 28.78, "unit": "inHg", "unitType": 12 }, "maximum": { "value": 28.88, "unit": "inHg", "unitType": 12 }, "average": { "value": 28.83, "unit": "inHg", "unitType": 12 }, "departure": { "value": -0.09, "unit": "inHg", "unitType": 12 } }, "windSpeed": { "minimum": { "value": 4.6, "unit": "mi/h", "unitType": 9 }, "maximum": { "value": 7.9, "unit": "mi/h", "unitType": 9 }, "average": { "value": 5.9, "unit": "mi/h", "unitType": 9 }, "departure": { "value": 1.1, "unit": "mi/h", "unitType": 9 } }, "windGust": { "minimum": { "value": 13.8, "unit": "mi/h", "unitType": 9 }, "maximum": { "value": 25.6, "unit": "mi/h", "unitType": 9 }, "average": { "value": 18.4, "unit": "mi/h", "unitType": 9 }, "departure": { "value": 3.2, "unit": "mi/h", "unitType": 9 } }, "windDirection": { "degrees": 245, "localized": "WSW", "english": "WSW" }, "dominantPrecipitationType": "No precipitation", "precipitation": { "value": 0.0, "unit": "in", "unitType": 1 }, "precipitationRate": { "minimum": { "value": 0.0, "unit": "in", "unitType": 1 }, "maximum": { "value": 0.0, "unit": "in", "unitType": 1 }, "average": { "value": 0.0, "unit": "in", "unitType": 1 } }, "snowCover": { "minimum": 0.0, "maximum": 1.0, "average": 0.0, "departure": -1.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", "unitType": 1 }, "maximum": { "value": 0.0, "unit": "in", "unitType": 1 }, "average": { "value": 0.0, "unit": "in", "unitType": 1 } }, "realFeel": { "minimum": { "value": 33.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 67.0, "unit": "F", "unitType": 18 }, "average": { "value": 48.0, "unit": "F", "unitType": 18 }, "departure": { "value": 8.0, "unit": "F", "unitType": 18 } }, "realFeelShade": { "minimum": { "value": 35.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 63.0, "unit": "F", "unitType": 18 }, "average": { "value": 48.0, "unit": "F", "unitType": 18 }, "departure": { "value": 9.0, "unit": "F", "unitType": 18 } }, "heatIndex": null, "windChill": { "minimum": { "value": 17.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 24.0, "unit": "F", "unitType": 18 }, "average": { "value": 20.0, "unit": "F", "unitType": 18 }, "departure": { "value": 2.0, "unit": "F", "unitType": 18 } }, "wetBulb": { "minimum": { "value": 30.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 50.0, "unit": "F", "unitType": 18 }, "average": { "value": 40.0, "unit": "F", "unitType": 18 }, "departure": { "value": 8.0, "unit": "F", "unitType": 18 } }, "soilTemperature": { "minimum": { "value": 34.0, "unit": "F", "unitType": 18 }, "maximum": { "value": 52.0, "unit": "F", "unitType": 18 }, "average": { "value": 39.0, "unit": "F", "unitType": 18 }, "departure": { "value": 2.0, "unit": "F", "unitType": 18 } }, "soilMoisture": { "minimum": { "value": 0.0, "unit": "ft\u00b3/ft\u00b3", "unitType": 36 }, "maximum": { "value": 0.0, "unit": "ft\u00b3/ft\u00b3", "unitType": 36 }, "average": { "value": 0.0, "unit": "ft\u00b3/ft\u00b3", "unitType": 36 } }, "meanSeaLevelPressure": { "minimum": { "value": 30.21, "unit": "inHg", "unitType": 12 }, "maximum": { "value": 30.38, "unit": "inHg", "unitType": 12 }, "average": { "value": 30.3, "unit": "inHg", "unitType": 12 }, "departure": { "value": -0.13, "unit": "inHg", "unitType": 12 } }, "cloudBase": { "minimum": { "value": 18600.0, "unit": "ft", "unitType": 0 }, "maximum": { "value": 32000.0, "unit": "ft", "unitType": 0 }, "average": { "value": 23400.0, "unit": "ft", "unitType": 0 }, "departure": { "value": -800.0, "unit": "ft", "unitType": 0 } }, "cloudCover": { "minimum": 0.0, "maximum": 100.0, "average": 53.0, "departure": 35.0 }, "uvIndex": { "minimum": 0.0, "maximum": 4.3, "average": 1.1, "departure": -0.1 }, "solarIrradiance": { "maximum": { "value": 238.44, "unit": "BTU/hr/ft\u00b2", "unitType": 34 }, "average": { "value": 68.44, "unit": "BTU/hr/ft\u00b2", "unitType": 34 }, "total": { "value": 1642.46, "unit": "BTU/hr/ft\u00b2", "unitType": 34 } }, "solarRadiation": { "maximum": { "value": 203.91, "unit": "BTU/hr/ft\u00b2", "unitType": 34 }, "average": { "value": 58.52, "unit": "BTU/hr/ft\u00b2", "unitType": 34 }, "total": { "value": 1404.46, "unit": "BTU/hr/ft\u00b2", "unitType": 34 } }, "evapotranspiration": { "value": 0.1, "unit": "in", "unitType": 1 }, "minutesOfSun": 400, "minutesOfPrecipitation": 60, "minutesOfSnow": 0, "degreeDaysSummary": { "cooling": { "value": 0.0, "unit": "F", "unitType": 18 }, "effective": { "value": 18.0, "unit": "F", "unitType": 18 }, "freezing": { "value": 0.0, "unit": "F", "unitType": 18 }, "growing": { "value": 0.0, "unit": "F", "unitType": 18 }, "heating": { "value": 17.0, "unit": "F", "unitType": 18 } } } ]
CSV format
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"
Last modified on