Weather API

Documentation

How to make an API request

API Key

To use the API, you need to sign up for an API key. You need to use this key when making requests

Request URL format

http://api.wunderground.com/api/KEY/FEATURE/[FEATURE…]/q/QUERY.FORMAT

Definitions:

KEY

your unique API key

FEATURE

one of the following feature_id's

feature_id	description
geolookup	Returns the the city name, zip code / postal code, latitude-longitude coordinates and nearby personal weather stations.
conditions	Returns the current temperature, weather condition, humidity, wind, 'feels like' temperature, barometric pressure, and visibility.
forecast	Returns a summary of the weather for the next 3 days. This includes high and low temperatures, a string text forecast and the conditions.
astronomy	Returns The moon phase, sunrise and sunset times.
radar	see description for the radar layer API
animatedradar	see description for the radar layer API
satellite	Returns a URL link to .gif visual and infrared satellite images.
webcams	Returns locations of nearby Personal Weather Stations and URL's for images from their web cams.
history	history_YYYYMMDD returns a summary of the observed weather for the specified date.
alerts	Returns the short name description, expiration time and a long text description of a severe alert - If one has been issued for the searched upon location.
hourly	Returns an hourly forecast for the next 36 hours immediately following the API request.
hourly10day	Returns an hourly forecast for the next 10 days
forecast10day	Returns a summary of the weather for the next 10 days. This includes high and low temperatures, a string text forecast and the conditions.
yesterday	Returns a summary of the observed weather history for yesterday.
planner	planner_MMDDMMDD returns a weather summary based on historical information between the specified dates (30 days max).
autocomplete
almanac	Historical average temperature for today
lang	Returns the API response in the specified language. If omitted then default is English. See table below for language codes.
tide	Tidal information
rawtide	Raw Tidal information for graphs

FORMAT

output format

json
for jsonp, you may add ?callback=CALLBACK to the request URL
xml
XML documentation coming soon.

QUERY

the location for which you want weather information. Examples:

CA/San_Francisco
60290 (U.S. zip code)
Australia/Sydney
37.8,-122.4 (latitude,longitude)
KJFK (airport code)
pws:KCASANFR70 (PWS id)
autoip (AutoIP address location)
autoip.json?geo_ip=38.102.136.138 (Specific IP address location)

Show Response

Example (US):

http://api.wunderground.com/api/YOUR-KEY/geolookup/conditions/forecast/q/CA/San_Francisco.json

