Core Weather

Top Cities

Endpointhttps://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

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

object[]

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.

object · required

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).

object · required

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.

object

GET/currentconditions/v1/topcities/{listLength}

curl --request GET \
  --url https://dataservice.accuweather.com/currentconditions/v1/topcities/:listLength \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "Key": "Key",
    "LocalizedName": "LocalizedName",
    "EnglishName": "EnglishName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "TimeZone": {
      "Code": "Code",
      "Name": "Name",
      "GmtOffset": 0,
      "IsDaylightSaving": true,
      "NextOffsetChange": "2024-08-25T15:00:00Z"
    },
    "GeoPosition": {
      "Elevation": {
        "Metric": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        },
        "Imperial": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        }
      },
      "Latitude": 0,
      "Longitude": 0
    },
    "LocalObservationDateTime": "2024-08-25T15:00:00Z",
    "EpochTime": 0,
    "WeatherText": "WeatherText",
    "WeatherIcon": 0,
    "HasPrecipitation": true,
    "PrecipitationType": "PrecipitationType",
    "IsDayTime": true,
    "Temperature": {
      "Metric": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Imperial": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      }
    },
    "MobileLink": "MobileLink",
    "Link": "Link",
    "LocalSource": {
      "Id": 0,
      "Name": "Name",
      "WeatherCode": "WeatherCode"
    }
  }
]

json

application/json

Location Key Historical

Core Weather

Top Cities

Endpointhttps://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

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

object[]

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.

object · required

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).

object · required

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.

object

GET/currentconditions/v1/topcities/{listLength}

curl --request GET \
  --url https://dataservice.accuweather.com/currentconditions/v1/topcities/:listLength \
  --header 'Authorization: Bearer YOUR_API_KEY'

shell

Example Responses

[
  {
    "Key": "Key",
    "LocalizedName": "LocalizedName",
    "EnglishName": "EnglishName",
    "Country": {
      "ID": "ID",
      "LocalizedName": "LocalizedName",
      "EnglishName": "EnglishName"
    },
    "TimeZone": {
      "Code": "Code",
      "Name": "Name",
      "GmtOffset": 0,
      "IsDaylightSaving": true,
      "NextOffsetChange": "2024-08-25T15:00:00Z"
    },
    "GeoPosition": {
      "Elevation": {
        "Metric": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        },
        "Imperial": {
          "UnitType": 0,
          "Value": 0,
          "Unit": "Unit"
        }
      },
      "Latitude": 0,
      "Longitude": 0
    },
    "LocalObservationDateTime": "2024-08-25T15:00:00Z",
    "EpochTime": 0,
    "WeatherText": "WeatherText",
    "WeatherIcon": 0,
    "HasPrecipitation": true,
    "PrecipitationType": "PrecipitationType",
    "IsDayTime": true,
    "Temperature": {
      "Metric": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      },
      "Imperial": {
        "UnitType": 0,
        "Value": 0,
        "Unit": "Unit"
      }
    },
    "MobileLink": "MobileLink",
    "Link": "Link",
    "LocalSource": {
      "Id": 0,
      "Name": "Name",
      "WeatherCode": "WeatherCode"
    }
  }
]

json

application/json

Location Key Historical