Core Weather

Top Cities

Endpoint:https://dataservice.accuweather.com

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

  • listLengthinteger · 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

  • 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

Current conditions for top cities › Headers

  • Authorizationstring · 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

  • Keystring · minLength: 1 · required

    Unique ID to search a location.

  • LocalizedNamestring · minLength: 1 · required

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

  • EnglishNamestring · minLength: 1 · required

    Location name as displayed in English.

  • Countryrequired

    An object containing country information.

  • TimeZonerequired

    An object containing timezone information.

  • GeoPositionrequired

    An object containing geoposition information.

  • LocalObservationDateTimestring · date-time · required

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

  • EpochTimeinteger · int64 · required

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

  • WeatherTextstring · minLength: 1 · required

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

  • WeatherIconinteger · int64 · required

    Numeric value representing an image that displays the WeatherText.

  • HasPrecipitationboolean · required

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

  • PrecipitationTypestring · 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.

  • IsDayTimeboolean · required

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

  • Temperaturerequired

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

  • MobileLinkstring · minLength: 1 · required

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

  • Linkstring · minLength: 1 · required

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

  • LocalSource | null

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

Location KeyHistorical