Documentation

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 47+ 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}

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

{
  "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 4.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.)

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 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
}