Locations API Guide
Lists
Location key
Text
Administrative area list
Returns basic information about administrative areas. May be narrowed by country code.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/adminareas/{countryCode}{.{format}}{?apikey={your key}}{&language={languageCode}}{&offset={zero based page number}} |
Example:
| https://api.accuweather.com/locations/v1/adminareas/us?offset=2&apikey={your key} |
Administrative area search
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/adminareas/{countryCode}/search{.{format}}?q={search text}{&apikey={your key}}{&language={languageCode}} |
Example:
| https://api.accuweather.com/locations/v1/adminareas/US/search?q=pennsylvania&apikey={your key} |
Country list
Returns basic information about countries. May be narrowed by region code.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/countries/{regionCode}{.{format}}?{apikey={your key}}{&language= {languageCode}} |
Example:
| https://api.accuweather.com/locations/v1/countries/nam?apikey={your key} |
Country search
|
https://{{api} or {{apidev}}.accuweather.com/locations/{version}/countries/search{.{format}}?q={search text}{&apikey={your key}}{&language={languageCode}} |
Example:
| https://api.accuweather.com/locations/v1/countries/search?q=España&language=es&apikey={your key} |
Region list
Returns basic information about all regions.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/regions/{regionCode}{.{format}}{?apikey={your key}}{&language={languageCode}} |
Example:
| https://api.accuweather.com/locations/v1/regions.json?apikey={your key} |
Top city list
Returns basic information for the top 50, 100, or 150 cities, worldwide.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/topcities/{group}{.{format}}?apikey={your key}{&language={language code}}{&details={true or false}} |
Example:
| https://api.accuweather.com/locations/v1/topcities/50.json?apikey={your key} |
Search by location key
Returns information about a specific location, by location key. You must know the location key to perform this query.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/{locationKey}{.{format}}?apikey={your key}{&language={language code}}{&details=true or false}} |
Example:
| https://api.accuweather.com/locations/v1/335315.json?apikey={your key} |
Search city neighbors by location key
Returns information about neighboring cities, by location key. You must know the location key to perform this query.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/cities/neighbors/{locationKey}{.{format}}?apikey={your key} {&language={language code}}{&details={true or false}} |
Example:
| https://api.accuweather.com/locations/v1/cities/neighbors/623.json?apikey={your key} |
City search
Searches the specified language for the queried city name and returns results in the specified language. Compare this response to the response obtained from the city search with translation query for "Roma."
| https://{{api} or {{apidev}}.accuweather.com/locations/ {version}/cities/{countryCode}/{adminCode}/search{.{format}}?q={city name}&apikey={your key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}} |
Example:
| https://api.accuweather.com/locations/v1/cities/search.json?q=roma&apikey={your key}&language=en-us |
City search with translation
Searches all languages for the queried city name and returns results in the specified language. Compare this response to the response obtained from the city search query for "Roma."
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/cities/{countryCode}/{adminCode}/translate{.{format}}?q={city name}&apikey={your key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}} |
Examples:
| https://api.accuweather.com/locations/v1/cities/translate.json?q=roma&language=en-us&apikey={your key} |
Points of interest search
Searches the specified language for the queried point of interest name and returns results in the specified language.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/poi/{countryCode}/{adminCode}/search{.{format}}?q={point of interest}&apikey={your key}{&type={poi type}}{&language={language code}}{&details={true or false}} |
Example:
| https://api.accuweather.com/locations/v1/poi/US/CA/search?q=Disney Studios&apikey={your key}&details=true |
Points of interest search with translation
Searches all languages for the queried point of interest name and returns results in the specified language.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/poi/{countryCode}/{adminCode}/translate{.{format}}?q={point of interest}&apikey={your key}{&type={poi type}}{&language={language code}}{&details={true or false}} |
Example:
| https://api.accuweather.com/locations/v1/poi/translate?q=Disney Studios&apikey={your key}&language=zh-cn |
Postal code search
Returns information for an array of postal codes that match the search text.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/postalcodes/{countryCode}/search{.{format}}?q={postal code}{&language={language code}}{&details={true or false}}&apikey={your key} |
Example:
| https://api.accuweather.com/locations/v1/postalcodes/search.json?q=90210&apikey={your key} |
Text search
Searches the specified language and returns information in the specified language for an array of locations that match the search text.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/{countryCode}/{adminCode}/search.{.{format}}?q={search text}&apiKey={your key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}} |
Examples:
| https://api.accuweather.com/locations/v1/fr/search?q=paris&apikey={your key}&language=fr&details=true |
| https://api.accuweather.com/locations/v1/search?q=16801&apikey={your key} |
Text search with translation
Searches all languages and returns information in the specified languages for an array of locations that match the search text.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/{countryCode}/{adminCode}/translate{.{format}}?q={search text}&apiKey={your key}{&language={language code}}{&details={true or false}}{&offset={zero based page number}}{&alias={always or never}} |
Examples:
| https://api.accuweather.com/locations/v1/translate?q=tokyo&apikey={your key}&language=de |
Autocomplete cities
Returns basic information about cities matching an autocomplete of the search text.
|
https://{{api} or {{apidev}}.accuweather.com/locations/ {version}/cities/{countryCode}/autocomplete{.{format}}?q={location}{&apikey={your key}}{&language={language code}} |
Examples:
| https://api.accuweather.com/locations/v1/cities/autocomplete?q=new&apikey={your key} |
| https://api.accuweather.com/locations/v1/cities/autocomplete.json?q=nue&apikey={your key}&language=es |
Autocomplete cities or points of interest
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/{countryCode}/autocomplete{.{format}}?apikey={your key}&language={language code}}&q={search text}&includealiases={true or false} |
Examples:
| https://api.accuweather.com/locations/v1/autocomplete.json?apikey={your key}&language=en-us&q=beaver&includealiases=true |
| https://api.accuweather.com/locations/v1/US/autocomplete.json?apikey={your key}&language=en-us&q=sears&includealiases=true |
Autocomplete Points of Interest
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/poi/{countryCode}/autocomplete{.{format}}?apikey={your key}&language={language code}}&q={search text}&includealiases={true or false} |
Examples:
| https://api.accuweather.com/locations/v1/poi/autocomplete.json?apikey={your key}&language=en-us&q=wim&includealiases=true |
| https://api.accuweather.com/locations/v1/poi/GB/autocomplete.json?apikey={your key}&language=en-us&q=wim&includealiases=true |
Search cities and points of interest by geo position (latitude and longitude)
Returns information about a specific location, by geo position (latitude and longitude). The response includes cities and points of interest.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/geoposition/search{.{format}}?q={latitude, longitude}&apikey={your key}{&language={language code}}{&details={true or false}}{&toplevel={true or false}} |
Example:
| https://api.accuweather.com/locations/v1/geoposition/search.json?q=28.371,-81.549&apikey={your key} |
Search cities by geo position (latitude and longitude)
Returns information about a specific location, by geo position (latitude and longitude). The response includes cities.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/cities/geoposition/search{.{format}}?q={latitude, longitude}&apikey={your key}{&language={language code}}{&details={true or false}}{&toplevel={true or false}} |
Example:
| https://api.accuweather.com/locations/v1/cities/geoposition/search.json?q=40.78, -77.89&apikey={your key} |
Search Points of Interest by GeoPosition (Latitude and Longitude)
Returns information about a specific location by geo position (latitude and longitude). The response includes Points of Interest.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/poi/geoposition/search{.{format}}?q={latitude, longitude}&apikey={your key}{&language={language code}}{&details={true or false}}{&toplevel={true or false}} |
Example:
| https://api.accuweather.com/locations/v1/poi/geoposition/search.json?q=28.371,-81.549&apikey={your key} |
Search by IP address
If the entered IP address is invalid, your current IP location will be returned. You can remove the parameter "q=" to automatically detect the current browser location.
| https://{{api} or {{apidev}}.accuweather.com/locations/{version}/cities/ipaddress{.{format}}?q={ip address}{&apikey={your key}}{&language={language code}}{&details={true or false}} |
Examples:
| https://api.accuweather.com/locations/v1/cities/ipaddress?q=38.103.173.150&apikey={your key} |
| https://api.accuweather.com/locations/v1/cities/ipaddress?apikey={your key} |