{
	"response": {
		"version": "0.1",
		"termsofService": "http://www.wunderground.com/weather/api/d/terms.html",
		"features": {
			"geolookup": 1,
			"conditions": 1,
			"forecast": 1
		}
	}
	,
	"location": {
		"type": "CITY",
		"country": "US",
		"country_iso3166": "US",
		"country_name": "USA",
		"state": "CA",
		"city": "San Francisco",
		"tz_short": "PDT",
		"tz_long": "America/Los_Angeles",
		"lat": "37.77500916",
		"lon": "-122.41825867",
		"zip": "94101",
		"magic": "1",
		"wmo": "99999",
		"l": "/q/zmw:94101.1.99999",
		"requesturl": "US/CA/San_Francisco.html",
		"wuiurl": "http://www.wunderground.com/US/CA/San_Francisco.html",
		"nearby_weather_stations": {
			"airport": {
				"station": [
					{
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"icao": "KSFO",
						"lat": "37.61999893",
						"lon": "-122.37000275"
					},
					{
						"city": "Oakland",
						"state": "CA",
						"country": "US",
						"icao": "KOAK",
						"lat": "37.72000122",
						"lon": "-122.22000122"
					},
					{
						"city": "Hayward",
						"state": "CA",
						"country": "US",
						"icao": "KHWD",
						"lat": "37.65999985",
						"lon": "-122.12000275"
					},
					{
						"city": "Half Moon Bay",
						"state": "CA",
						"country": "US",
						"icao": "KHAF",
						"lat": "37.50999832",
						"lon": "-122.50000000"
					}
				]
			},
			"pws": {
				"station": [
					{
						"neighborhood": "SOMA - Near Van Ness",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR58",
						"distance_km": 0,
						"distance_mi": 0
					},
					{
						"neighborhood": "North Mission (Valencia & Market)",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR49",
						"distance_km": 0,
						"distance_mi": 0
					},
					{
						"neighborhood": "HADS SAN FRANCISCO DOWNTOWN CA US",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "MSFOC1",
						"distance_km": 1,
						"distance_mi": 0
					},
					{
						"neighborhood": "SoMa",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR113",
						"distance_km": 1,
						"distance_mi": 1
					},
					{
						"neighborhood": "Mission Bay - My weather is better than yours.",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR53",
						"distance_km": 1,
						"distance_mi": 1
					},
					{
						"neighborhood": "Castro/San Francisco",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KPCASANF2",
						"distance_km": 2,
						"distance_mi": 1
					},
					{
						"neighborhood": "The Castro",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR114",
						"distance_km": 2,
						"distance_mi": 1
					},
					{
						"neighborhood": "China Basin Landing",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR14",
						"distance_km": 2,
						"distance_mi": 1
					},
					{
						"neighborhood": "The Mission: Even the weather is hip",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR79",
						"distance_km": 2,
						"distance_mi": 1
					},
					{
						"neighborhood": "Potrero Hill",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR108",
						"distance_km": 2,
						"distance_mi": 1
					},
					{
						"neighborhood": "Financial District",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR102",
						"distance_km": 2,
						"distance_mi": 1
					},
					{
						"neighborhood": "Cole Valley",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR110",
						"distance_km": 3,
						"distance_mi": 1
					},
					{
						"neighborhood": "Billy Goat Hill",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR73",
						"distance_km": 3,
						"distance_mi": 2
					},
					{
						"neighborhood": "Marina District",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR82",
						"distance_km": 4,
						"distance_mi": 2
					},
					{
						"neighborhood": "Twin Peaks",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR34",
						"distance_km": 4,
						"distance_mi": 2
					},
					{
						"neighborhood": "APRSWXNET San Francisco CA US",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "MC9629",
						"distance_km": 4,
						"distance_mi": 2
					},
					{
						"neighborhood": "MesoWest San Fran Sewage Treatment Plant CA US CARB",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "MCQ147",
						"distance_km": 4,
						"distance_mi": 2
					},
					{
						"neighborhood": "Mid Richmond",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR128",
						"distance_km": 4,
						"distance_mi": 2
					},
					{
						"neighborhood": "Forest Hill",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR72",
						"distance_km": 5,
						"distance_mi": 3
					},
					{
						"neighborhood": "Sunnyside",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR70",
						"distance_km": 5,
						"distance_mi": 3
					},
					{
						"neighborhood": "Forest Hill",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR109",
						"distance_km": 5,
						"distance_mi": 3
					},
					{
						"neighborhood": "Sherwood Forest",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR129",
						"distance_km": 5,
						"distance_mi": 3
					},
					{
						"neighborhood": "Mid Richmond District",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR97",
						"distance_km": 5,
						"distance_mi": 3
					},
					{
						"neighborhood": "Ocean Beach - Kellys Cove",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR99",
						"distance_km": 8,
						"distance_mi": 4
					},
					{
						"neighborhood": "APRSWXNET San Francisco CA US",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "MAS891",
						"distance_km": 8,
						"distance_mi": 4
					},
					{
						"neighborhood": "Ingleside District",
						"city": "San Francisco",
						"state": "CA",
						"country": "US",
						"id": "KCASANFR100",
						"distance_km": 8,
						"distance_mi": 5
					}
				]
			}
		}
	}
	,
	"current_observation": {
		"image": {
			"url": "http://icons-ak.wxug.com/graphics/wu2/logo_130x80.png",
			"title": "Weather Underground",
			"link": "http://wunderground.com"
		},
		"display_location": {
			"full": "San Francisco, CA",
			"city": "San Francisco",
			"state": "CA",
			"state_name": "California",
			"country": "US",
			"country_iso3166": "US",
			"zip": "94101",
			"latitude": "37.77500916",
			"longitude": "-122.41825867",
			"elevation": "47.00000000"
		},
		"observation_location": {
			"full": "SOMA - Near Van Ness, San Francisco, California",
			"city": "SOMA - Near Van Ness, San Francisco",
			"state": "California",
			"country": "US",
			"country_iso3166": "US",
			"latitude": "37.773285",
			"longitude": "-122.417725",
			"elevation": "49 ft"
		},
		"station_id": "KCASANFR58",
		"observation_time": "Last Updated on September 21, 10:47 AM PDT",
		"observation_time_rfc822": "Wed, 21 Sep 2011 10:47:07 -0700",
		"observation_epoch": "1316627227",
		"local_time_rfc822": "Wed, 21 Sep 2011 10:47:19 -0700",
		"local_epoch": "1316627239",
		"weather": "Clear",
		"temperature_string": "69.7 F (20.9 C)",
		"temp_f": 69.7,
		"temp_c": 20.9,
		"relative_humidity": "69%",
		"wind_string": "Calm",
		"wind_dir": "NNW",
		"wind_degrees": 335,
		"wind_mph": 0.0,
		"wind_gust_mph": "1.0",
		"pressure_mb": "1012.8",
		"pressure_in": "29.91",
		"pressure_trend": "0",
		"dewpoint_string": "59 F (15 C)",
		"dewpoint_f": 59,
		"dewpoint_c": 15,
		"heat_index_string": "NA",
		"heat_index_f": "NA",
		"heat_index_c": "NA",
		"windchill_string": "NA",
		"windchill_f": "NA",
		"windchill_c": "NA",
		"visibility_mi": "10.0",
		"visibility_km": "16.1",
		"icon": "clear",
		"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
		"forecast_url": "http://www.wunderground.com/US/CA/San_Francisco.html",
		"history_url": "http://www.wunderground.com/history/airport/KCASANFR58/2011/9/21/DailyHistory.html",
		"ob_url": "http://www.wunderground.com/cgi-bin/findweather/getForecast?query=37.773285,-122.417725"
	}
	,
	"forecast": {
		"txt_forecast": {
			"date": "1:40 AM PDT",
			"forecastday": [
				{
					"period": 1,
					"icon": "partlycloudy",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif",
					"title": "Today",
					"fcttext": "Partly cloudy. Highs in the mid 60s to lower 80s. Light winds...becoming west 5 to 10 mph in the afternoon. "
				},
				{
					"period": 2,
					"icon": "nt_sunny",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/nt_sunny.gif",
					"title": "Tonight",
					"fcttext": "Clear in the evening then becoming partly cloudy. Lows in the mid 50s. West winds 5 to 10 mph. "
				},
				{
					"period": 3,
					"icon": "cloudy",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/cloudy.gif",
					"title": "Thursday",
					"fcttext": "Mostly cloudy in the morning then becoming partly cloudy. Patchy fog in the morning. Highs in the 60s to lower 70s. Light winds...becoming west 5 to 10 mph in the afternoon. "
				},
				{
					"period": 4,
					"icon": "nt_partlycloudy",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/nt_partlycloudy.gif",
					"title": "Thursday Night",
					"fcttext": "Partly cloudy in the evening then becoming cloudy. Patchy fog after midnight. Lows in the mid 50s. West winds 5 to 10 mph. "
				},
				{
					"period": 5,
					"icon": "cloudy",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/cloudy.gif",
					"title": "Friday",
					"fcttext": "Cloudy in the morning then becoming sunny. Patchy fog in the morning. Highs in the 60s to lower 70s. Light winds... becoming west around 5 mph in the afternoon. "
				}
			]
		},
		"simpleforecast": {
			"forecastday": [
				{
					"date": {
						"epoch": "1316671249",
						"pretty": "11:00 PM PDT on September 21, 2011",
						"day": 21,
						"month": 9,
						"year": 2011,
						"yday": 263,
						"hour": 23,
						"min": "00",
						"sec": 49,
						"isdst": "1",
						"monthname": "September",
						"weekday_short": "Wed",
						"weekday": "Wednesday",
						"ampm": "PM",
						"tz_short": "PDT",
						"tz_long": "America/Los_Angeles"
					},
					"period": 1,
					"high": {
						"fahrenheit": "81",
						"celsius": "27"
					},
					"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
				},
				{
					"date": {
						"epoch": "1316757649",
						"pretty": "11:00 PM PDT on September 22, 2011",
						"day": 22,
						"month": 9,
						"year": 2011,
						"yday": 264,
						"hour": 23,
						"min": "00",
						"sec": 49,
						"isdst": "1",
						"monthname": "September",
						"weekday_short": "Thu",
						"weekday": "Thursday",
						"ampm": "PM",
						"tz_short": "PDT",
						"tz_long": "America/Los_Angeles"
					},
					"period": 2,
					"high": {
						"fahrenheit": "72",
						"celsius": "22"
					},
					"low": {
						"fahrenheit": "54",
						"celsius": "12"
					},
					"conditions": "Clear",
					"icon": "clear",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
					"skyicon": "mostlysunny",
					"pop": 0
				},
				{
					"date": {
						"epoch": "1316844049",
						"pretty": "11:00 PM PDT on September 23, 2011",
						"day": 23,
						"month": 9,
						"year": 2011,
						"yday": 265,
						"hour": 23,
						"min": "00",
						"sec": 49,
						"isdst": "1",
						"monthname": "September",
						"weekday_short": "Fri",
						"weekday": "Friday",
						"ampm": "PM",
						"tz_short": "PDT",
						"tz_long": "America/Los_Angeles"
					},
					"period": 3,
					"high": {
						"fahrenheit": "72",
						"celsius": "22"
					},
					"low": {
						"fahrenheit": "54",
						"celsius": "12"
					},
					"conditions": "Clear",
					"icon": "clear",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
					"skyicon": "mostlysunny",
					"pop": 0
				},
				{
					"date": {
						"epoch": "1316930449",
						"pretty": "11:00 PM PDT on September 24, 2011",
						"day": 24,
						"month": 9,
						"year": 2011,
						"yday": 266,
						"hour": 23,
						"min": "00",
						"sec": 49,
						"isdst": "1",
						"monthname": "September",
						"weekday_short": "Sat",
						"weekday": "Saturday",
						"ampm": "PM",
						"tz_short": "PDT",
						"tz_long": "America/Los_Angeles"
					},
					"period": 4,
					"high": {
						"fahrenheit": "65",
						"celsius": "18"
					},
					"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
				},
				{
					"date": {
						"epoch": "1317016849",
						"pretty": "11:00 PM PDT on September 25, 2011",
						"day": 25,
						"month": 9,
						"year": 2011,
						"yday": 267,
						"hour": 23,
						"min": "00",
						"sec": 49,
						"isdst": "1",
						"monthname": "September",
						"weekday_short": "Sun",
						"weekday": "Sunday",
						"ampm": "PM",
						"tz_short": "PDT",
						"tz_long": "America/Los_Angeles"
					},
					"period": 5,
					"high": {
						"fahrenheit": "63",
						"celsius": "17"
					},
					"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": 10
				},
				{
					"date": {
						"epoch": "1317103249",
						"pretty": "11:00 PM PDT on September 26, 2011",
						"day": 26,
						"month": 9,
						"year": 2011,
						"yday": 268,
						"hour": 23,
						"min": "00",
						"sec": 49,
						"isdst": "1",
						"monthname": "September",
						"weekday_short": "Mon",
						"weekday": "Monday",
						"ampm": "PM",
						"tz_short": "PDT",
						"tz_long": "America/Los_Angeles"
					},
					"period": 6,
					"high": {
						"fahrenheit": "67",
						"celsius": "19"
					},
					"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": 10
				}
			]
		}
	}
}

Show Response

Example (International):

http://api.wunderground.com/api/YOUR-KEY/geolookup/conditions/forecast/q/Australia/Sydney.json

