API
API

AutoComplete API

Page Contents

Returns a list of locations or hurricanes which match against a partial query. For example, searching for San F will return San Francisco, California, San Fernando del Valle de Catamarca, Argentina, and San Felipe de Puerto Plata, Dominican Republic, among others.

The request options include the ability to query for cities, hurricanes, or both. The results can be used to form Weather API queries or to link directly to wunderground resources.

This feature does not require an API key.

Request Format

GET http://autocomplete.wunderground.com/aq?query=query

Options

query
The search string. Usually a partial location or hurricane name
format
optional
Specifies response format. Possible values: JSON or XML. Default: JSON.
c
optional
Specify country code. Example: c=US
h
optional
Include hurricanes in results: h=1
cities
optional
Include cities in the results. This is the default behavior. To remove cities from results, cities=0
cb
optional
JSONP callback method name

Responses

Using Results

Each autocomplete result object has an l field (short for link) that can be used for constructing wunderground URLs or API calls:

City

http://www.wunderground.com/q/zmw:94125.1.99999

City API Request

http://api.wunderground.com/api/Your_Key/forecast/q/zmw:94125.1.99999.json

Hurricane

http://www.wunderground.com/hurricane/at200511.asp

Fields

name
Name of city or hurricane
type
hurricanes or cityIndicates if item is a hurricane or city.
c
Country (city only)
zmw
(city only)
tz
(city only)
tzs
(city only)
l
URL path and query string for result. This can be used to construct full wunderground URLs and API requests. See Using Results
date
(hurricane only)
strmnum
(hurricane only)
basin
(hurricane only)
damage
(hurricane only)

Examples

Try with Apigee

Note: replace {{key}} with Your_Key

City

GET http://autocomplete.wunderground.com/aq?query=San%20F Show Response
{ "RESULTS": [{ "name": "San Francisco, California", "type": "city", "c": "US", "zmw": "94101.1.99999", "tz": "America/Los_Angeles", "tzs": "PDT", "l": "/q/zmw:94101.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" }, { "name": "San Fernando, Spain", "type": "city", "c": "ES", "zmw": "00000.11.08449", "tz": "Africa/Ceuta", "tzs": "CEST", "l": "/q/zmw:00000.11.08449" }, { "name": "San Fernando Apure, Venezuela", "type": "city", "c": "VE", "zmw": "00000.8.80450", "tz": "America/Caracas", "tzs": "VET", "l": "/q/zmw:00000.8.80450" }, { "name": "San Felipe, Venezuela", "type": "city", "c": "VE", "zmw": "00000.8.80479", "tz": "America/Caracas", "tzs": "VET", "l": "/q/zmw:00000.8.80479" }, { "name": "San Felipe, Chile", "type": "city", "c": "CL", "zmw": "00000.16.85574", "tz": "America/Santiago", "tzs": "CLT", "l": "/q/zmw:00000.16.85574" }, { "name": "San Francisco, Argentina", "type": "city", "c": "AR", "zmw": "00000.6.87371", "tz": "America/Cordoba", "tzs": "ART", "l": "/q/zmw:00000.6.87371" }, { "name": "San Francisco, Costa Rica", "type": "city", "c": "CR", "zmw": "00000.52.WMRPV", "tz": "America/Costa_Rica", "tzs": "CST", "l": "/q/zmw:00000.52.WMRPV" }, { "name": "San Francisco El Alto, Guatemala", "type": "city", "c": "GT", "zmw": "00000.28.WMGQZ", "tz": "America/Guatemala", "tzs": "CST", "l": "/q/zmw:00000.28.WMGQZ" }, { "name": "San Fernando de Henares, Spain", "type": "city", "c": "ES", "zmw": "00000.42.08221", "tz": "Europe/Madrid", "tzs": "CEST", "l": "/q/zmw:00000.42.08221" }, { "name": "San Felipe, Costa Rica", "type": "city", "c": "CR", "zmw": "00000.51.WMRPV", "tz": "America/Costa_Rica", "tzs": "CST", "l": "/q/zmw:00000.51.WMRPV" }, { "name": "San Fernando, California", "type": "city", "c": "US", "zmw": "91340.1.99999", "tz": "America/Los_Angeles", "tzs": "PDT", "l": "/q/zmw:91340.1.99999" }, { "name": "San Francisco Acuautla, Mexico", "type": "city", "c": "MX", "zmw": "00000.33.76679", "tz": "America/Mexico_City", "tzs": "CDT", "l": "/q/zmw:00000.33.76679" }, { "name": "San Fernando de Monte Cristi, Dominican Republic", "type": "city", "c": "DO", "zmw": "00000.23.78451", "tz": "America/Santo_Domingo", "tzs": "AST", "l": "/q/zmw:00000.23.78451" }, { "name": "San Felice a Cancello, Italy", "type": "city", "c": "IT", "zmw": "00000.97.16289", "tz": "Europe/Rome", "tzs": "CEST", "l": "/q/zmw:00000.97.16289" }, { "name": "San Francisco, El Salvador", "type": "city", "c": "SV", "zmw": "00000.22.78670", "tz": "America/El_Salvador", "tzs": "CST", "l": "/q/zmw:00000.22.78670" }, { "name": "San Ferdinando di Puglia, Italy", "type": "city", "c": "IT", "zmw": "00000.20.16261", "tz": "Europe/Rome", "tzs": "CEST", "l": "/q/zmw:00000.20.16261" }, { "name": "San Francisco Tlalcilalcalpan, Mexico", "type": "city", "c": "MX", "zmw": "00000.32.76675", "tz": "America/Mexico_City", "tzs": "CDT", "l": "/q/zmw:00000.32.76675" }, { "name": "San Felice sul Panaro, Italy", "type": "city", "c": "IT", "zmw": "00000.53.16140", "tz": "Europe/Rome", "tzs": "CEST", "l": "/q/zmw:00000.53.16140" }] }

