History API

History API (history.json): hourly and daily historical weather for any date since 1 January 2010. Parameters, response fields and examples.

History weather API method returns, depending upon your subscription plan level, historical weather for a date on or after 1st Jan, 2010 as json and xml. The data is returned as a Forecast Object.

For Enterprise plan users we also return historical Solar Irradiance (from 1^st Jan 2010 onwards), Evapotranspiration (from 1^st Jan 2010 onwards), Pollen (from 1^st Jan 2010 onwards) and Air Quality data (from 1^st March 2021 onwards).

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 Air Quality data Pollen data
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
air_quality	element	See aqi element
pollen (Enterprise plan)	element	See pollen 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
totalsnow_cm	decimal	Total snowfall in centimeters
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
daily_will_it_rain	int	1 = Yes 0 = No Will it will rain or not
daily_will_it_snow	int	1 = Yes 0 = No Will it snow or not
daily_chance_of_rain	int	Chance of rain as percentage
daily_chance_of_snow	int	Chance of snow as percentage

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 %
is_moon_up	int	1 = Yes or 0 =No Determine if the moon is currently up, based on moon set and moon rise time at the provided location and date.
is_sun_up	int	1 = Yes or 0 =No Determine if the sun is currently up, based on sunset and sunrise time at the provided location and date.

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	Weather condition 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
snow_cm	decimal	Snowfall in centimeters
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
chance_of_rain	int	Chance of rain as percentage
chance_of_snow	int	Chance of snow as percentage
gust_mph	decimal	Wind gust in miles per hour
gust_kph	decimal	Wind gust in kilometer per hour
uv	decimal	UV Index
short_rad (Enterprise plan)	decimal	Shortwave solar radiation or Global horizontal irradiation (GHI) W/m²
diff_rad (Enterprise plan)	decimal	Diffuse Horizontal Irradiation (DHI) W/m²
dni (Enterprise plan)	decimal	Direct Normal Irradiance (DNI) W/m²
direct_rad (Enterprise plan)	decimal	Direct Radiation W/m²
wind_mph_100 (Enterprise plan)	decimal	Maximum wind speed at 100 mt in miles per hour
wind_kph_100 (Enterprise plan)	decimal	Maximum wind speed at 100 mt in kilometer per hour
wind_degree_100 (Enterprise plan)	int	Wind direction in degrees at 100 mt height
wind_dir_100 (Enterprise plan)	string	Wind direction as 16 point compass at 100 mt height. e.g.: NSW
et0 (Enterprise plan)	decimal	Evapotranspiration at 100 mt height.
air_quality	element	See aqi element
pollen (Enterprise plan)	element	See pollen element

forecastday

day Element

astro Element

hour Element

Quick and Easy Signup for Weather API