Data Features: URL Format

Page Contents

Features by Plan

There are 3 plans to the Wunderground.com API: Stratus, Cumulus, and Anvil. The different plans offer different levels of data and details.

The first level is Stratus, referring to the lowest level of clouds. This plan includes the most commonly needed weather features, such as current conditions, location lookup, and 3 days of forecast.

The second level, Cumulus, is the mid level growth clouds, and contains more forecast information as well as severe alerts and radar and satellite imagery. When you subscribe to the Cumulus plan, you also receive all of the features of the Stratus plan.

The third plan is Anvil, referencing the highest growth of a cumulus cloud. This level has all of our advanced data, encompassing 10 days of hourly forecast, animated radar and satellite, and hirricane data. When you subscribe to the Anvil plan you get access to all the levels of the Stratus and Cumulus plans.

Stratus Plan Breakdown

Geolookup
geolookup Returns the the city name, zip code / postal code, latitude-longitude coordinates and nearby personal weather stations.
Autocomplete
autocomplete Returns a list of locations or hurricanes which match against a partial query.
Current conditions
3-day forecast summary
Astronomy
Almanac for today
STRATUS PLAN CUMULUS PLAN 10-day forecast summary Hourly 1-day forecast Satellite thumbnail Dynamic Radar image Severe alerts Tides and Currents Tides and Currents Raw ANVIL PLAN includes stratus & cumulus features Hourly 10-day forecast Yesterday's weather summary Travel Planner Webcams thumbnails Dynamic animated Radar image Dynamic animated Satellite image Current Tropical Storms

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