Current Conditions for Top Cities

GET

Current Conditions for Top Cities

Returns current conditions data for the top 50, 100, or 150 cities worldwide, based on rank.

Resource URL

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

Query Parameters


Name Values Description
apikey
(required)

Provided API Key

language

String indicating the language in which to return the resource

details

Boolean value specifies whether or not to include full details in the response.


Request Body

group Group size, indicating how many cities to return. Valid values are 50, 100, or 150. true

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 400

    Request had bad syntax or the parameters supplied were invalid

  • 401

    Unauthorized. API authorization failed

  • 403

    Unauthorized. You do not have permission to access this endpoint

  • 404

    Server has not found a route matching the given URI

  • 500

    Server encountered an unexpected condition which prevented it from fulfilling the request

Working...

Response Parameters

Parameter Type Description
Key string Location key. Unique ID used to search for a location.
LocalizedName string Location name, displayed in the language set with language code in URL. Default is US English (en-us).
EnglishName string Location name, displayed in English.
Country.ID string Unique ISO or Microsoft Localization Code for the country.
Country.LocalizedName string Country name as displayed in the local dialect set with language code in the URL. Default is US English (en-us).
Country.EnglishName string Country name displayed in English.
TimeZone.Code string Official abbreviation code for designated Time Zone.
TimeZone.Name string Official name of designated Time Zone.
TimeZone.GmtOffset float Number of hours offset from local GMT time.
TimeZone.IsDaylightSaving boolean Is the location currently observing Daylight Saving time.
TimeZone.NextOffsetChange date-time Next time that daylight saving time changes. May be NULL.
Geoposition.Latitude double Geographical coordinate that specifies the north-south position of a point on the earth`s surface.
Geoposition.Longitude double Geographical coordinate that specifies the east-west position of a point on the earth`s surface.
Geoposition.Elevation.Metric.Value double Elevation. Rounded value in specified units. May be NULL.
Geoposition.Elevation.Metric.Unit string Type of unit.
Geoposition.Elevation.Metric.UnitType int32 Numeric ID associated with the type of unit being displayed.
Geoposition.Elevation.Imperial.Value double Elevation. Rounded value in specified units. May be NULL.
Geoposition.Elevation.Imperial.Unit string Type of unit.
Geoposition.Elevation.Imperial.UnitType int32 Numeric ID associated with the type of unit being displayed.
LocalObservationDateTime string DateTime of the current observation, displayed in ISO8601 format.
EpochTime int64 DateTime of the current observation, displayed as the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).
WeatherText string Phrase description of the current weather condition. Displayed in the language set with language code in URL.
WeatherIcon int32 Numeric value representing an image that displays the current condition described by WeatherText. May be NULL.
IsDayTime boolean Flag indicating the time of day (true=day, false=night)
Temperature object Current temperature. Contains metric and imperial values.
MobileLink string Link to current conditions for the requested location on AccuWeather's mobile site.
Link string Link to current conditions for the requested location on AccuWeather's web site.
HasPrecipitation boolean Flag indicating the presence or absence of precipitation. True indicates the presence of precipitation, false indicates the absence of precipitation.
PrecipitationType string 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.