Core Weather

List

Endpoint:https://dataservice.accuweather.com

Top 50 cities list

GET

https://dataservice.accuweather.com

/locations/v1/topcities/50

Returns location data for the top 50 cities, worldwide

Top 50 cities list › query Parameters

languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Top 50 cities list › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top 50 cities list › Responses

PrimaryPostalCodestring · minLength: 1 · required
Official postal code provided by our main location data provider for the requested location
Regionrequired
The object containing the region details
TimeZonerequired
The object containing the timezone details
GeoPositionrequired
The object containing the geoposition details
IsAliasboolean · required
“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location
SupplementalAdminAreasobject[] · required
The object containing a list of administrative area details
DataSetsstring[] · required
Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.
EnglishNamestring · minLength: 1 · required
Location name as displayed in English
Versioninteger · int32 · required
Current version of the API
Keystring · minLength: 1 · required
Unique ID to search a location
Typestring · minLength: 1 · required
Location type such as City, PostalCode, POI or LatLong
Rankinteger · int32 · required
Number applied to locations set by factors such as population, political importance, and geographic size
LocalizedNamestring · minLength: 1 · required
Display name in local dialect set with language code in URL. Default is US English (us-en)
Countryrequired
THe object containing the country details
AdministrativeArearequired
The object containing the amdministrative area details

ParentCity | null
The object containing the parentcity details. This object will be displayed only if the location is part of a larger metropolitan area or parent city.
Details | null
AccuWeather related details about the specific location

Top 100 cities list

GET

https://dataservice.accuweather.com

/locations/v1/topcities/100

Returns location data for the top 100 cities, worldwide

Top 100 cities list › query Parameters

languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Top 100 cities list › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top 100 cities list › Responses

PrimaryPostalCodestring · minLength: 1 · required
Official postal code provided by our main location data provider for the requested location
Regionrequired
The object containing the region details
TimeZonerequired
The object containing the timezone details
GeoPositionrequired
The object containing the geoposition details
IsAliasboolean · required
“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location
SupplementalAdminAreasobject[] · required
The object containing a list of administrative area details
DataSetsstring[] · required
Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.
EnglishNamestring · minLength: 1 · required
Location name as displayed in English
Versioninteger · int32 · required
Current version of the API
Keystring · minLength: 1 · required
Unique ID to search a location
Typestring · minLength: 1 · required
Location type such as City, PostalCode, POI or LatLong
Rankinteger · int32 · required
Number applied to locations set by factors such as population, political importance, and geographic size
LocalizedNamestring · minLength: 1 · required
Display name in local dialect set with language code in URL. Default is US English (us-en)
Countryrequired
THe object containing the country details
AdministrativeArearequired
The object containing the amdministrative area details

ParentCity | null
The object containing the parentcity details. This object will be displayed only if the location is part of a larger metropolitan area or parent city.
Details | null
AccuWeather related details about the specific location

Top 150 cities list

GET

https://dataservice.accuweather.com

/locations/v1/topcities/150

Returns location data for the top 150 cities, worldwide

Top 150 cities list › query Parameters

languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Top 150 cities list › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top 150 cities list › Responses

PrimaryPostalCodestring · minLength: 1 · required
Official postal code provided by our main location data provider for the requested location
Regionrequired
The object containing the region details
TimeZonerequired
The object containing the timezone details
GeoPositionrequired
The object containing the geoposition details
IsAliasboolean · required
“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location
SupplementalAdminAreasobject[] · required
The object containing a list of administrative area details
DataSetsstring[] · required
Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.
EnglishNamestring · minLength: 1 · required
Location name as displayed in English
Versioninteger · int32 · required
Current version of the API
Keystring · minLength: 1 · required
Unique ID to search a location
Typestring · minLength: 1 · required
Location type such as City, PostalCode, POI or LatLong
Rankinteger · int32 · required
Number applied to locations set by factors such as population, political importance, and geographic size
LocalizedNamestring · minLength: 1 · required
Display name in local dialect set with language code in URL. Default is US English (us-en)
Countryrequired
THe object containing the country details
AdministrativeArearequired
The object containing the amdministrative area details

ParentCity | null
The object containing the parentcity details. This object will be displayed only if the location is part of a larger metropolitan area or parent city.
Details | null
AccuWeather related details about the specific location

Top cities list by region

GET

https://dataservice.accuweather.com

/locations/v1/topcities/regions/{regionCode}

Returns location data for the top cities within a specific region

Top cities list by region › path Parameters

regionCodestring
A unique ID that designates a specific region. More information can be found here.
Example: NAM

Top cities list by region › query Parameters

languageIDinteger · int32
A unique ID that designates a specific language.
Default: 1
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false

Top cities list by region › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Top cities list by region › Responses

PrimaryPostalCodestring · minLength: 1 · required
Official postal code provided by our main location data provider for the requested location
Regionrequired
The object containing the region details
TimeZonerequired
The object containing the timezone details
GeoPositionrequired
The object containing the geoposition details
IsAliasboolean · required
“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location
SupplementalAdminAreasobject[] · required
The object containing a list of administrative area details
DataSetsstring[] · required
Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.
EnglishNamestring · minLength: 1 · required
Location name as displayed in English
Versioninteger · int32 · required
Current version of the API
Keystring · minLength: 1 · required
Unique ID to search a location
Typestring · minLength: 1 · required
Location type such as City, PostalCode, POI or LatLong
Rankinteger · int32 · required
Number applied to locations set by factors such as population, political importance, and geographic size
LocalizedNamestring · minLength: 1 · required
Display name in local dialect set with language code in URL. Default is US English (us-en)
Countryrequired
THe object containing the country details
AdministrativeArearequired
The object containing the amdministrative area details