City with Country Code Filter

GET http://autocomplete.wunderground.com/aq?query=San%20F&c=US Show Response
{ "RESULTS": [{ "name": "San Francisco, California", "type": "city", "c": "US", "zmw": "94101.1.99999", "tz": "America/Los_Angeles", "tzs": "PDT", "l": "/q/zmw:94101.1.99999" }, { "name": "San Fernando, California", "type": "city", "c": "US", "zmw": "91340.1.99999", "tz": "America/Los_Angeles", "tzs": "PDT", "l": "/q/zmw:91340.1.99999" }, { "name": "San Felipe Pueblo, New Mexico", "type": "city", "c": "US", "zmw": "87001.2.99999", "tz": "America/Denver", "tzs": "MDT", "l": "/q/zmw:87001.2.99999" }, { "name": "San Felipe, California", "type": "city", "c": "US", "zmw": "92086.6.99999", "tz": "America/Los_Angeles", "tzs": "PDT", "l": "/q/zmw:92086.6.99999" }, { "name": "San Felipe, Texas", "type": "city", "c": "US", "zmw": "77473.1.99999", "tz": "America/Chicago", "tzs": "CDT", "l": "/q/zmw:77473.1.99999" }, { "name": "San Fidel, New Mexico", "type": "city", "c": "US", "zmw": "87049.1.99999", "tz": "America/Denver", "tzs": "MDT", "l": "/q/zmw:87049.1.99999" }, { "name": "San Francisco International, California", "type": "city", "c": "US", "zmw": "94128.4.99999", "tz": "America/Los_Angeles", "tzs": "PDT", "l": "/q/zmw:94128.4.99999" }, { "name": "San Fransisco, California", "type": "city", "c": "US", "zmw": "94101.2.99999", "tz": "America/Los_Angeles", "tzs": "PDT", "l": "/q/zmw:94101.2.99999" }] }

Hurricanes without Cities