{
	"response": {
		"version": "0.1",
		"termsofService": "http://www.wunderground.com/weather/api/d/terms.html",
		"features": {
			"geolookup": 1,
			"conditions": 1,
			"forecast": 1
		}
	}
	,
	"location": {
		"type": "INTLCITY",
		"country": "AU",
		"country_iso3166": "AU",
		"country_name": "Australia",
		"state": "NW",
		"city": "Sydney",
		"tz_short": "EST",
		"tz_long": "Australia/Sydney",
		"lat": "-33.95000076",
		"lon": "151.17999268",
		"zip": "00000",
		"magic": "1",
		"wmo": "94767",
		"l": "/q/zmw:00000.1.94767",
		"requesturl": "global/stations/94767.html",
		"wuiurl": "http://www.wunderground.com/global/stations/94767.html",
		"nearby_weather_stations": {
			"airport": {
				"station": [
					{
						"city": "Sydney Airport",
						"state": "",
						"country": "Australia",
						"icao": "YSSY",
						"lat": "-33.95000076",
						"lon": "151.18333435"
					},
					{
						"city": "Sydney",
						"state": "",
						"country": "AU",
						"icao": "YSSY",
						"lat": "-33.95000076",
						"lon": "151.17999268"
					},
					{
						"city": "Richmond (NSW)",
						"state": "",
						"country": "AU",
						"icao": "YSRI",
						"lat": "-33.59999847",
						"lon": "150.77999878"
					}
				]
			},
			"pws": {
				"station": [
					{
						"neighborhood": "Matraville",
						"city": "Sydney",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWMATR2",
						"distance_km": 4,
						"distance_mi": 2
					},
					{
						"neighborhood": "Bardwell Park",
						"city": "Sydney",
						"state": "New South Wales",
						"country": "AUSTRALIA",
						"id": "INEWSOUT37",
						"distance_km": 5,
						"distance_mi": 3
					},
					{
						"neighborhood": "APRSWXNET Sydney AU",
						"city": "Little Bay",
						"state": "NW",
						"country": "AU",
						"id": "MD5399",
						"distance_km": 5,
						"distance_mi": 3
					},
					{
						"neighborhood": "Eastern Suburbs",
						"city": "Maroubra",
						"state": "NEW SOUTH WALES",
						"country": "AUSTRALIA",
						"id": "INEWSOUT73",
						"distance_km": 6,
						"distance_mi": 3
					},
					{
						"neighborhood": "Kingsgrove",
						"city": "Kingsgrove",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWKING6",
						"distance_km": 7,
						"distance_mi": 4
					},
					{
						"neighborhood": "Potts Point",
						"city": "Potts Point",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWPOTT2",
						"distance_km": 9,
						"distance_mi": 5
					},
					{
						"neighborhood": "SxS",
						"city": "Sydney",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWSYDN20",
						"distance_km": 11,
						"distance_mi": 6
					},
					{
						"neighborhood": "Cronulla - Cecil Apartments",
						"city": "Cronulla - Sydney",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWSYDN19",
						"distance_km": 11,
						"distance_mi": 7
					},
					{
						"neighborhood": "Kirrawee",
						"city": "Kirrawee",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWKIRR2",
						"distance_km": 12,
						"distance_mi": 7
					},
					{
						"neighborhood": "Lower North Shore",
						"city": "Linley Point (Lane Cove)",
						"state": "NEW SOUTH WALES",
						"country": "AUSTRALIA",
						"id": "INEWSOUT83",
						"distance_km": 13,
						"distance_mi": 8
					},
					{
						"neighborhood": "Gymea Bay South of Sydney near Royal National Park",
						"city": "Sydney",
						"state": "NSW",
						"country": "Australia",
						"id": "ISYDNEY2",
						"distance_km": 14,
						"distance_mi": 8
					},
					{
						"neighborhood": "Sutherland Shire",
						"city": "Sydney",
						"state": "NSW",
						"country": "Australia",
						"id": "ISUTHERL1",
						"distance_km": 14,
						"distance_mi": 8
					},
					{
						"neighborhood": "",
						"city": "Chatswood",
						"state": "New South Wales",
						"country": "Australia",
						"id": "INSWCHAT1",
						"distance_km": 16,
						"distance_mi": 9
					},
					{
						"neighborhood": "Loftus Heights",
						"city": "Loftus",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWLOFT2",
						"distance_km": 16,
						"distance_mi": 10
					},
					{
						"neighborhood": "Sydney",
						"city": "Barden Ridge",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWSYDN17",
						"distance_km": 17,
						"distance_mi": 10
					},
					{
						"neighborhood": "North Ryde Sydney",
						"city": "Macquarie Park",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWMACQ2",
						"distance_km": 18,
						"distance_mi": 11
					},
					{
						"neighborhood": "Sutherland Shire",
						"city": "Engadine",
						"state": "NSW",
						"country": "Australia",
						"id": "KNSENGAD1",
						"distance_km": 19,
						"distance_mi": 11
					},
					{
						"neighborhood": "",
						"city": "Eastwood",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWEAST5",
						"distance_km": 20,
						"distance_mi": 12
					},
					{
						"neighborhood": "Moorebank",
						"city": "Moorebank",
						"state": "NSW",
						"country": "Australia",
						"id": "INSWMOOR1",
						"distance_km": 21,
						"distance_mi": 13
					},
					{
						"neighborhood": "South Turramurra",
						"city": "near Sydney",
						"state": "NSW",
						"country": "Australia",
						"id": "INSWTURR1",
						"distance_km": 22,
						"distance_mi": 13
					},
					{
						"neighborhood": "Beacon Hill",
						"city": "Sydney",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWBEAC2",
						"distance_km": 23,
						"distance_mi": 14
					},
					{
						"neighborhood": "Carlingford",
						"city": "Carlingford",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWCARL2",
						"distance_km": 23,
						"distance_mi": 14
					},
					{
						"neighborhood": "St. Ives",
						"city": "Sydney",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWSTIV2",
						"distance_km": 23,
						"distance_mi": 14
					},
					{
						"neighborhood": "APRSWXNET Sydney AU",
						"city": "Maryville",
						"state": "NW",
						"country": "AU",
						"id": "MD5869",
						"distance_km": 24,
						"distance_mi": 14
					},
					{
						"neighborhood": "Turramurra",
						"city": "Turramurra",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWTURR3",
						"distance_km": 24,
						"distance_mi": 14
					},
					{
						"neighborhood": "Heathcote",
						"city": "Waterfall",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWWATE2",
						"distance_km": 24,
						"distance_mi": 14
					},
					{
						"neighborhood": "Beecroft",
						"city": "Beecroft",
						"state": "NSW",
						"country": "Australia",
						"id": "INSWBEEC1",
						"distance_km": 25,
						"distance_mi": 15
					},
					{
						"neighborhood": "APRSWXNET Sydney Hills AU",
						"city": "Parramatta North",
						"state": "NW",
						"country": "AU",
						"id": "MC1324",
						"distance_km": 26,
						"distance_mi": 15
					},
					{
						"neighborhood": "Constitution Hill",
						"city": "Constitution Hill",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWCONS2",
						"distance_km": 25,
						"distance_mi": 15
					},
					{
						"neighborhood": "West Pennant Hills",
						"city": "Sydney",
						"state": "NSW",
						"country": "Australia",
						"id": "INSWWEST4",
						"distance_km": 26,
						"distance_mi": 15
					},
					{
						"neighborhood": "Normanhurst",
						"city": "Normanhurst",
						"state": "NEW SOUTH WALES",
						"country": "AUSTRALIA",
						"id": "INEWSOUT72",
						"distance_km": 26,
						"distance_mi": 15
					},
					{
						"neighborhood": "Toongabbie",
						"city": "Toongabbie",
						"state": "New South Wales",
						"country": "AUSTRALIA",
						"id": "INSWTOON2",
						"distance_km": 26,
						"distance_mi": 16
					},
					{
						"neighborhood": "Collaroy Plateau",
						"city": "Collaroy",
						"state": "NSW",
						"country": "Australia",
						"id": "INSWSYDN13",
						"distance_km": 26,
						"distance_mi": 16
					},
					{
						"neighborhood": "Florence Cotton Reserve",
						"city": "HORNSBY",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWHORN3",
						"distance_km": 28,
						"distance_mi": 16
					},
					{
						"neighborhood": "",
						"city": "Castle Hill",
						"state": "NSW",
						"country": "AUSTRALIA",
						"id": "INSWCAST2",
						"distance_km": 28,
						"distance_mi": 17
					}
				]
			}
		}
	}
	,
	"current_observation": {
		"image": {
			"url": "http://icons-ak.wxug.com/graphics/wu2/logo_130x80.png",
			"title": "Weather Underground",
			"link": "http://wunderground.com"
		},
		"display_location": {
			"full": "Sydney, New South Wales",
			"city": "Sydney",
			"state": "NW",
			"state_name": "New South Wales",
			"country": "AU",
			"country_iso3166": "AU",
			"zip": "00000",
			"latitude": "-33.95000076",
			"longitude": "151.17999268",
			"elevation": "3.00000000"
		},
		"observation_location": {
			"full": "Sydney, ",
			"city": "Sydney",
			"state": "",
			"country": "AU",
			"country_iso3166": "AU",
			"latitude": "-33.95000076",
			"longitude": "151.17999268",
			"elevation": "10 ft"
		},
		"station_id": "YSSY",
		"observation_time": "Last Updated on September 22, 4:00 AM EST",
		"observation_time_rfc822": "Thu, 22 Sep 2011 04:00:00 +1000",
		"observation_epoch": "1316628000",
		"local_time_rfc822": "Thu, 22 Sep 2011 04:27:47 +1000",
		"local_epoch": "1316629667",
		"weather": "Clear",
		"temperature_string": "57 F (14 C)",
		"temp_f": 57,
		"temp_c": 14,
		"relative_humidity": "59%",
		"wind_string": "From the WSW at 8 MPH",
		"wind_dir": "WSW",
		"wind_degrees": 250,
		"wind_mph": 8,
		"wind_gust_mph": 0,
		"pressure_mb": "1022",
		"pressure_in": "30.18",
		"pressure_trend": "0",
		"dewpoint_string": "43 F (6 C)",
		"dewpoint_f": 43,
		"dewpoint_c": 6,
		"heat_index_string": "NA",
		"heat_index_f": "NA",
		"heat_index_c": "NA",
		"windchill_string": "NA",
		"windchill_f": "NA",
		"windchill_c": "NA",
		"visibility_mi": "N/A",
		"visibility_km": "N/A",
		"icon": "clear",
		"icon_url": "http://icons-ak.wxug.com/i/c/k/nt_clear.gif",
		"forecast_url": "http://www.wunderground.com/global/stations/94767.html",
		"history_url": "http://www.wunderground.com/history/airport/YSSY/2011/9/22/DailyHistory.html",
		"ob_url": "http://www.wunderground.com/cgi-bin/findweather/getForecast?query=-33.95000076,151.17999268"
	}
	,
	"forecast": {
		"txt_forecast": {
			"date": "10:00 AM EST",
			"forecastday": [
				{
					"period": 0,
					"icon": "clear",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
					"title": "Thursday",
					"fcttext": "Clear. High of 73°F. Winds from the WNW at 5-15 mph shifting to the NE in the afternoon.",
					"fcttext_metric": "Clear. High of 23°C. Winds from the WNW at 5-25 km/h shifting to the NE in the afternoon.",
					"pop": "0"
				},
				{
					"period": 1,
					"icon": "partlycloudy",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif",
					"title": "Thursday Night",
					"fcttext": "Mostly cloudy in the evening, then partly cloudy. Low of 54°F. Winds from the North at 5-20 mph.",
					"fcttext_metric": "Mostly cloudy in the evening, then partly cloudy. Low of 12°C. Winds from the North at 10-30 km/h.",
					"pop": "0"
				},
				{
					"period": 2,
					"icon": "clear",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
					"title": "Friday",
					"fcttext": "Partly cloudy in the morning, then clear. High of 86°F. Winds from the NNW at 5 mph.",
					"fcttext_metric": "Partly cloudy in the morning, then clear. High of 30°C. Winds from the NNW at 10 km/h.",
					"pop": "0"
				},
				{
					"period": 3,
					"icon": "mostlycloudy",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/mostlycloudy.gif",
					"title": "Friday Night",
					"fcttext": "Partly cloudy in the evening, then overcast. Low of 57°F. Winds from the ESE at 15 mph.",
					"fcttext_metric": "Partly cloudy in the evening, then overcast. Low of 14°C. Winds from the ESE at 20-35 km/h.",
					"pop": "0"
				},
				{
					"period": 4,
					"icon": "chancerain",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/chancerain.gif",
					"title": "Saturday",
					"fcttext": "Overcast in the morning, then mostly cloudy with a chance of rain. High of 68°F. Winds from the SE at 10 mph. Chance of rain 40%.",
					"fcttext_metric": "Overcast in the morning, then mostly cloudy with a chance of rain. High of 20°C. Winds from the SE at 15-25 km/h. Chance of rain 40% with rainfall amounts near 4 mm.",
					"pop": "40"
				},
				{
					"period": 5,
					"icon": "chancetstorms",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/chancetstorms.gif",
					"title": "Saturday Night",
					"fcttext": "Overcast with a chance of a thunderstorm in the evening, then mostly cloudy with a chance of rain. Low of 55°F. Winds from the SE at 15 mph. Chance of rain 40%.",
					"fcttext_metric": "Overcast with a chance of a thunderstorm in the evening, then mostly cloudy with a chance of rain. Low of 13°C. Winds from the SE at 25 km/h. Chance of rain 40% with rainfall amounts near 3 mm.",
					"pop": "40"
				}
			]
		},
		"simpleforecast": {
			"forecastday": [
				{
					"date": {
						"epoch": "1316692800",
						"pretty": "10:00 PM EST on September 22, 2011",
						"day": 22,
						"month": 9,
						"year": 2011,
						"yday": 264,
						"hour": 22,
						"min": "00",
						"sec": 0,
						"isdst": "0",
						"monthname": "September",
						"weekday_short": "Thu",
						"weekday": "Thursday",
						"ampm": "PM",
						"tz_short": "EST",
						"tz_long": "Australia/Sydney"
					},
					"period": 1,
					"high": {
						"fahrenheit": "73",
						"celsius": "23"
					},
					"low": {
						"fahrenheit": "54",
						"celsius": "12"
					},
					"conditions": "Clear",
					"icon": "clear",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
					"skyicon": "mostlysunny",
					"pop": 0
				},
				{
					"date": {
						"epoch": "1316779200",
						"pretty": "10:00 PM EST on September 23, 2011",
						"day": 23,
						"month": 9,
						"year": 2011,
						"yday": 265,
						"hour": 22,
						"min": "00",
						"sec": 0,
						"isdst": "0",
						"monthname": "September",
						"weekday_short": "Fri",
						"weekday": "Friday",
						"ampm": "PM",
						"tz_short": "EST",
						"tz_long": "Australia/Sydney"
					},
					"period": 2,
					"high": {
						"fahrenheit": "86",
						"celsius": "30"
					},
					"low": {
						"fahrenheit": "57",
						"celsius": "14"
					},
					"conditions": "Clear",
					"icon": "clear",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
					"skyicon": "mostlysunny",
					"pop": 0
				},
				{
					"date": {
						"epoch": "1316865600",
						"pretty": "10:00 PM EST on September 24, 2011",
						"day": 24,
						"month": 9,
						"year": 2011,
						"yday": 266,
						"hour": 22,
						"min": "00",
						"sec": 0,
						"isdst": "0",
						"monthname": "September",
						"weekday_short": "Sat",
						"weekday": "Saturday",
						"ampm": "PM",
						"tz_short": "EST",
						"tz_long": "Australia/Sydney"
					},
					"period": 3,
					"high": {
						"fahrenheit": "68",
						"celsius": "20"
					},
					"low": {
						"fahrenheit": "55",
						"celsius": "13"
					},
					"conditions": "Chance of Rain",
					"icon": "chancerain",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/chancerain.gif",
					"skyicon": "partlycloudy",
					"pop": 40
				},
				{
					"date": {
						"epoch": "1316952000",
						"pretty": "10:00 PM EST on September 25, 2011",
						"day": 25,
						"month": 9,
						"year": 2011,
						"yday": 267,
						"hour": 22,
						"min": "00",
						"sec": 0,
						"isdst": "0",
						"monthname": "September",
						"weekday_short": "Sun",
						"weekday": "Sunday",
						"ampm": "PM",
						"tz_short": "EST",
						"tz_long": "Australia/Sydney"
					},
					"period": 4,
					"high": {
						"fahrenheit": "66",
						"celsius": "19"
					},
					"low": {
						"fahrenheit": "54",
						"celsius": "12"
					},
					"conditions": "Chance of Rain",
					"icon": "chancerain",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/chancerain.gif",
					"skyicon": "mostlycloudy",
					"pop": 60
				},
				{
					"date": {
						"epoch": "1317038400",
						"pretty": "10:00 PM EST on September 26, 2011",
						"day": 26,
						"month": 9,
						"year": 2011,
						"yday": 268,
						"hour": 22,
						"min": "00",
						"sec": 0,
						"isdst": "0",
						"monthname": "September",
						"weekday_short": "Mon",
						"weekday": "Monday",
						"ampm": "PM",
						"tz_short": "EST",
						"tz_long": "Australia/Sydney"
					},
					"period": 5,
					"high": {
						"fahrenheit": "72",
						"celsius": "22"
					},
					"low": {
						"fahrenheit": "59",
						"celsius": "15"
					},
					"conditions": "Chance of Rain",
					"icon": "chancerain",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/chancerain.gif",
					"skyicon": "mostlycloudy",
					"pop": 50
				},
				{
					"date": {
						"epoch": "1317124800",
						"pretty": "10:00 PM EST on September 27, 2011",
						"day": 27,
						"month": 9,
						"year": 2011,
						"yday": 269,
						"hour": 22,
						"min": "00",
						"sec": 0,
						"isdst": "0",
						"monthname": "September",
						"weekday_short": "Tue",
						"weekday": "Tuesday",
						"ampm": "PM",
						"tz_short": "EST",
						"tz_long": "Australia/Sydney"
					},
					"period": 6,
					"high": {
						"fahrenheit": "79",
						"celsius": "26"
					},
					"low": {
						"fahrenheit": "61",
						"celsius": "16"
					},
					"conditions": "Clear",
					"icon": "clear",
					"icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif",
					"skyicon": "sunny",
					"pop": 0
				}
			]
		}
	}
}

