API
API

Data Features: URL Format

Page Contents

Standard Request URL Format

Most API features can be accessed using the following format. Note that several features can be combined into a single request. Refer to the examples below and on each feature documentation page.

WunderMap layer requests return image files not textual data.

GET http://api.wunderground.com/api/Your_Key/features/settings/q/query.format
Your_Key
Your API key. You can request a key on the sign in page. This is used in most API calls (with the exception of the AutoComplete API).
features
One or more of the following data features. Note that these can be combined into a single request: geolookup/conditions/forecast
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.
almanac Historical average temperature for today
astronomy Returns the moon phase, sunrise and sunset times.
conditions Returns the current temperature, weather condition, humidity, wind, 'feels like' temperature, barometric pressure, and visibility.
currenthurricane Returns the current position, forecast, and track of all current hurricanes.
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.
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.
geolookup Returns the the city name, zip code / postal code, latitude-longitude coordinates and nearby personal weather stations.
history history_YYYYMMDD returns a summary of the observed weather for the specified date.
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
planner planner_MMDDMMDD returns a weather summary based on historical information between the specified dates (30 days max).
rawtide Raw Tidal information for graphs
tide Tidal information
webcams Returns locations of nearby Personal Weather Stations and URL's for images from their web cams.
yesterday Returns a summary of the observed weather history for yesterday.
settings
Optional
One or more of the following settings, given as key:value pairs separated by a colon. Example: lang:FR/pws:0
lang lang code Default: EN. Returns the API response in the specified language.
pws 0 or 1 Default: 1 (true). Use personal weather stations for conditions.
bestfct 0 or 1 Default: 1 (true). Use Weather Undergrond Best Forecast for forecast.
query
The location for which you want weather information. Examples:
CA/San_FranciscoUS state/city
60290US zipcode
Australia/Sydneycountry/city
37.8,-122.4latitude,longitude
KJFKairport code
pws:KCASANFR70PWS id
autoipAutoIP address location
autoip.json?geo_ip=38.102.136.138specific IP address location
format
json, or xml

Output format.

For JSONP, you may add ?callback=your_js_callback_function to the request URL

Examples

Try with Apigee

Note: replace {{key}} with Your_Key

US City

