Historical time series
GET https://api.weatherstack.com/historical?query=New York&historical_date_start=2015-01-21&historical_date_end=2015-01-25
The historical endpoint is also capable of processing historical time-series results if the parameters historical_date_start and historical_date_end are set to valid dates.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
query | string | [Required] Use this parameter to pass a single location or multiple semicolon-separated location identifiers to the API. Learn more about the Query Parameter. | |
historical_date_start | string | [Required] Use this parameter to pass a start date for the current historical time-series request. | |
historical_date_end | string | [Required] Use this parameter to pass an end date for the current historical time-series request. | |
RESPONSES
status: OK
{"request":{"type":"City","query":"New York, United States of America","language":"en","unit":"m"},"location":{"name":"New York","country":"United States of America","region":"New York","lat":"40.714","lon":"-74.006","timezone_id":"America/New_York","localtime":"2024-03-18 08:47","localtime_epoch":1710751620,"utc_offset":"-4.0"},"current":{"observation_time":"12:47 PM","temperature":6,"weather_code":113,"weather_icons":["https://cdn.worldweatheronline.com/images/wsymbols01_png_64/wsymbol_0001_sunny.png"],"weather_descriptions":["Sunny"],"wind_speed":4,"wind_degree":296,"wind_dir":"WNW","pressure":1008,"precip":0,"humidity":45,"cloudcover":0,"feelslike":3,"uv_index":3,"visibility":16,"is_day":"yes"},"historical":{"2015-01-21":{"date":"2015-01-21","date_epoch":1421798400,"astro":{"sunrise":"07:15 AM","sunset":"05:00 PM","moonrise":"07:42 AM","moonset":"06:46 PM","moon_phase":"Waxing Crescent","moon_illumination":3},"mintemp":-4,"maxtemp":1,"avgtemp":-1,"totalsnow":0,"sunhour":3,"uv_index":2},"2015-01-22":{"date":"2015-01-22","date_epoch":1421884800,"astro":{"sunrise":"07:15 AM","sunset":"05:01 PM","moonrise":"08:23 AM","moonset":"07:59 PM","moon_phase":"Waxing Crescent","moon_illumination":10},"mintemp":-1,"maxtemp":3,"avgtemp":0,"totalsnow":0,"sunhour":7,"uv_index":1},"2015-01-23":{"date":"2015-01-23","date_epoch":1421971200,"astro":{"sunrise":"07:14 AM","sunset":"05:02 PM","moonrise":"09:02 AM","moonset":"09:11 PM","moon_phase":"Waxing Crescent","moon_illumination":18},"mintemp":-3,"maxtemp":3,"avgtemp":0,"totalsnow":0,"sunhour":10,"uv_index":2},"2015-01-24":{"date":"2015-01-24","date_epoch":1422057600,"astro":{"sunrise":"07:13 AM","sunset":"05:04 PM","moonrise":"09:39 AM","moonset":"10:21 PM","moon_phase":"Waxing Crescent","moon_illumination":25},"mintemp":-1,"maxtemp":2,"avgtemp":1,"totalsnow":21,"sunhour":3,"uv_index":1},"2015-01-25":{"date":"2015-01-25","date_epoch":1422144000,"astro":{"sunrise":"07:12 AM","sunset":"05:05 PM","moonrise":"10:15 AM","moonset":"11:30 PM","moon_phase":"Waxing Crescent","moon_illumination":32},"mintemp":-3,"maxtemp":3,"avgtemp":-1,"totalsnow":0,"sunhour":10,"uv_index":2}}}