ParentCity | null
The object containing the parentcity details. This object will be displayed only if the location is part of a larger metropolitan area or parent city.
Details | null
AccuWeather related details about the specific location

Countries list by region code

GET

https://dataservice.accuweather.com

/locations/v1/countries/{regionCode}

Specify a region code to return a list of countries within that region.

Countries list by region code › path Parameters

regionCodestring
A unique ID that designates a specific region. More information can be found here.
Example: NAM

Countries list by region code › query Parameters

countryCodestring
A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.
Example: US
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
offsetinteger · int32
A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.
Default: -1
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Countries list by region code › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Countries list by region code › Responses

IDstring · minLength: 1 · required
Unique administrative area ID
LocalizedNamestring · minLength: 1 · required
Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English
EnglishNamestring · minLength: 1 · required
Administrative area name displayed in English

Countries list

GET

https://dataservice.accuweather.com

/locations/v1/countries

This endpoint returns a list of available countries.

Countries list › query Parameters

regionCodestring
A unique ID that designates a specific region. More information can be found here.
Example: NAM
countryCodestring
A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.
Example: US
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
offsetinteger · int32
A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.
Default: -1
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Countries list › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Countries list › Responses

IDstring · minLength: 1 · required
Unique administrative area ID
LocalizedNamestring · minLength: 1 · required
Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English
EnglishNamestring · minLength: 1 · required
Administrative area name displayed in English

Region list

GET

https://dataservice.accuweather.com

/locations/v1/regions

List of all available regions

Region list › query Parameters

regionCodestring
A unique ID that designates a specific region. More information can be found here.
Example: NAM
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Region list › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Region list › Responses

IDstring · minLength: 1 · required
Unique administrative area ID
LocalizedNamestring · minLength: 1 · required
Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English
EnglishNamestring · minLength: 1 · required
Administrative area name displayed in English

Country by region code and country code

GET

https://dataservice.accuweather.com

/locations/v1/countries/{regionCode}/{countryCode}

Specify a region code and a country code to return basic information about a country.

Country by region code and country code › path Parameters

regionCodestring · required
A unique ID that designates a specific region. More information can be found here.
countryCodestring · required
A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.

Country by region code and country code › query Parameters

languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Country by region code and country code › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Country by region code and country code › Responses

IDstring · minLength: 1 · required
Unique administrative area ID
LocalizedNamestring · minLength: 1 · required
Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English
EnglishNamestring · minLength: 1 · required
Administrative area name displayed in English

Administrative area list by country code

GET

https://dataservice.accuweather.com

/locations/v1/adminareas/{countryCode}

Provide a country code to return basic information about administrative areas in the specified country

Administrative area list by country code › path Parameters

countryCodestring
A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.
Example: US

Administrative area list by country code › query Parameters

adminCodestring
A unique ID that designates a specific administrative area. More information can be found here.
Example: NY
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
offsetinteger · int32
A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.
Default: -1
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Administrative area list by country code › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Administrative area list by country code › Responses

Levelinteger · int64 · required
An assigned number to describe the scale of the administrative subdivisions for countries. As the Level number increases, the scale of the subdivision will decrease. Numbers of 10 or greater are reserved for non-political boundaries and should be used independently
CountryIDstring · minLength: 1 · required
Unique ISO or Microsoft Localization Code for the country that contains the AdministrativeArea.
IDstring · minLength: 1 · required
Unique administrative area ID
LocalizedNamestring · minLength: 1 · required
Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English
EnglishNamestring · minLength: 1 · required
Administrative area name displayed in English

LocalizedTypestring | null
Administrative Area type displayed in the local dialect set with the language code in the URL. Default is US English (en-us).
EnglishTypestring | null
Administrative Area type displayed in English.

Administrative area list

GET

https://dataservice.accuweather.com

/locations/v1/adminareas

Returns basic information about global administrative areas

Administrative area list › query Parameters

countryCodestring
A unique ISO or Microsoft Localization Code for a specific country. More information can be found here.
Example: US
adminCodestring
A unique ID that designates a specific administrative area. More information can be found here.
Example: NY
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
offsetinteger · int32
A numerical value representing the first result to return. Results will be returned in sets of 25. Offset=0 will return the first 25 results, Offset=1 will return the second 25 results, etc.
Default: -1
formatstring
A string value that specifies what type of format to provide the response.
Default: json

Administrative area list › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Administrative area list › Responses

Levelinteger · int64 · required
An assigned number to describe the scale of the administrative subdivisions for countries. As the Level number increases, the scale of the subdivision will decrease. Numbers of 10 or greater are reserved for non-political boundaries and should be used independently
CountryIDstring · minLength: 1 · required
Unique ISO or Microsoft Localization Code for the country that contains the AdministrativeArea.
IDstring · minLength: 1 · required
Unique administrative area ID
LocalizedNamestring · minLength: 1 · required
Administrative area name as displayed in local dialect set with language code in the URL. If no language code is selected, the default is English
EnglishNamestring · minLength: 1 · required
Administrative area name displayed in English

LocalizedTypestring | null
Administrative Area type displayed in the local dialect set with the language code in the URL. Default is US English (en-us).
EnglishTypestring | null
Administrative Area type displayed in English.

Location Key Autocomplete