http://api.wunderground.com/api/Your_Key/forecast/geolookup/conditions/q/CA/San_Francisco.json Show Response
{ "response": { "version": "0.1", "termsofService": "http://www.wunderground.com/weather/api/d/terms.html", "features": { "forecast": 1, "geolookup": 1, "conditions": 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", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR49", "distance_km": 0, "distance_mi": 0 }, { "neighborhood": "SOMA", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR131", "distance_km": 0, "distance_mi": 0 }, { "neighborhood": "HADS SAN FRANCISCO DOWNTOWN CA US NWS", "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": "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": "Noe Valley", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR86", "distance_km": 2, "distance_mi": 1 }, { "neighborhood": "North Beach", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR137", "distance_km": 2, "distance_mi": 1 }, { "neighborhood": "Noe Valley", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR3", "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": "Diamond Heights", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR76", "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": "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": "Mid Richmond", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR128", "distance_km": 4, "distance_mi": 2 }, { "neighborhood": "Golden Gate Heights", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR46", "distance_km": 4, "distance_mi": 2 }, { "neighborhood": "Portola", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR135", "distance_km": 5, "distance_mi": 3 }, { "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": "West Portal", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR130", "distance_km": 5, "distance_mi": 3 }, { "neighborhood": "Forest Hill", "city": "San Francisco", "state": "CA", "country": "US", "id": "KCASANFR48", "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": "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 }] } } }, "current_observation": { "image": { "url": "http://icons-ak.wxug.com/graphics/wu2/logo_130x80.png", "title": "Weather Underground", "link": "http://www.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" }, "estimated": {}, "station_id": "KCASANFR58", "observation_time": "Last Updated on July 11, 11:36 AM PDT", "observation_time_rfc822": "Wed, 11 Jul 2012 11:36:43 -0700", "observation_epoch": "1342031803", "local_time_rfc822": "Wed, 11 Jul 2012 11:36:53 -0700", "local_epoch": "1342031813", "local_tz_short": "PDT", "local_tz_long": "America/Los_Angeles", "local_tz_offset": "-0700", "weather": "Partly Cloudy", "temperature_string": "64.6 F (18.1 C)", "temp_f": 64.6, "temp_c": 18.1, "relative_humidity": "69%", "wind_string": "From the NNW at 7.0 MPH Gusting to 12.0 MPH", "wind_dir": "NNW", "wind_degrees": 343, "wind_mph": 7.0, "wind_gust_mph": "12.0", "wind_kph": 11.3, "wind_gust_kph": "19.3", "pressure_mb": "1012", "pressure_in": "29.90", "pressure_trend": "+", "dewpoint_string": "54 F (12 C)", "dewpoint_f": 54, "dewpoint_c": 12, "heat_index_string": "NA", "heat_index_f": "NA", "heat_index_c": "NA", "windchill_string": "NA", "windchill_f": "NA", "windchill_c": "NA", "feelslike_string": "64.6 F (18.1 C)", "feelslike_f": "64.6", "feelslike_c": "18.1", "visibility_mi": "10.0", "visibility_km": "16.1", "solarradiation": "", "UV": "8", "precip_1hr_string": "0.00 in ( 0 mm)", "precip_1hr_in": "0.00", "precip_1hr_metric": " 0", "precip_today_string": "0.00 in (0 mm)", "precip_today_in": "0.00", "precip_today_metric": "0", "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "forecast_url": "http://www.wunderground.com/US/CA/San_Francisco.html", "history_url": "http://www.wunderground.com/history/airport/KCASANFR58/2012/7/11/DailyHistory.html", "ob_url": "http://www.wunderground.com/cgi-bin/findweather/getForecast?query=37.773285,-122.417725" }, "forecast": { "txt_forecast": { "date": "8:00 AM PDT", "forecastday": [{ "period": 0, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Wednesday", "fcttext": "Partly cloudy. Fog early. High of 81F. Winds from the WSW at 5 to 20 mph.", "fcttext_metric": "Partly cloudy. Fog early. High of 27C. Windy. Winds from the WSW at 5 to 30 km/h.", "pop": "0" }, { "period": 1, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Wednesday Night", "fcttext": "Partly cloudy. Low of 54F. Winds from the SW at 5 to 15 mph.", "fcttext_metric": "Partly cloudy. Low of 12C. Breezy. Winds from the SW at 10 to 25 km/h.", "pop": "0" }, { "period": 2, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Thursday", "fcttext": "Partly cloudy. High of 68F. Winds from the SW at 5 to 10 mph.", "fcttext_metric": "Partly cloudy. High of 20C. Breezy. Winds from the SW at 10 to 20 km/h.", "pop": "0" }, { "period": 3, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Thursday Night", "fcttext": "Mostly cloudy. Fog overnight. Low of 54F. Winds from the SW at 5 to 15 mph.", "fcttext_metric": "Mostly cloudy. Fog overnight. Low of 12C. Breezy. Winds from the SW 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": "Friday", "fcttext": "Mostly cloudy in the morning, then partly cloudy. Fog early. High of 70F. Breezy. Winds from the WSW at 10 to 20 mph.", "fcttext_metric": "Partly cloudy. Fog early. High of 21C. Windy. Winds from the WSW at 15 to 30 km/h.", "pop": "0" }, { "period": 5, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Friday Night", "fcttext": "Partly cloudy in the evening, then overcast. Fog overnight. Low of 54F. Winds from the SW at 5 to 10 mph.", "fcttext_metric": "Partly cloudy in the evening, then overcast. Fog overnight. Low of 12C. Winds from the SW at 5 to 15 km/h.", "pop": "0" }, { "period": 6, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Saturday", "fcttext": "Overcast in the morning, then partly cloudy. Fog early. High of 68F. Winds from the SW at 5 to 10 mph.", "fcttext_metric": "Overcast in the morning, then partly cloudy. Fog early. High of 20C. Winds from the SW at 10 to 15 km/h.", "pop": "0" }, { "period": 7, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Saturday Night", "fcttext": "Overcast in the evening, then mostly cloudy. Fog overnight. Low of 55F. Winds from the SW at 5 to 10 mph.", "fcttext_metric": "Mostly cloudy. Fog overnight. Low of 13C. Winds from the SW at 5 to 15 km/h.", "pop": "0" }] }, "simpleforecast": { "forecastday": [{ "date": { "epoch": "1342072800", "pretty": "11:00 PM PDT on July 11, 2012", "day": 11, "month": 7, "year": 2012, "yday": 192, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "July", "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": "sunny", "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": 17, "kph": 27, "dir": "WSW", "degrees": 244 }, "avewind": { "mph": 12, "kph": 19, "dir": "WSW", "degrees": 245 }, "avehumidity": 83, "maxhumidity": 97, "minhumidity": 68 }, { "date": { "epoch": "1342159200", "pretty": "11:00 PM PDT on July 12, 2012", "day": 12, "month": 7, "year": 2012, "yday": 193, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "July", "weekday_short": "Thu", "weekday": "Thursday", "ampm": "PM", "tz_short": "PDT", "tz_long": "America/Los_Angeles" }, "period": 2, "high": { "fahrenheit": "68", "celsius": "20" }, "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": 10, "kph": 16, "dir": "WSW", "degrees": 244 }, "avewind": { "mph": 8, "kph": 13, "dir": "WSW", "degrees": 237 }, "avehumidity": 80, "maxhumidity": 89, "minhumidity": 72 }, { "date": { "epoch": "1342245600", "pretty": "11:00 PM PDT on July 13, 2012", "day": 13, "month": 7, "year": 2012, "yday": 194, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "July", "weekday_short": "Fri", "weekday": "Friday", "ampm": "PM", "tz_short": "PDT", "tz_long": "America/Los_Angeles" }, "period": 3, "high": { "fahrenheit": "70", "celsius": "21" }, "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": 17, "kph": 27, "dir": "West", "degrees": 260 }, "avewind": { "mph": 13, "kph": 21, "dir": "WSW", "degrees": 247 }, "avehumidity": 86, "maxhumidity": 93, "minhumidity": 65 }, { "date": { "epoch": "1342332000", "pretty": "11:00 PM PDT on July 14, 2012", "day": 14, "month": 7, "year": 2012, "yday": 195, "hour": 23, "min": "00", "sec": 0, "isdst": "1", "monthname": "July", "weekday_short": "Sat", "weekday": "Saturday", "ampm": "PM", "tz_short": "PDT", "tz_long": "America/Los_Angeles" }, "period": 4, "high": { "fahrenheit": "68", "celsius": "20" }, "low": { "fahrenheit": "55", "celsius": "13" }, "conditions": "Fog", "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": 9, "kph": 14, "dir": "WSW", "degrees": 246 }, "avewind": { "mph": 7, "kph": 11, "dir": "WSW", "degrees": 238 }, "avehumidity": 84, "maxhumidity": 96, "minhumidity": 66 }] } } }

International City

http://api.wunderground.com/api/Your_Key/geolookup/conditions/forecast/q/Australia/Sydney.json Show Response
{ "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": "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": "Old\u0027s Park", "city": "Penshurst", "state": "NSW", "country": "AUSTRALIA", "id": "INSWPENS2", "distance_km": 9, "distance_mi": 5 }, { "neighborhood": "Cronulla - Cecil Apartments", "city": "Cronulla - Sydney", "state": "NSW", "country": "AUSTRALIA", "id": "INSWSYDN19", "distance_km": 11, "distance_mi": 7 }, { "neighborhood": "Caringbah South -The Shire", "city": "Sydney", "state": "NSW", "country": "Australia", "id": "INSWCARI2", "distance_km": 12, "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": "", "city": "Chatswood", "state": "New South Wales", "country": "Australia", "id": "INSWCHAT1", "distance_km": 16, "distance_mi": 9 }, { "neighborhood": "Sutherland Shire", "city": "LOFTUS", "state": "NEW SOUTH WALES", "country": "AUSTRALIA", "id": "INEWSOUT125", "distance_km": 16, "distance_mi": 9 }, { "neighborhood": "Loftus Heights", "city": "Loftus", "state": "NSW", "country": "AUSTRALIA", "id": "INSWLOFT2", "distance_km": 16, "distance_mi": 10 }, { "neighborhood": "Chatswood", "city": "Sydney", "state": "NSW", "country": "AUSTRALIA", "id": "INSWSYDN21", "distance_km": 18, "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": "Epping", "city": "Epping", "state": "NSW", "country": "AUSTRALIA", "id": "INSWEPPI2", "distance_km": 21, "distance_mi": 13 }, { "neighborhood": "Moorebank", "city": "Moorebank", "state": "NSW", "country": "Australia", "id": "INSWMOOR1", "distance_km": 21, "distance_mi": 13 }, { "neighborhood": "", "city": "Telopea", "state": "NEW SOUTH WALES", "country": "Australia", "id": "INEWSOUT126", "distance_km": 21, "distance_mi": 13 }, { "neighborhood": "Sutherland Shire", "city": "Heathcote", "state": "New South Wales", "country": "Australia", "id": "INSWHEAT2", "distance_km": 22, "distance_mi": 13 }, { "neighborhood": "Merrylands West", "city": "Merrylands West", "state": "NSW", "country": "AUSTRALIA", "id": "INSWMERR3", "distance_km": 22, "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": "Beecroft", "city": "Beecroft", "state": "NSW", "country": "Australia", "id": "INSWBEEC1", "distance_km": 25, "distance_mi": 15 }, { "neighborhood": "West Pennant Hills", "city": "West Pennant Hills", "state": "NSW", "country": "Australia", "id": "INSWWEST1", "distance_km": 25, "distance_mi": 15 }] } } }, "current_observation": { "image": { "url": "http://icons-ak.wxug.com/graphics/wu2/logo_130x80.png", "title": "Weather Underground", "link": "http://www.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" }, "estimated": {}, "station_id": "YSSY", "observation_time": "Last Updated on July 12, 4:00 AM EST", "observation_time_rfc822": "Thu, 12 Jul 2012 04:00:00 +1000", "observation_epoch": "1342029600", "local_time_rfc822": "Thu, 12 Jul 2012 04:35:30 +1000", "local_epoch": "1342031730", "local_tz_short": "EST", "local_tz_long": "Australia/Sydney", "local_tz_offset": "+1000", "weather": "Clear", "temperature_string": "52 F (11 C)", "temp_f": 52, "temp_c": 11, "relative_humidity": "76%", "wind_string": "From the North at 6 MPH", "wind_dir": "North", "wind_degrees": 10, "wind_mph": 6, "wind_gust_mph": 0, "wind_kph": 9, "wind_gust_kph": 0, "pressure_mb": "1018", "pressure_in": "30.06", "pressure_trend": "0", "dewpoint_string": "45 F (7 C)", "dewpoint_f": 45, "dewpoint_c": 7, "heat_index_string": "NA", "heat_index_f": "NA", "heat_index_c": "NA", "windchill_string": "NA", "windchill_f": "NA", "windchill_c": "NA", "feelslike_string": "52 F (11 C)", "feelslike_f": "52", "feelslike_c": "11", "visibility_mi": "N/A", "visibility_km": "N/A", "solarradiation": "", "UV": "-1", "precip_1hr_string": "-9999.00 in (-9999.00 mm)", "precip_1hr_in": "-9999.00", "precip_1hr_metric": "-9999.00", "precip_today_string": "0.00 in (0.0 mm)", "precip_today_in": "0.00", "precip_today_metric": "0.0", "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/2012/7/12/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": "rain", "icon_url": "http://icons-ak.wxug.com/i/c/k/rain.gif", "title": "Thursday", "fcttext": "Overcast with rain. High of 66F. Winds from the NNW at 5 to 10 mph. Chance of rain 80% with rainfall amounts near 0.4 in. possible.", "fcttext_metric": "Overcast with rain. High of 19C. Winds from the NNW at 10 to 15 km/h. Chance of rain 80% with rainfall amounts near 10.7 mm possible.", "pop": "80" }, { "period": 1, "icon": "rain", "icon_url": "http://icons-ak.wxug.com/i/c/k/rain.gif", "title": "Thursday Night", "fcttext": "Overcast with a chance of rain, then rain after midnight. Low of 54F. Winds from the NNW at 5 to 10 mph. Chance of rain 80% with rainfall amounts near 0.3 in. possible.", "fcttext_metric": "Overcast with a chance of rain, then rain after midnight. Low of 12C. Winds from the NNW at 10 to 15 km/h. Chance of rain 80% with rainfall amounts near 7.4 mm possible.", "pop": "80" }, { "period": 2, "icon": "rain", "icon_url": "http://icons-ak.wxug.com/i/c/k/rain.gif", "title": "Friday", "fcttext": "Overcast with rain in the morning, then mostly cloudy. High of 70F. Winds from the NNW at 10 to 15 mph. Chance of rain 60%.", "fcttext_metric": "Overcast with rain in the morning, then mostly cloudy. High of 21C. Breezy. Winds from the NNW at 15 to 20 km/h. Chance of rain 60% with rainfall amounts near 0.5 mm possible.", "pop": "60" }, { "period": 3, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Friday Night", "fcttext": "Mostly cloudy in the evening, then partly cloudy. Low of 52F. Winds from the WNW at 5 to 15 mph.", "fcttext_metric": "Partly cloudy. Low of 11C. Breezy. Winds from the WNW 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": "Saturday", "fcttext": "Partly cloudy. High of 63F. Winds from the WNW at 10 to 15 mph.", "fcttext_metric": "Partly cloudy. High of 17C. Breezy. Winds from the WNW at 15 to 20 km/h.", "pop": "0" }, { "period": 5, "icon": "clear", "icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif", "title": "Saturday Night", "fcttext": "Clear. Low of 46F. Winds from the West at 10 to 15 mph.", "fcttext_metric": "Clear. Low of 8C. Breezy. Winds from the West at 15 to 20 km/h.", "pop": "0" }, { "period": 6, "icon": "partlycloudy", "icon_url": "http://icons-ak.wxug.com/i/c/k/partlycloudy.gif", "title": "Sunday", "fcttext": "Partly cloudy. High of 59F. Winds from the West at 10 to 15 mph.", "fcttext_metric": "Partly cloudy. High of 15C. Breezy. Winds from the West at 15 to 20 km/h.", "pop": "0" }, { "period": 7, "icon": "clear", "icon_url": "http://icons-ak.wxug.com/i/c/k/clear.gif", "title": "Sunday Night", "fcttext": "Clear. Low of 46F. Winds from the West at 5 to 15 mph.", "fcttext_metric": "Clear. Low of 8C. Breezy. Winds from the West at 10 to 20 km/h.", "pop": "0" }] }, "simpleforecast": { "forecastday": [{ "date": { "epoch": "1342094400", "pretty": "10:00 PM EST on July 12, 2012", "day": 12, "month": 7, "year": 2012, "yday": 193, "hour": 22, "min": "00", "sec": 0, "isdst": "0", "monthname": "July", "weekday_short": "Thu", "weekday": "Thursday", "ampm": "PM", "tz_short": "EST", "tz_long": "Australia/Sydney" }, "period": 1, "high": { "fahrenheit": "66", "celsius": "19" }, "low": { "fahrenheit": "54", "celsius": "12" }, "conditions": "Rain", "icon": "rain", "icon_url": "http://icons-ak.wxug.com/i/c/k/rain.gif", "skyicon": "cloudy", "pop": 80, "qpf_allday": { "in": 0.48, "mm": 12.2 }, "qpf_day": { "in": 0.42, "mm": 10.7 }, "qpf_night": { "in": 0.29, "mm": 7.4 }, "snow_allday": { "in": 0, "cm": 0 }, "snow_day": { "in": 0, "cm": 0 }, "snow_night": { "in": 0, "cm": 0 }, "maxwind": { "mph": 8, "kph": 13, "dir": "NW", "degrees": 319 }, "avewind": { "mph": 7, "kph": 11, "dir": "NNW", "degrees": 336 }, "avehumidity": 84, "maxhumidity": 88, "minhumidity": 75 }, { "date": { "epoch": "1342180800", "pretty": "10:00 PM EST on July 13, 2012", "day": 13, "month": 7, "year": 2012, "yday": 194, "hour": 22, "min": "00", "sec": 0, "isdst": "0", "monthname": "July", "weekday_short": "Fri", "weekday": "Friday", "ampm": "PM", "tz_short": "EST", "tz_long": "Australia/Sydney" }, "period": 2, "high": { "fahrenheit": "70", "celsius": "21" }, "low": { "fahrenheit": "52", "celsius": "11" }, "conditions": "Rain", "icon": "rain", "icon_url": "http://icons-ak.wxug.com/i/c/k/rain.gif", "skyicon": "partlycloudy", "pop": 60, "qpf_allday": { "in": 0.26, "mm": 6.6 }, "qpf_day": { "in": 0.02, "mm": 0.5 }, "qpf_night": { "in": 0.01, "mm": 0.3 }, "snow_allday": { "in": 0, "cm": 0 }, "snow_day": { "in": 0, "cm": 0 }, "snow_night": { "in": 0, "cm": 0 }, "maxwind": { "mph": 11, "kph": 18, "dir": "NNW", "degrees": 347 }, "avewind": { "mph": 9, "kph": 14, "dir": "WNW", "degrees": 289 }, "avehumidity": 71, "maxhumidity": 95, "minhumidity": 67 }, { "date": { "epoch": "1342267200", "pretty": "10:00 PM EST on July 14, 2012", "day": 14, "month": 7, "year": 2012, "yday": 195, "hour": 22, "min": "00", "sec": 0, "isdst": "0", "monthname": "July", "weekday_short": "Sat", "weekday": "Saturday", "ampm": "PM", "tz_short": "EST", "tz_long": "Australia/Sydney" }, "period": 3, "high": { "fahrenheit": "63", "celsius": "17" }, "low": { "fahrenheit": "46", "celsius": "8" }, "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": "NW", "degrees": 308 }, "avewind": { "mph": 10, "kph": 16, "dir": "West", "degrees": 279 }, "avehumidity": 61, "maxhumidity": 86, "minhumidity": 46 }, { "date": { "epoch": "1342353600", "pretty": "10:00 PM EST on July 15, 2012", "day": 15, "month": 7, "year": 2012, "yday": 196, "hour": 22, "min": "00", "sec": 0, "isdst": "0", "monthname": "July", "weekday_short": "Sun", "weekday": "Sunday", "ampm": "PM", "tz_short": "EST", "tz_long": "Australia/Sydney" }, "period": 4, "high": { "fahrenheit": "59", "celsius": "15" }, "low": { "fahrenheit": "46", "celsius": "8" }, "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": 12, "kph": 19, "dir": "West", "degrees": 266 }, "avewind": { "mph": 11, "kph": 18, "dir": "West", "degrees": 266 }, "avehumidity": 57, "maxhumidity": 80, "minhumidity": 41 }] } } }

Ambiguous Results

When the API location query does not produce an exact location match, a results array will be present in the JSON response.

http://api.wunderground.com/api/Your_Key/geolookup/forecast/q/Allentown.json Show Response
{ "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", "country_iso3166": "US", "country_name": "USA", "zmw": "31003.1.99999", "l": "/q/zmw:31003.1.99999" }, { "name": "Allentown", "city": "Allentown", "state": "NJ", "country": "US", "country_iso3166": "US", "country_name": "USA", "zmw": "08501.1.99999", "l": "/q/zmw:08501.1.99999" }, { "name": "Allentown", "city": "Allentown", "state": "NY", "country": "US", "country_iso3166": "US", "country_name": "USA", "zmw": "14707.1.99999", "l": "/q/zmw:14707.1.99999" }, { "name": "Allentown", "city": "Allentown", "state": "PA", "country": "US", "country_iso3166": "US", "country_name": "USA", "zmw": "18101.1.99999", "l": "/q/zmw:18101.1.99999" }] } }

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