Show Response

Example (ambiguous result):

http://api.wunderground.com/api/YOUR-KEY/geolookup/conditions/forecast/q/Allentown.json

{
	"response": {
		"version": "0.1",
		"termsofService": "http://www.wunderground.com/weather/api/d/terms.html",
		"features": {
			"geolookup": 1,
			"conditions": 1,
			"forecast": 1
		},
		"results": [
			{
				"name": "Allentown",
				"city": "Allentown",
				"state": "GA",
				"country": "US",
				"zmw": "31003.1.99999",
				"l": "/q/zmw:31003.1.99999"
			},
			{
				"name": "Allentown",
				"city": "Allentown",
				"state": "NJ",
				"country": "US",
				"zmw": "08501.1.99999",
				"l": "/q/zmw:08501.1.99999"
			},
			{
				"name": "Allentown",
				"city": "Allentown",
				"state": "NY",
				"country": "US",
				"zmw": "14707.1.99999",
				"l": "/q/zmw:14707.1.99999"
			},
			{
				"name": "Allentown",
				"city": "Allentown",
				"state": "PA",
				"country": "US",
				"zmw": "18101.1.99999",
				"l": "/q/zmw:18101.1.99999"
			}
		]
	}
}

Example (parsing ambiguous results):

When the API location query does not produce an exact location match, a "results" array will be present in the JSON response. Each result object has an "l" parameter (short for "link") that can be used for constructing wunderground URLs:

