History API for 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 coordinates and points in time up to 45+ 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

We provide a broad variety of products such as One Call API 3.0, Solar Irradiance & Energy Prediction service, Road Risk API, Air Pollution API and solutions for advanced weather parameters like solar irradiance data, UVI, dew point, government weather alerts, etc. Please review our product list page and find more info in the product documentation and pricing pages.

List of weather condition codes

List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere etc.)

We use cookies to personalize content and to analyze our traffic. Please decide if you are willing to accept cookies from our website.
Advanced Settings