The Locations API allows users to get a location key for their desired location. This location key will then be used in the other APIs to retrieve weather data.

List

Method
Description

GET

Admin Area List

http://dataservice.accuweather.com/locations/v1/adminareas/{countryCode}

Returns basic information about administrative areas in the specified country.

GET

Country List

http://dataservice.accuweather.com/locations/v1/countries/{regionCode}

Returns basic information about all countries within a specified region.

GET

Region List

http://dataservice.accuweather.com/locations/v1/regions

Returns basic information about all regions.

GET

Top Cities List

http://dataservice.accuweather.com/locations/v1/topcities/{group}

Returns information for the top 50, 100, or 150 cities, worldwide.

AutoComplete

Method
Description

GET

Autocomplete search

http://dataservice.accuweather.com/locations/v1/cities/autocomplete

Returns basic information about locations matching an autocomplete of the search text.

Location Key

Method
Description

GET

City Neighbors by locationKey

http://dataservice.accuweather.com/locations/v1/cities/neighbors/{locationKey}

Returns information about neighboring cities, by location key. You must know the location key to perform this query.

GET

Search by locationKey

http://dataservice.accuweather.com/locations/v1/{locationKey}

Returns information about a specific location, by location key. You must know the location key to perform this query.

Text Search

Method
Description

GET

City Search

http://dataservice.accuweather.com/locations/v1/cities/search

Returns information for an array of cities that match the search text.

GET

City Search (results narrowed by countryCode and adminCode)

http://dataservice.accuweather.com/locations/v1/cities/{countryCode}/{adminCode}/search

Returns information for an array of cities that match the search text.

GET

City Search (results narrowed by countryCode)

http://dataservice.accuweather.com/locations/v1/cities/{countryCode}/search

Returns information for an array of cities that match the search text.

GET

POI Search

http://dataservice.accuweather.com/locations/v1/poi/search

Returns information for an array of Points of Interest that match the search text.

GET

POI Search (results narrowed by countryCode and adminCode)

http://dataservice.accuweather.com/locations/v1/poi/{countryCode}/{adminCode}/search

Returns information for an array of Points of Interest that match the search text.

GET

POI Search (results narrowed by countryCode)

http://dataservice.accuweather.com/locations/v1/poi/{countryCode}/search

Returns information for an array of Points of Interest that match the search text.

GET

Postal Code Search

http://dataservice.accuweather.com/locations/v1/postalcodes/search

Returns information for an array of Postal Codes that match the search text.

GET

Postal Code Search (results narrowed by countryCode)

http://dataservice.accuweather.com/locations/v1/postalcodes/{countryCode}/search

Returns information for an array of Postal Codes that match the search text.

GET

Text Search

http://dataservice.accuweather.com/locations/v1/search

Returns information for an array of locations that match the search text.

GET

Text Search (results narrowed by countryCode and adminCode)

http://dataservice.accuweather.com/locations/v1/{countryCode}/{adminCode}/search

Returns information for an array of locations that match the search text. Results are narrowed by entering a countryCode and adminCode in the path.

GET

Text Search (results narrowed by countryCode)

http://dataservice.accuweather.com/locations/v1/{countryCode}/search

Returns information for an array of locations that match the search text. Results are narrowed by entering a countryCode in the path.

Geoposition

Method
Description

GET

Geoposition Search

http://dataservice.accuweather.com/locations/v1/cities/geoposition/search

Returns information about a specific location, by GeoPosition (Latitude and Longitude).

IP Address

Method
Description

GET

IP Address Search

http://dataservice.accuweather.com/locations/v1/cities/ipaddress

Returns information about a specific location, by IP Address.

General Locations Information | Regions and Countries | Administrative Areas | AutoComplete Information