History API by timestamp

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 40 years back, and get historical weather data by all nesessary 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, lon required Coordinates of the location of your interest
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": 15000,
  "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": 15000,
  "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, Extreme etc.)
    • weather.description Weather condition within the group
    • weather.icon Weather icon id
  • base Internal field
  • visibility (where available) Average visibility, metres
  • main
    • main.temp Temperature, Kelvins
    • main.feels_like Temperature, Kelvins. This temperature parameter accounts for the human perception of weather
    • main.pressure Atmospheric pressure, 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

List of weather condition codes

List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere including extreme conditions like tornado, hurricane etc.)