Please read an important notice to our customers:
End of Service for the Weather Underground API

Feature: forecast

Page Contents

Returns a summary of the weather for the next 3 days. This includes high and low temperatures, a string text forecast and the conditions.

Response Fields

txt_forecast: forecastday

period
icon
icon_url
title
fctext
fcttext_metric
pop

simpleforecast: forecastday

date.epoch
date.pretty
date.day
date.month
date.year
date.yday
date.hour
date.min
date.sec
date.isdst
date.monthname
date.weekday_short
date.weekday
date.ampm
date.tz_short
date.tz_long
period
high
low
conditions
icon
icon_url
skyicon
pop
qpf_allday
qpf_day
qpf_night
snow_allday
snow_day
snow_night
maxwind
avewind
avehumidity
maxhumidity
minhumidity

Examples

Try with Apigee

Note: replace {{key}} with Your_Key

Forecast for San Francisco, California

http://api.wunderground.com/api/Your_Key/forecast/q/CA/San_Francisco.json Show Response
{ "response": { "version": "0.1", "termsofService": "http://www.wunderground.com/weather/api/d/terms.html", "features": { "forecast": 1 } }, "forecast": { "txt_forecast": { "date": "2:00 PM PDT", "forecastday": [{ "period": 0, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Tuesday", "fcttext": "Partly cloudy in the morning, then clear. High of 68F. Breezy. Winds from the West at 10 to 25 mph.", "fcttext_metric": "Partly cloudy in the morning, then clear. High of 20C. Windy. Winds from the West at 20 to 35 km/h.", "pop": "0" }, { "period": 1, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Tuesday Night", "fcttext": "Mostly cloudy. Fog overnight. Low of 50F. Winds from the WSW at 5 to 15 mph.", "fcttext_metric": "Mostly cloudy. Fog overnight. Low of 10C. Breezy. Winds from the WSW at 10 to 20 km/h.", "pop": "0" }, { "period": 2, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Wednesday", "fcttext": "Mostly cloudy. Fog early. High of 72F. Winds from the WSW at 10 to 15 mph.", "fcttext_metric": "Mostly cloudy. Fog early. High of 22C. Breezy. Winds from the WSW at 15 to 20 km/h.", "pop": "0" }, { "period": 3, "icon": "mostlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/mostlycloudy.gif", "title": "Wednesday Night", "fcttext": "Overcast. Fog overnight. Low of 54F. Winds from the WSW at 5 to 15 mph.", "fcttext_metric": "Overcast. Fog overnight. Low of 12C. Breezy. Winds from the WSW at 10 to 20 km/h.", "pop": "0" }, { "period": 4, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Thursday", "fcttext": "Overcast in the morning, then partly cloudy. Fog early. High of 72F. Winds from the WSW at 10 to 15 mph.", "fcttext_metric": "Overcast in the morning, then partly cloudy. Fog early. High of 22C. Breezy. Winds from the WSW at 15 to 25 km/h.", "pop": "0" }, { "period": 5, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Thursday Night", "fcttext": "Partly cloudy in the evening, then overcast. Fog overnight. Low of 54F. Winds from the WNW at 5 to 15 mph.", "fcttext_metric": "Partly cloudy in the evening, then overcast. Fog overnight. Low of 12C. Breezy. Winds from the WNW at 10 to 20 km/h.", "pop": "0" }, { "period": 6, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Friday", "fcttext": "Overcast in the morning, then partly cloudy. Fog early. High of 68F. Winds from the West at 5 to 15 mph.", "fcttext_metric": "Overcast in the morning, then partly cloudy. Fog early. High of 20C. Breezy. Winds from the West at 10 to 20 km/h.", "pop": "0" }, { "period": 7, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Friday Night", "fcttext": "Mostly cloudy. Fog overnight. Low of 52F. Winds from the West at 5 to 10 mph.", "fcttext_metric": "Mostly cloudy. Fog overnight. Low of 11C. Winds from the West at 10 to 15 km/h.", "pop": "0" }] }, "simpleforecast": { "forecastday": [{ "date": { "epoch": "1340776800", "pretty": "11:00 PM PDT on June 26, 2012", "day": 26, "month": 6, "year": 2012, "yday": 177, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "June", "weekday_short": "Tue", "weekday": "Tuesday", "ampm": "PM", "tz_short": "PDT", "tz_long": "America/Los_Angeles" }, "period": 1, "high": { "fahrenheit": "68", "celsius": "20" }, "low": { "fahrenheit": "50", "celsius": "10" }, "conditions": "Partly Cloudy", "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "skyicon": "mostlysunny", "pop": 0, "qpf_allday": { "in": 0.00, "mm": 0.0 }, "qpf_day": { "in": 0.00, "mm": 0.0 }, "qpf_night": { "in": 0.00, "mm": 0.0 }, "snow_allday": { "in": 0, "cm": 0 }, "snow_day": { "in": 0, "cm": 0 }, "snow_night": { "in": 0, "cm": 0 }, "maxwind": { "mph": 21, "kph": 34, "dir": "West", "degrees": 272 }, "avewind": { "mph": 17, "kph": 27, "dir": "West", "degrees": 272 }, "avehumidity": 72, "maxhumidity": 94, "minhumidity": 58 }, { "date": { "epoch": "1340863200", "pretty": "11:00 PM PDT on June 27, 2012", "day": 27, "month": 6, "year": 2012, "yday": 178, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "June", "weekday_short": "Wed", "weekday": "Wednesday", "ampm": "PM", "tz_short": "PDT", "tz_long": "America/Los_Angeles" }, "period": 2, "high": { "fahrenheit": "72", "celsius": "22" }, "low": { "fahrenheit": "54", "celsius": "12" }, "conditions": "Partly Cloudy", "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "skyicon": "mostlysunny", "pop": 0, "qpf_allday": { "in": 0.00, "mm": 0.0 }, "qpf_day": { "in": 0.00, "mm": 0.0 }, "qpf_night": { "in": 0.00, "mm": 0.0 }, "snow_allday": { "in": 0, "cm": 0 }, "snow_day": { "in": 0, "cm": 0 }, "snow_night": { "in": 0, "cm": 0 }, "maxwind": { "mph": 11, "kph": 18, "dir": "WSW", "degrees": 255 }, "avewind": { "mph": 9, "kph": 14, "dir": "WSW", "degrees": 252 }, "avehumidity": 70, "maxhumidity": 84, "minhumidity": 54 }, { "date": { "epoch": "1340949600", "pretty": "11:00 PM PDT on June 28, 2012", "day": 28, "month": 6, "year": 2012, "yday": 179, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "June", "weekday_short": "Thu", "weekday": "Thursday", "ampm": "PM", "tz_short": "PDT", "tz_long": "America/Los_Angeles" }, "period": 3, "high": { "fahrenheit": "72", "celsius": "22" }, "low": { "fahrenheit": "54", "celsius": "12" }, "conditions": "Partly Cloudy", "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "skyicon": "partlycloudy", "pop": 0, "qpf_allday": { "in": 0.00, "mm": 0.0 }, "qpf_day": { "in": 0.00, "mm": 0.0 }, "qpf_night": { "in": 0.00, "mm": 0.0 }, "snow_allday": { "in": 0, "cm": 0 }, "snow_day": { "in": 0, "cm": 0 }, "snow_night": { "in": 0, "cm": 0 }, "maxwind": { "mph": 14, "kph": 22, "dir": "West", "degrees": 265 }, "avewind": { "mph": 12, "kph": 19, "dir": "WSW", "degrees": 256 }, "avehumidity": 80, "maxhumidity": 91, "minhumidity": 56 }, { "date": { "epoch": "1341036000", "pretty": "11:00 PM PDT on June 29, 2012", "day": 29, "month": 6, "year": 2012, "yday": 180, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "June", "weekday_short": "Fri", "weekday": "Friday", "ampm": "PM", "tz_short": "PDT", "tz_long": "America/Los_Angeles" }, "period": 4, "high": { "fahrenheit": "68", "celsius": "20" }, "low": { "fahrenheit": "52", "celsius": "11" }, "conditions": "Fog", "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "skyicon": "mostlysunny", "pop": 0, "qpf_allday": { "in": 0.00, "mm": 0.0 }, "qpf_day": { "in": 0.00, "mm": 0.0 }, "qpf_night": { "in": 0.00, "mm": 0.0 }, "snow_allday": { "in": 0, "cm": 0 }, "snow_day": { "in": 0, "cm": 0 }, "snow_night": { "in": 0, "cm": 0 }, "maxwind": { "mph": 11, "kph": 18, "dir": "West", "degrees": 267 }, "avewind": { "mph": 10, "kph": 16, "dir": "West", "degrees": 272 }, "avehumidity": 79, "maxhumidity": 93, "minhumidity": 63 }] } } }