http://api.wunderground.com/api/YOUR-KEY/forecast/q/zmw:31003.1.99999.json

API Request Console by Apigee

Autocomplete API

Request URL format

http://autocomplete.wunderground.com/aq?query=QUERY&format=JSON

Options (append to URL)

specify country code: &c=US
include hurricanes in results: &h=1
only show hurricanes in results: &h=1&cities=0
jsonp callback: &cb=myCallbackName

Examples

Cities

http://autocomplete.wunderground.com/aq?query=San%20F&format=JSON


{ "RESULTS": [
	{
		"name": "San Francisco, California", 
		"type": "city", 
		"c": "US",
		"zmw": "94125.1.99999",
		"tz": "America/Los_Angeles",
		"tzs": "PDT",
		"l": "/q/zmw:94125.1.99999"
	},
	{
		"name": "San Fernando del Valle de Catamarca, Argentina", 
		"type": "city", 
		"c": "AR",
		"zmw": "00000.5.87222",
		"tz": "America/Argentina/La_Rioja",
		"tzs": "ART",
		"l": "/q/zmw:00000.5.87222"
	},
	{
		"name": "San Felipe de Puerto Plata, Dominican Republic", 
		"type": "city", 
		"c": "DO",
		"zmw": "00000.11.78458",
		"tz": "America/Santo_Domingo",
		"tzs": "AST",
		"l": "/q/zmw:00000.11.78458"
	},
	...

Hurricanes

http://autocomplete.wunderground.com/aq?query=Kat&format=JSON&h=1&cities=0


{ "RESULTS": [
	{
		"name": "Katrina, Major Hurricane - Atlantic, 2005", 
		"type": "hurricanes", 
		"date": "8/23/2005",
		"strmnum": "11",
		"basin": "at",
		"damage": "81000",
		"l": "/hurricane/at200511.asp"
	},
	{
		"name": "Katie, Major Hurricane - Atlantic, 1955", 
		"type": "hurricanes", 
		"date": "10/14/1955",
		"strmnum": "12",
		"basin": "at",
		"damage": "0",
		"l": "/hurricane/at195512.asp"
	},
	{
		"name": "Kate, Major Hurricane - Atlantic, 1985", 
		"type": "hurricanes", 
		"date": "11/15/1985",
		"strmnum": "11",
		"basin": "at",
		"damage": "0",
		"l": "/hurricane/at198511.asp"
	},
	...

Using the results

Each autocomplete result object has an "l" parameter (short for "link") that can be used for constructing wunderground URLs:

Cities: http://www.wunderground.com/q/zmw:94125.1.99999 http://api.wunderground.com/api/YOUR-KEY/forecast/q/zmw:94125.1.99999.json Hurricanes: http://www.wunderground.com/hurricane/at200511.asp

WunderMap Layers: Radar

Request URL format

http://api.wunderground.com/api/KEY/FEATURE/image.FORMAT?PARAMS

http://api.wunderground.com/api/KEY/FEATURE/q/QUERY.FORMAT?PARAMS

Definitions:

KEY

your unique API key

FEATURE

radar (single frame)
animatedradar (6-frame animation by default; must be 'gif' or 'swf' format)

FORMAT

output format

PARAMS

key	value	description
You can position your radar image with either a bounding box:
minlat maxlat minlon maxlon	-90.0 to 90.0 -180.0 to 180.0	minimum and maximum latitude bounds minimum and maximum longitude bounds
OR, you can position your radar image with a center lat/lon:
centerlat centerlon radius radunits	-90.0 to 90.0 -180.0 to 180.0 100 is close, 1000 is country nm (default), or km	center latitude center longitude radius distance from center to edge (optional) radius units: nautical miles or kilometers
width height		width of image in pixels height of image in pixels
newmaps	0 (default) or 1	transparent image (default) or show basemap
rainsnow	0 (default) or 1	use a different color palette to show rain/mix/snow
smooth	0 (default) or 1	smooth the colors
reproj.automerc	1	use Mercator projection. (omit this parameter for lat/lon projection, default)
frame	0 (default) to 5	which frame to display: 0 is most current, 1 is the previous, moving back through time
num	1 (default) to 15	number of frames in the animation • format must be 'gif' or 'swf' for animations • feature must be 'animatedradar' for animations
delay	25 (default) to 100	the duration of a radar frame in an animation, in hundredths of a second.
timelabel timelabel.x timelabel.y	0 (default) or 1 0 to width 0 to height	display the time of the radar frame pixels from left pixels from top

QUERY

location query (see regular documentation above)

Examples

Using lat/lon bounds to determine a box:

http://api.wunderground.com/api/YOUR-KEY/radar/image.gif?maxlat=42.35&maxlon=-109.311&minlat=39.27&minlon=-114.644&width=600&height=480&newmaps=1

Using center lat/lon to determine a box:

http://api.wunderground.com/api/YOUR-KEY/radar/image.gif?centerlat=38&centerlon=-96.4&radius=100&width=280&height=280&newmaps=1

Using location query to determine a box: http://api.wunderground.com/api/YOUR-KEY/radar/q/KS/Topeka.gif?width=280&height=280&newmaps=1
Animated radar using location query:

http://api.wunderground.com/api/YOUR-KEY/animatedradar/q/MI/Ann_Arbor.gif?newmaps=1&timelabel=1&timelabel.y=10&num=5&delay=50

Using lat/lon bounds, showing time label, transparent background:

http://api.wunderground.com/api/YOUR-KEY/radar/image.gif?maxlat=47.709&maxlon=-69.263&minlat=31.596&minlon=-97.388&width=640&height=480&rainsnow=1&timelabel=1&timelabel.x=525&timelabel.y=41&reproj.automerc=1

Language Support

To modify the language that the API returns add the Feature Id "/lang:XY/", where XY is a two letter language code.

If /lang:xy/ is omitted from the API request then English will be returned by default.

Example of a request in French

http://api.wunderground.com/api/YOUR-KEY/geolookup/conditions/forecast/lang:FR/q/France/Paris.json

Language codes


		"AF" = Afrikaans

		"AL" = Albanian

		"AR" = Arabic

		"HY" = Armenian

		"AZ" = Azerbaijani

		"EU" = Basque

		"BY" = Belarusian

		"BU" = Bulgarian

		"LI" = British English

		"MY" = Burmese

		"CA" = Catalan

		"CN" = Chinese - Simplified

		"TW" = Chinese - Traditional

		"CR" = Croatian

		"CZ" = Czech

		"DK" = Danish

		"DV" = Dhivehi

		"NL" = Dutch

		"EN" = English

		"EO" = Esperanto

		"ET" = Estonian

		"FA" = Farsi

		"FI" = Finnish

		"FR" = French

		"FC" = French Canadian

		"GZ" = Galician

		"DL" = German

		"KA" = Georgian

		"GR" = Greek

		"GU" = Gujarati

		"HT" = Haitian Creole

		"IL" = Hebrew

		"HI" = Hindi

		"HU" = Hungarian

		"IS" = Icelandic

		"IO" = Ido

		"ID" = Indonesian

		"IR" = Irish Gaelic

		"IT" = Italian

		"JP" = Japanese

		"JW" = Javanese

		"KM" = Khmer

		"KR" = Korean

		"KU" = Kurdish

		"LA" = Latin

		"LV" = Latvian

		"LT" = Lithuanian

		"ND" = Low German

		"MK" = Macedonian

		"MT" = Maltese

		"GM" = Mandinka

		"MI" = Maori

		"MR" = Marathi

		"MN" = Mongolian

		"NO" = Norwegian

		"OC" = Occitan

		"PS" = Pashto

		"GN" = Plautdietsch

		"PL" = Polish

		"BR" = Portuguese

		"PA" = Punjabi

		"RO" = Romanian

		"RU" = Russian

		"SR" = Serbian

		"SK" = Slovak

		"SL" = Slovenian

		"SP" = Spanish

		"SI" = Swahili

		"SW" = Swedish

		"CH" = Swiss

		"TL" = Tagalog

		"TT" = Tatarish

		"TH" = Thai

		"TR" = Turkish

		"TK" = Turkmen

		"UA" = Ukrainian

		"UZ" = Uzbek

		"VU" = Vietnamese

		"CY" = Welsh

		"SN" = Wolof

		"JI" = Yiddish - transliterated

		"YI" = Yiddish - unicode

Code Samples

Show Code

PHP


<?php
$json_string = file_get_contents("http://api.wunderground.com/api/abcdefgh12345678/geolookup/conditions/q/IA/Cedar_Rapids.json");
$parsed_json = json_decode($json_string);
$location = $parsed_json->{'location'}->{'city'};
$temp_f = $parsed_json->{'current_observation'}->{'temp_f'};
echo "Current temperature in ${location} is: ${temp_f}\n";
?>

Show Code

Ruby


require 'open-uri'
require 'json'

open('http://api.wunderground.com/api/abcdefgh12345678/geolookup/conditions/q/IA/Cedar_Rapids.json') do |f|
	json_string = f.read
	parsed_json = JSON.parse(json_string)
	location = parsed_json['location']['city']
	temp_f = parsed_json['current_observation']['temp_f']
	print "Current temperature in #{location} is: #{temp_f}\n"
end

Show Code

Python


import urllib2
import json

f = urllib2.urlopen('http://api.wunderground.com/api/abcdefgh12345678/geolookup/conditions/q/IA/Cedar_Rapids.json')
json_string = f.read()
parsed_json = json.loads(json_string)
location = parsed_json['location']['city']
temp_f = parsed_json['current_observation']['temp_f']
print "Current temperature in %s is: %s" % (location, temp_f)
f.close()

Show Code

ColdFusion


<cfhttp url="http://api.wunderground.com/api/abcdefgh12345678/geolookup/conditions/q/IA/Cedar_Rapids.json">
<cfset parsed_json = deserializeJSON(cfhttp.fileContent)>
<cfset location = parsed_json.location.city>
<cfset temp_f = parsed_json.current_observation.temp_f>
<cfoutput>Current temperature in #location# is #temp_f#</cfoutput>

Show Code

Javascript with jQuery


<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.min.js"></script>
<script type="text/javascript">
jQuery(document).ready(function($) {
	$.ajax({
		url: "http://api.wunderground.com/api/abcdefgh12345678/geolookup/conditions/q/IA/Cedar_Rapids.json",
		dataType: "jsonp",
		success: function(parsed_json) {
			var location = parsed_json['location']['city'];
			var temp_f = parsed_json['current_observation']['temp_f'];
			alert("Current temperature in "+location+" is: " + temp_f);
		}
	});
});
</script>

User-Generated Code

A fast small command-line application that retrieves weather data from Weather Underground

Submitted by developer Stephen Ramsay
https://github.com/sramsay/wu

MetaWatch Manager for Android

Submitted by developer @benjymous
https://github.com/benjymous/MWM-for-Android

A Clojure library for working with the Wunderground API

Submitted by Anthony Grimes
https://github.com/Raynes/ororo

A wrapper in Ruby for interacting with the Wunderground API

Submitted by developer Winfred Nadeau
https://github.com/wnadeau/wunderground_ruby

A Ruby Gem for the Wunderground API

submitted by Cameron Cundiff
https://github.com/ckundo/wunderful

Using the Alerts Feature

A Guide to using the National Weather Service issued Alerts in the USA

NOAA Office of Climate/Water/Weather Services (129KB PDF)
http://ocwws.weather.gov/intranet/whfs/RiverPro/VTECexplanation.pdf

Field Descriptions & Phrases

Note that values will = -9999 or -999 for Null or Non applicable (NA) variables


		[tempm] => Temp in C

		[tempi] => Temp in F

		[dewptm] =>Dewpoint in C

		[dewpti] => Duepoint in F

		[hum] => Humidity %

		[wspdm] => WindSpeed kph

		[wspdi] => Windspeed in mph

		[wgustm] => Wind gust in kph 

		[wgusti] => Wind gust in mph

		[wdird] => Wind direction in degrees

		[wdire] => Wind direction description (ie, SW, NNE)

		[vism] => Visibility in Km

		[visi] => Visability in Miles

		[pressurem] => Pressure in mBar

		[pressurei] => Pressure in inHg

		[windchillm] => Wind chill in C 

		[windchilli] => Wind chill in F

		[heatindexm] => Heat index C 

		[heatindexi] => Heat Index F

		[precipm] => Precipitation in mm 

		[precipi] => Precipitation in inches 

		[pop] => Probability of Precipitation

		[conds] => See possible condition phrases below

Wind Direction Phrases


		These are the directions the wind will be blowing from.
		
		East
		ENE => East-northeast
		ESE => East-southeast
		NE => Northeast
		NNE => North-northeast
		NNW => North-northwest
		North
		NW => Northwest
		SE => Southeast
		South
		SSE => South-southeast
		SSW => South-southwest
		SW => Southwest
		Variable
		West
		WNW => West-northwest
		WSW => West-southwest

Current Condition Phrases


		
		The following conditions are Light, Heavy, or normal which has no classifier.
		
		[Light/Heavy] Drizzle
		[Light/Heavy] Rain
		[Light/Heavy] Snow
		[Light/Heavy] Snow Grains
		[Light/Heavy] Ice Crystals
		[Light/Heavy] Ice Pellets
		[Light/Heavy] Hail
		[Light/Heavy] Mist
		[Light/Heavy] Fog
		[Light/Heavy] Smoke
		[Light/Heavy] Volcanic Ash
		[Light/Heavy] Widespread Dust
		[Light/Heavy] Sand
		[Light/Heavy] Haze
		[Light/Heavy] Spray
		[Light/Heavy] Dust Whirls
		[Light/Heavy] Sandstorm
		[Light/Heavy] Low Drifting Snow
		[Light/Heavy] Low Drifting Widespread Dust
		[Light/Heavy] Low Drifting Sand
		[Light/Heavy] Blowing Snow
		[Light/Heavy] Blowing Widespread Dust
		[Light/Heavy] Blowing Sand
		[Light/Heavy] Rain Mist
		[Light/Heavy] Rain Showers
		[Light/Heavy] Snow Showers
		[Light/Heavy] Ice Pellet Showers
		[Light/Heavy] Hail Showers
		[Light/Heavy] Small Hail Showers
		[Light/Heavy] Thunderstorm
		[Light/Heavy] Thunderstorms and Rain
		[Light/Heavy] Thunderstorms and Snow
		[Light/Heavy] Thunderstorms and Ice Pellets
		[Light/Heavy] Thunderstorms with Hail
		[Light/Heavy] Thunderstorms with Small Hail
		[Light/Heavy] Freezing Drizzle
		[Light/Heavy] Freezing Rain
		[Light/Heavy] Freezing Fog
		
		Patches of Fog
		Shallow Fog
		Overcast
		Clear
		Partly Cloudy
		Mostly Cloudy
		Scattered Clouds
		Unknown

Forecast Description Phrases

Phrase	Icon Name	Icon Image (Icon Gallery)
Chance of Flurries	chanceflurries
Chance of Rain	chancerain
Chance of Freezing Rain	chancesleet
Chance of Sleet	chancesleet
Chance of Snow	chancesnow
Chance of Thunderstorms	chancetstorms
Chance of a Thunderstorm	chancetstorms
Clear	clear
Cloudy	cloudy
Flurries	flurries
Fog	fog
Haze	hazy
Mostly Cloudy	mostlycloudy
Mostly Sunny	mostlysunny
Partly Cloudy	partlycloudy
Partly Sunny	partlysunny
Freezing Rain	sleet
Rain	rain
Sleet	sleet
Snow	snow
Sunny	sunny
Thunderstorms	tstorms
Thunderstorm	tstorms
Unknown	unknown
Overcast	cloudy
Scattered Clouds	partlycloudy

Logo Usage Guide

These guidelines apply to all Weather Underground Logos found on this page with exceptions noted in the individual Logo entries below.

Usage
Please see individual Logo variations below for all acceptable combinations of layout and color. Find out more about Weather Underground, Inc.

Trademark Information
Proper trademarks and credit lines must be used with Weather Underground corporate Logos. Weather Underground is a registered trademark of Weather Underground, Inc. both in the United States and internationally. The Weather Underground Logo is a trademark of Weather Underground, Inc.

Original Logo

4-Color Logo

Standard: JPG, PNG, EPS

Horizontal: JPG, PNG, EPS

Alternative Logos

The following alternative Logos may be used for applications in which the Standard Logo is unsuitable according to the guidelines specified in this guide.

1-Color Blue Logo

Standard: JPG, PNG, EPS

Horizontal: JPG, PNG, EPS

1-Color Black Logo

Standard: JPG, PNG, EPS

Horizontal: JPG, PNG, EPS

1-Color White Logo

(available in PNG and EPS formats only)

Standard: PNG, EPS

Horizontal: PNG, EPS

Elements of the Logo

The Logo comprises three elements: the Rainbow, the URL, and the Trademark.

Logo Versions

When choosing between Standard and Horizontal Logos, use the Logo that best fills the allotted space and allows the URL to appear as large as possible.

Clear Space Requirements

The Logo must have sufficient clear space separating it from surrounding elements.

clear space

Minimum Width and Height

In order to ensure legibility, there is a fixed minimum size to which the Logo may be scaled down.

The Standard Logo may be scaled down to 3/4" (54px at 72dpi).
The Horizontal Logo may be scaled down to 1 3/4" (126px at 72dpi).

All usage, color, and clearspace rules apply.

Color

The 4-Color Logo may appear in its native CMYK or be converted to RGB as needed. It should never be converted to black and white or grayscale. For applications in which a spot color is needed, the 1-Color Logo may be converted to PMS 660. The following values may be substituted as necessary:

Accepted Backgrounds

The 4-Color Logo may be used only on white.
The 1-Color Blue Logo may be used only on white or light neutral backgrounds.
The 1-Color Black Logo may only be used on white or light backgrounds, including backgrounds with faint photographic or patterned elements.
The 1-Color White Logo may only be used on black or dark backgrounds, including backgrounds with very dark photographic or patterned elements.

When choosing Logos, take care to ensure that there is as much contrast between the Logo and background as possible.

Incorrect Usage

Do not use the Logo on busy nor bright backgrounds, nor on backgrounds with similar colors as the Logo. Always endeavor to maximize contrast between the Logo and background.

Unacceptable Backgrounds

Do not use the 4-Color Logo on any background other than solid white.
Do not use the the 1-Color Blue Logo on any background other than solid white or pale neutral.
Do not use the 1-Color Black Logo on any background other than white or very pale solid, patterned, or photographic elements.
Do not use the 1-Color White Logo on any background other than black or very dark solid, patterned, or photographic elements.

Unacceptable Manipulation

Do not change the color of any part of the Logo, unless specifically permitted according to the Color section of this guide.
Do not apply affects to the Logo.
Do not stretch, squeeze, warp, or rotate the Logo.
Do not alter the Logo in any way.

Gallery of Icons

Icon Set #1

Icon URL example:

http://icons.wxug.com/i/c/a/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/a/ICON.gif

Daytime

http://icons.wxug.com/i/c/a/chanceflurries.gif

http://icons.wxug.com/i/c/a/chancerain.gif

http://icons.wxug.com/i/c/a/chancesleet.gif

http://icons.wxug.com/i/c/a/chancesnow.gif

http://icons.wxug.com/i/c/a/chancetstorms.gif

http://icons.wxug.com/i/c/a/flurries.gif

http://icons.wxug.com/i/c/a/mostlycloudy.gif

http://icons.wxug.com/i/c/a/mostlysunny.gif

http://icons.wxug.com/i/c/a/partlycloudy.gif

http://icons.wxug.com/i/c/a/partlysunny.gif

Nightime

Icon Set #2

Icon URL example:

http://icons.wxug.com/i/c/b/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/b/ICON.gif

Daytime

http://icons.wxug.com/i/c/b/chanceflurries.gif

http://icons.wxug.com/i/c/b/chancerain.gif

http://icons.wxug.com/i/c/b/chancesleet.gif

http://icons.wxug.com/i/c/b/chancesnow.gif

http://icons.wxug.com/i/c/b/chancetstorms.gif

http://icons.wxug.com/i/c/b/flurries.gif

http://icons.wxug.com/i/c/b/mostlycloudy.gif

http://icons.wxug.com/i/c/b/mostlysunny.gif

http://icons.wxug.com/i/c/b/partlycloudy.gif

http://icons.wxug.com/i/c/b/partlysunny.gif

Nightime

Icon Set #3

Icon URL example:

http://icons.wxug.com/i/c/c/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/c/ICON.gif

Daytime

http://icons.wxug.com/i/c/c/chanceflurries.gif

http://icons.wxug.com/i/c/c/chancerain.gif

http://icons.wxug.com/i/c/c/chancesleet.gif

http://icons.wxug.com/i/c/c/chancesnow.gif

http://icons.wxug.com/i/c/c/chancetstorms.gif

http://icons.wxug.com/i/c/c/flurries.gif

http://icons.wxug.com/i/c/c/mostlycloudy.gif

http://icons.wxug.com/i/c/c/mostlysunny.gif

http://icons.wxug.com/i/c/c/partlycloudy.gif

http://icons.wxug.com/i/c/c/partlysunny.gif

Nightime

Icon Set #4

Icon URL example:

http://icons.wxug.com/i/c/d/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/d/ICON.gif

Daytime

http://icons.wxug.com/i/c/d/chanceflurries.gif

http://icons.wxug.com/i/c/d/chancerain.gif

http://icons.wxug.com/i/c/d/chancesleet.gif

http://icons.wxug.com/i/c/d/chancesnow.gif

http://icons.wxug.com/i/c/d/chancetstorms.gif

http://icons.wxug.com/i/c/d/flurries.gif

http://icons.wxug.com/i/c/d/mostlycloudy.gif

http://icons.wxug.com/i/c/d/mostlysunny.gif

http://icons.wxug.com/i/c/d/partlycloudy.gif

http://icons.wxug.com/i/c/d/partlysunny.gif

Nightime

Icon Set #5

Icon URL example:

http://icons.wxug.com/i/c/e/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/e/ICON.gif

Daytime

http://icons.wxug.com/i/c/e/chanceflurries.gif

http://icons.wxug.com/i/c/e/chancerain.gif

http://icons.wxug.com/i/c/e/chancesleet.gif

http://icons.wxug.com/i/c/e/chancesnow.gif

http://icons.wxug.com/i/c/e/chancetstorms.gif

http://icons.wxug.com/i/c/e/flurries.gif

http://icons.wxug.com/i/c/e/mostlycloudy.gif

http://icons.wxug.com/i/c/e/mostlysunny.gif

http://icons.wxug.com/i/c/e/partlycloudy.gif

http://icons.wxug.com/i/c/e/partlysunny.gif

Nightime

Icon Set #6

Icon URL example:

http://icons.wxug.com/i/c/f/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/f/ICON.gif

Daytime

http://icons.wxug.com/i/c/f/chanceflurries.gif

http://icons.wxug.com/i/c/f/chancerain.gif

http://icons.wxug.com/i/c/f/chancesleet.gif

http://icons.wxug.com/i/c/f/chancesnow.gif

http://icons.wxug.com/i/c/f/chancetstorms.gif

http://icons.wxug.com/i/c/f/flurries.gif

http://icons.wxug.com/i/c/f/mostlycloudy.gif

http://icons.wxug.com/i/c/f/mostlysunny.gif

http://icons.wxug.com/i/c/f/partlycloudy.gif

http://icons.wxug.com/i/c/f/partlysunny.gif

Nightime

Icon Set #7

Icon URL example:

http://icons.wxug.com/i/c/g/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/g/ICON.gif

Daytime

http://icons.wxug.com/i/c/g/chanceflurries.gif

http://icons.wxug.com/i/c/g/chancerain.gif

http://icons.wxug.com/i/c/g/chancesleet.gif

http://icons.wxug.com/i/c/g/chancesnow.gif

http://icons.wxug.com/i/c/g/chancetstorms.gif

http://icons.wxug.com/i/c/g/flurries.gif

http://icons.wxug.com/i/c/g/mostlycloudy.gif

http://icons.wxug.com/i/c/g/mostlysunny.gif

http://icons.wxug.com/i/c/g/partlycloudy.gif

http://icons.wxug.com/i/c/g/partlysunny.gif

Nightime

Icon Set #8

Icon URL example:

http://icons.wxug.com/i/c/h/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/h/ICON.gif

Daytime

http://icons.wxug.com/i/c/h/chanceflurries.gif

http://icons.wxug.com/i/c/h/chancerain.gif

http://icons.wxug.com/i/c/h/chancesleet.gif

http://icons.wxug.com/i/c/h/chancesnow.gif

http://icons.wxug.com/i/c/h/chancetstorms.gif

http://icons.wxug.com/i/c/h/flurries.gif

http://icons.wxug.com/i/c/h/mostlycloudy.gif

http://icons.wxug.com/i/c/h/mostlysunny.gif

http://icons.wxug.com/i/c/h/partlycloudy.gif

http://icons.wxug.com/i/c/h/partlysunny.gif

Nightime

Icon Set #9

Icon URL example:

http://icons.wxug.com/i/c/i/partlycloudy.gif

To use the icon path, insert the "icon" value in the in the image URL path:

http://icons.wxug.com/i/c/i/ICON.gif

Daytime

http://icons.wxug.com/i/c/i/chanceflurries.gif

http://icons.wxug.com/i/c/i/chancerain.gif

http://icons.wxug.com/i/c/i/chancesleet.gif

http://icons.wxug.com/i/c/i/chancesnow.gif

http://icons.wxug.com/i/c/i/chancetstorms.gif

http://icons.wxug.com/i/c/i/flurries.gif

http://icons.wxug.com/i/c/i/mostlycloudy.gif

http://icons.wxug.com/i/c/i/mostlysunny.gif

http://icons.wxug.com/i/c/i/partlycloudy.gif

http://icons.wxug.com/i/c/i/partlysunny.gif

Nightime

Country to ISO matching

Weather Underground uses different country codes than standard ISO. Here is the matching from Weather Underground counties to ISO countries.


		
		Wunderground Country Code = ISO Country code

AH = AF
AB = AL
AL = DZ
AS = AS
AD = AD
AN = AO
A1 = AI
AA = AQ
AT = AG
AG = AR
AM = AM
AW = AW
AU = AU
AU = AU
OS = AT
A2 = AZ
BS = BS
BN = BH
BW = BD
BR = BB
BY = BY
BX = BE
BH = BZ
BJ = BJ
BE = BM
B2 = BT
BO = BO
BA = BA
BC = BW
BV = BV
BZ = BR
BT = IO
BF = BN
BU = BG
HV = BF
BI = BI
KH = KH
CM = CM
CA = CA
CV = CV
GC = KY
CE = CF
CD = TD
CH = CL
CI = CN
CX = CX
CC = CC
CO = CO
IC = KM
CG = CG
CD = CD
KU = CK
CS = CR
IV = CI
RH = HR
CU = CU
CY = CY
CZ = CZ
DN = DK
DJ = DJ
DO = DM
DR = DO
EQ = EC
EG = EG
ES = SV
GQ = GQ
E1 = ER
EE = EE
ET = ET
FK = FK
FA = FO
FJ = FJ
FI = FI
FR = FR
FG = GF
PF = PF
TF = TF
GO = GA
GB = GM
GE = GE
DL = DE
GH = GH
GI = GI
GR = GR
GL = GL
GD = GD
GP = GP
GU = GU
GU = GT
GN = GN
GW = GW
GY = GY
HA = HT
HM = HM
VA = VA
HO = HN
HK = HK
HU = HU
IL = IS
IN = IN
ID = ID
IR = IR
IQ = IQ
IE = IE
IS = IL
IY = IT
JM = JM
JP = JP
JD = JO
KZ = KZ
KN = KE
KB = KI
KR = KP
KO = KR
KW = KW
KG = KG
LA = LA
LV = LV
LB = LB
LS = LS
LI = LR
LY = LY
LT = LI
L1 = LT
LU = LU
MU = MO
MK = MK
MG = MG
MW = MW
MS = MY
MV = MV
MI = ML
ML = MT
MH = MH
MP = MP
MR = MQ
MT = MR
MA = MU
YT = YT
MX = MX
US_FM = FM
M1 = MD
M3 = MC
MO = MN
M2 = MS
MC = MA
MZ = MZ
BM = MM
NM = NA
NW = NR
NP = NP
NL = NL
AN = AN
NZ = NZ
NC = NC
NK = NI
NR = NE
NI = NG
N1 = NU
XX_NF = NF
US_MP = MP
NO = NO
OM = OM
PK = PK
PW = PW
PS = PS
PM = PA
NG = PG
PY = PY
PR = PE
PH = PH
P2 = PN
PL = PL
PO = PT
PR = PR
QT = QA
RE = RE
RO = RO
RS = RU
RW = RW
HE = SH
K1 = KN
LC = LC
P1 = PM
VC = VC
ZM = WS
SM = SM
TP = ST
SD = SA
SG = SN
SC = SC
SL = SL
SR = SG
S1 = SK
LJ = SI
SO = SB
SI = SO
ZA = ZA
GS = GS
SP = ES
SB = LK
SU = SD
SM = SR
SJ = SJ
SV = SZ
SN = SE
SW = CH
SY = SY
TW = TW
TJ = TJ
TN = TZ
TH = TH
EA = TL
TG = TG
TK = TK
TO = TO
TD = TT
TS = TN
TU = TR
TM = TM
TI = TC
TV = TV
TB = TB
UG = UG
UR = UA
ER = AE
UK = UK
US = US
US_UM = UM
UY = UY
UZ = UZ
NH = VU
VN = VE
VS = VN
VG = VG
VI = VI
FW = WF
EH = EH
YE = YE
RB = RS
KV = KV
M4 = ME
ZB = ZM
ZW = ZW

Documentation Contents

How to make an API Request
API Request Console by Apigee
How to use the Location Autocomplete API
WunderMap Layers: Radar
Language Support
Code Samples
User-Generated Code
Using the Alerts Feature
Field Descriptions and Phrases
Current Condition Phrases
Forecast Description Phrases
Logo Usage Guide
Icon Gallery
Terms of Service

Logo Usage

Per the Terms of Service the Weather Underground logo must be included with credit line where Weather Underground data is displayed. Please see individual Logo variations for all acceptable combinations of layout and color. Read the full Logo Usage Guide.

Original Logo

Standard: JPG, PNG, EPS

More logos in the Logo Usage Guide.