History API by timestamp

Product concept

This product provides historical weather data for any timestamp from
1st January 1979 till now. Data are available for any coordinate on the globe.

Specify any coordinate and points in time up to 46+ years back, and get historical weather data by all necessary weather parameters.

How to request historical data

Call historical data by geographic coordinates.

API call


                     https://history.openweathermap.org/data/3.0/history/timemachine?lat={lat}&lon={lon}&dt={dt}&appid={API key}

Parameters
`lat`	required	Latitude. If you need a geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API.
`lon`	required	Longitude. If you need a geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API.
`dt`	required	Timestamp (unix time, UTC time zone), e.g. dt=1369728000 Data available from 1st January 1979 till now
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)

Example of API call


                        https://history.openweathermap.org/data/3.0/history/timemachine?lat=51.51&lon=-0.13&dt=606348800&appid={API key}

                        
{
  "coord": {
    "lon": -0.13,
    "lat": 51.51
  },
  "sys": {
    "type": 1,
    "id": 300001635,
    "message": 0
  },
  "weather": [
    {
      "id": 300,
      "main": "Drizzle",
      "description": "light intensity drizzle",
      "icon": "09n"
    }
  ],
  "base": "stations",
  "visibility": 10000,
  "main": {
    "temp": 282.91,
    "feels_like": 277.13,
    "pressure": 1007,
    "humidity": 82,
    "temp_min": 281.648,
    "temp_max": 283.55
  },
  "wind": {
    "speed": 7.2,
    "deg": 190
  },
  "clouds": {
    "all": 90
  },
  "dt": 606348800
}

History API response

If you do not see some of the parameters in your API response it means that these weather phenomena are just not happened for the time of measurement for the city or location chosen. Only really measured or calculated data is displayed in API response.

Example of API response

Example of API response

                     
{
  "coord": {
    "lon": -0.13,
    "lat": 51.51
  },
  "sys": {
    "type": 1,
    "id": 300001635,
    "message": 0
  },
  "weather": [
    {
      "id": 300,
      "main": "Drizzle",
      "description": "light intensity drizzle",
      "icon": "09n"
    }
  ],
  "base": "stations",
  "visibility": 10000,
  "main": {
    "temp": 282.91,
    "feels_like": 277.13,
    "pressure": 1007,
    "humidity": 82,
    "temp_min": 281.648,
    "temp_max": 283.55
  },
  "wind": {
    "speed": 7.2,
    "deg": 190
  },
  "clouds": {
    "all": 90
  },
  "rain": {
    "1h": 0.28
  },
  "dt": 606348800
}

Fields in API response

coord Internal parameter
sys
- type Internal field
- id Internal field
- message Internal field
weather (Full list of weather conditions)
- weather.id Weather condition id
- weather.main Group of weather parameters (Rain, Snow, Clouds etc.)
- weather.description Weather condition within the group
- weather.icon Weather icon id
base Internal field
visibility (where available) Average visibility, metres. The maximum value of the visibility is 10km
main
- main.temp Temperature, Kelvins
- main.feels_like Temperature, Kelvins. This temperature parameter accounts for the human perception of weather
- main.pressure Atmospheric pressure on the sea level, hPa
- main.humidity Humidity, %
- main.temp_min Minimum temperature within a large city or a megalopolis (optional parameter), Kelvin
- main.temp_max Maximum temperature within a large city or a megalopolis (optional parameter), Kelvins
wind
- wind.speed Wind speed. Unit: meter/sec.
- wind.deg Wind direction, degrees (meteorological)
clouds
- clouds.all Cloudiness, %
rain
- rain.1h Rain volume for the last 1 hour
snow
- snow.1h Snow volume for the last 1 hour
dt Time of data calculation, unix, UTC