Documentation

We provide hourly historical weather data for any location on the globe via Weather History API. Availability of hourly historical data depends on a type of your subscription.

You can also download this data in JSON or CSV format - please read History Bulk and History Forecast Bulk.

• message Internal parameter
• cod Internal parameter
• city_id City ID. Please note that built-in geocoder functionality has been deprecated. Learn more here
• calctime Internal parameter
• list
  • dt Time of data calculation, unix, UTC
  • main
    • main.temp Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. Learn more
    • main.feels_like This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. Learn more
    • 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). Please find more here. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. Learn more
    • main.temp_max Maximum temperature within a large city or a megalopolis (optional parameter). Please find more here. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. Learn more
    • main.sea_level Atmospheric pressure on the sea level, hPa
    • main.grnd_level Atmospheric pressure on the ground level, hPa
  • wind
    • wind.speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. Learn more
    • wind.deg Wind direction, degrees (meteorological)
  • clouds
    • clouds.all Cloudiness, %
  • rain
    • rain.1h Rain volume for the last 1 hour, mm. Please note that only mm as units of measurement are available for this parameter
    • rain.3h Rain volume for the last 3 hours, mm. Please note that only mm as units of measurement are available for this parameter
  • snow
    • snow.1h Snow volume for the last 1 hour, mm. Please note that only mm as units of measurement are available for this parameter
    • snow.3h Snow volume for the last 3 hours, mm. Please note that only mm as units of measurement are available for this parameter
  • weather (more info Weather condition codes)
    • weather.id Weather condition id
    • weather.main Group of weather parameters (Rain, Snow, Clouds etc.)
    • weather.description Weather condition within the group. Please find more here
    • weather.icon Weather icon id

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

Please, do not confuse min/max parameters in hourly historical weather API and forecast API. In hourly historical weather API temp_min and temp_max are optional parameters mean min / max temperature in the city at the moment of calculation to show deviation from the average temperature just for your reference. For large cities and megalopolises geographically expanded it might be applicable. In most cases both temp_min and temp_max parameters have the same volume as 'temp'. Please, use temp_min and temp_max parameters optionally.

For comparison look at example of daily forecast weather API response

We have recently announced the History Bulk functionality that allows to extract historical data for any location for 47+ years in the past.

For accessing this feature please click the next link. The detailed documentation can be found here.

Requesting API calls by geographical coordinates is the most accurate way to specify any location. If you need to convert city names and zip-codes to geo coordinates and the other way around automatically, please use our Geocoding API.

Call historical data by city name.

Call historical data by city ID.

The list of city IDs can be downloaded here.

standard, metric, and imperial units are available. List of all API parameters with available units.

Standard (by default): temperature in Kelvin, wind speed in meter/sec

Metric: temperature in Celsius, wind speed in meter/sec

Imperial: temperature in Fahrenheit, wind speed in miles/hour