Weather History


History weather API method returns historical weather for a date on or after 1st Jan, 2015 as json. The data is returned as a Forecast Object.


Forecast object contains astronomy data, day weather forecast and hourly interval weather information for a given city.


forecastday: Parent element


forecastday -> day: 'day' element inside forecastday contains max/min temperature, average temperature


forecastday -> astro
forecastday -> hour:


Forecastday Parent element
forecastday -> day day element contains:
  • Max, min and average temperature
  • Max wind speed
  • Total precipitation
  • Day weather condition
forecastday -> astro astro element contains sunrise, sunset, moonrise and moonset data
forecastday -> hour hour element contains hour by hour weather forecast information

forecastday

Field Data Type Description
date string Forecast date
date_epoch int Forecast date as unix time.
day element See day element
astro element See astro element
hour element See hour element

day Element

Field Data Type Description
maxtemp_c decimal Maximum temperature in celsius for the day.
maxtemp_f decimal Maximum temperature in fahrenheit for the day
mintemp_c decimal Minimum temperature in celsius for the day
mintemp_f decimal Minimum temperature in fahrenheit for the day
avgtemp_c decimal Average temperature in celsius for the day
avgtemp_f decimal Average temperature in fahrenheit for the day
maxwind_mph decimal Maximum wind speed in miles per hour
maxwind_kph decimal Maximum wind speed in kilometer per hour
totalprecip_mm decimal Total precipitation in milimeter
totalprecip_in decimal Total precipitation in inches
avgvis_km decimal Average visibility in kilometer
avgvis_miles decimal Average visibility in miles
avghumidity int Average humidity as percentage
condition:text string Weather condition text
condition:icon string Weather condition icon
condition:code int Weather condition code
uv decimal UV Index

astro Element

Field Data Type Description
sunrise string Sunrise time
sunset string Sunset time
moonrise string Moonrise time
moonset string Moonset time
moon_phase string Moon phases. Value returned:
  • New Moon
  • Waxing Crescent
  • First Quarter
  • Waxing Gibbous
  • Full Moon
  • Waning Gibbous
  • Last Quarter
  • Waning Crescent
moon_illumination decimal Moon illumination as %

hour Element

Field Data Type Description
time_epoch int Time as epoch
time string Date and time
temp_c decimal Temperature in celsius
temp_f decimal Temperature in fahrenheit
condition:text string Weather condition text
condition:icon string Weather condition icon
condition:code int Temperature in code
wind_mph decimal Maximum wind speed in miles per hour
wind_kph decimal Maximum wind speed in kilometer per hour
wind_degree int Wind direction in degrees
wind_dir string Wind direction as 16 point compass. e.g.: NSW
pressure_mb decimal Pressure in millibars
pressure_in decimal Pressure in inches
precip_mm decimal Precipitation amount in millimeters
precip_in decimal Precipitation amount in inches
humidity int Humidity as percentage
cloud int Cloud cover as percentage
feelslike_c decimal Feels like temperature as celcius
feelslike_f decimal Feels like temperature as fahrenheit
windchill_c decimal Windchill temperature in celcius
windchill_f decimal Windchill temperature in fahrenheit
heatindex_c decimal Heat index in celcius
heatindex_f decimal Heat index in fahrenheit
dewpoint_c decimal Dew point in celcius
dewpoint_f decimal Dew point in fahrenheit
will_it_rain int 1 = Yes 0 = No
Will it will rain or not
will_it_snow int 1 = Yes 0 = No
Will it snow or not
is_day int 1 = Yes 0 = No
Whether to show day condition icon or night icon
vis_km decimal Visibility in kilometer
vis_miles decimal Visibility in miles