Core Weather
Core Weather

Top Cities

Current conditions for top cities

GET
https://dataservice.accuweather.com
/currentconditions/v1/topcities/{listLength}

Returns current weather conditions for the top 50, 100, or 150 largest cities around the world.

Current conditions for top cities › path Parameters

listLength
​integer · int32 · pattern: 50|100|150 · required

A numerical value representing the amount of results to be returned.

Example: 50

Current conditions for top cities › query Parameters

language
​string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us
format
​string

A string value that specifies what type of format to provide the response.

Default: json

Current conditions for top cities › Headers

Authorization
​string · required

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

Current conditions for top cities › Responses

OK

API.CurrentConditions.Entities.OpenAPI.TopCityCurrentConditions
Key
​string · minLength: 1 · required

Unique ID to search a location.

LocalizedName
​string · minLength: 1 · required

Display name in local dialect set with language code in URL. Default is US English (us-en).

EnglishName
​string · minLength: 1 · required

Location name as displayed in English.

​required

An object containing country information.

​required

An object containing timezone information.

​required

An object containing geoposition information.

LocalObservationDateTime
​string · date-time · required

Datetime of the current observation displayed in ISO8601 format: yyyy-mm-ddThh:mm:ss±hh:mm.

EpochTime
​integer · int64 · required

Datetime of the current observation displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).

WeatherText
​string · minLength: 1 · required

Phrase description of the current weather condition. Displayed in specified language.

WeatherIcon
​integer · int64 · required

Numeric value representing an image that displays the WeatherText.

HasPrecipitation
​boolean · required

Flag indicating the presence or absence of precipitation. True indicates the presence of precipitation, false indicates the absence of precipitation.

PrecipitationType
​string · minLength: 1 · required

If precipitation is present, the type of precipitation will be returned. Possible values are Rain, Snow, Ice, or Mixed. Null in the absence of precipitation.

IsDayTime
​boolean · required

Flag indicating the time of day (true=>day, false=>night).

​required

An object containing temperature information with a rounded value for Fahrenheit and Celsius. The object may be NULL.

MobileLink
​string · minLength: 1 · required

Link to current conditions on AccuWeather's mobile site for the requested location.

Link
​string · minLength: 1 · required

Link to current conditions on AccuWeather's free site for the requested location.

​

Information specific to the local data source. This parameter is not returned if there is no local source information.

Location KeyHistorical