GET http://autocomplete.wunderground.com/aq?query=Kat&h=1&cities=0 Show Response
{ "RESULTS": [{ "name": "Katrina, Major Hurricane - Atlantic, 2005", "type": "hurricanes", "date": "8/23/2005", "strmnum": "11", "basin": "at", "damage": "108000", "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" }, { "name": "Katrina, Hurricane - Atlantic, 1981", "type": "hurricanes", "date": "11/3/1981", "strmnum": "11", "basin": "at", "damage": "0", "l": "/hurricane/at198111.asp" }, { "name": "Kate, Major Hurricane - Atlantic, 2003", "type": "hurricanes", "date": "9/25/2003", "strmnum": "11", "basin": "at", "damage": "0", "l": "/hurricane/at200311.asp" }, { "name": "Katia, Hurricane - Atlantic, 2011", "type": "hurricanes", "date": "-1/-1/2011", "strmnum": "12", "basin": "at", "damage": "0", "l": "/hurricane/at201112.asp" }, { "name": "Katrina, Tropical Storm - Atlantic, 1999", "type": "hurricanes", "date": "10/28/1999", "strmnum": "11", "basin": "at", "damage": "0", "l": "/hurricane/at199911.asp" }, { "name": "Kate, Hurricane - Eastern Pacific, 1976", "type": "hurricanes", "date": "9/21/1976", "strmnum": "16", "basin": "ep", "damage": "-1", "l": "/hurricane/ep197616.asp" }, { "name": "Kate, Hurricane - Western Pacific, 1951", "type": "hurricanes", "date": "6/25/1951", "strmnum": "8", "basin": "wp", "damage": "-1", "l": "/hurricane/wp19518.asp" }, { "name": "Kate, Hurricane - Western Pacific, 1955", "type": "hurricanes", "date": "9/16/1955", "strmnum": "28", "basin": "wp", "damage": "-1", "l": "/hurricane/wp195528.asp" }, { "name": "Kate, Hurricane - Western Pacific, 1962", "type": "hurricanes", "date": "7/16/1962", "strmnum": "9", "basin": "wp", "damage": "-1", "l": "/hurricane/wp19629.asp" }, { "name": "Kate, Hurricane - Western Pacific, 1964", "type": "hurricanes", "date": "11/10/1964", "strmnum": "44", "basin": "wp", "damage": "-1", "l": "/hurricane/wp196444.asp" }, { "name": "Kate, Hurricane - Western Pacific, 1970", "type": "hurricanes", "date": "10/13/1970", "strmnum": "44", "basin": "wp", "damage": "-1", "l": "/hurricane/wp197044.asp" }, { "name": "Kate, Tropical Depression - Western Pacific, 1959", "type": "hurricanes", "date": "8/24/1959", "strmnum": "13", "basin": "wp", "damage": "-1", "l": "/hurricane/wp195913.asp" }, { "name": "Kate, Tropical Storm - Western Pacific, 1967", "type": "hurricanes", "date": "8/16/1967", "strmnum": "25", "basin": "wp", "damage": "-1", "l": "/hurricane/wp196725.asp" }, { "name": "Kate, Tropical Storm - Western Pacific, 1973", "type": "hurricanes", "date": "8/20/1973", "strmnum": "13", "basin": "wp", "damage": "-1", "l": "/hurricane/wp197313.asp" }, { "name": "Kate, Tropical Storm - Western Pacific, 1999", "type": "hurricanes", "date": "4/21/1999", "strmnum": "4", "basin": "wp", "damage": "-1", "l": "/hurricane/wp19994.asp" }, { "name": "Katherine, Hurricane - Eastern Pacific, 1973", "type": "hurricanes", "date": "9/29/1973", "strmnum": "11", "basin": "ep", "damage": "-1", "l": "/hurricane/ep197311.asp" }, { "name": "Kathleen, Hurricane - Eastern Pacific, 1976", "type": "hurricanes", "date": "9/7/1976", "strmnum": "15", "basin": "ep", "damage": "-1", "l": "/hurricane/ep197615.asp" }, { "name": "Kathleen, Tropical Storm - Eastern Pacific, 1961", "type": "hurricanes", "date": "7/14/1961", "strmnum": "4", "basin": "ep", "damage": "-1", "l": "/hurricane/ep19614.asp" }] }

Hurricanes with Cities

GET http://autocomplete.wunderground.com/aq?query=Katr&h=1 Show Response
{ "RESULTS": [{ "name": "Katrineholm, Sweden", "type": "city", "c": "SE", "zmw": "00000.3.02476", "tz": "Europe/Stockholm", "tzs": "CEST", "l": "/q/zmw:00000.3.02476" }, { "name": "Katra, India", "type": "city", "c": "IN", "zmw": "00000.10.42056", "tz": "Asia/Kolkata", "tzs": "IST", "l": "/q/zmw:00000.10.42056" }, { "name": "Katras, India", "type": "city", "c": "IN", "zmw": "00000.14.42703", "tz": "Asia/Kolkata", "tzs": "IST", "l": "/q/zmw:00000.14.42703" }, { "name": "Katrina, Major Hurricane - Atlantic, 2005", "type": "hurricanes", "date": "8/23/2005", "strmnum": "11", "basin": "at", "damage": "108000", "l": "/hurricane/at200511.asp" }, { "name": "Katrina, Hurricane - Atlantic, 1981", "type": "hurricanes", "date": "11/3/1981", "strmnum": "11", "basin": "at", "damage": "0", "l": "/hurricane/at198111.asp" }, { "name": "Katrina, Tropical Storm - Atlantic, 1999", "type": "hurricanes", "date": "10/28/1999", "strmnum": "11", "basin": "at", "damage": "0", "l": "/hurricane/at199911.asp" }, { "name": "Katrina, Hurricane - Eastern Pacific, 1967", "type": "hurricanes", "date": "8/30/1967", "strmnum": "12", "basin": "ep", "damage": "-1", "l": "/hurricane/ep196712.asp" }, { "name": "Katrina, Hurricane - Eastern Pacific, 1975", "type": "hurricanes", "date": "8/28/1975", "strmnum": "12", "basin": "ep", "damage": "-1", "l": "/hurricane/ep197512.asp" }, { "name": "Katrina, Tropical Storm - Eastern Pacific, 1971", "type": "hurricanes", "date": "8/8/1971", "strmnum": "12", "basin": "ep", "damage": "-1", "l": "/hurricane/ep197112.asp" }] }