Top City

Get a list of popular cities around the world.

Endpoint#

GET /geo/v2/city/top

Parameters#

Query parameters

range

string

Set to search only within a certain country or region. The country and region name needs to use country code ISO 3166. If this parameter is not set, the search range will be all cities. Example: range=cn
number

integer

Number of the results in response, from 1 to 20, 10 is the default.
lang

string

Language setting. See Language for behavior, configuration, and data availability

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/geo/v2/city/top'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "code": "200",
  "topCityList": [
    {
      "name": "Beijing",
      "id": "101010100",
      "lat": "39.90499",
      "lon": "116.40529",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "10",
      "fxLink": "https://www.qweather.com/en/weather/beijing-101010100.html"
    },
    {
      "name": "Yuhang",
      "id": "101210106",
      "lat": "30.27371",
      "lon": "119.97874",
      "adm2": "Hangzhou",
      "adm1": "Zhejiang",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "25",
      "fxLink": "https://www.qweather.com/en/weather/yuhang-101210106.html"
    },
    {
      "name": "Chaoyang",
      "id": "101010300",
      "lat": "39.92149",
      "lon": "116.48641",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "15",
      "fxLink": "https://www.qweather.com/en/weather/chaoyang-101010300.html"
    },
    {
      "name": "Shenzhen",
      "id": "101280601",
      "lat": "22.54700",
      "lon": "114.08595",
      "adm2": "Shenzhen",
      "adm1": "Guangdong",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "13",
      "fxLink": "https://www.qweather.com/en/weather/shenzhen-101280601.html"
    },
    {
      "name": "Haidian",
      "id": "101010200",
      "lat": "39.95607",
      "lon": "116.31032",
      "adm2": "Beijing",
      "adm1": "Beijing",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "15",
      "fxLink": "https://www.qweather.com/en/weather/haidian-101010200.html"
    },
    {
      "name": "Jiading",
      "id": "101020500",
      "lat": "31.38352",
      "lon": "121.25034",
      "adm2": "Shanghai",
      "adm1": "Shanghai",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "23",
      "fxLink": "https://www.qweather.com/en/weather/jiading-101020500.html"
    },
    {
      "name": "Jinshui",
      "id": "101180112",
      "lat": "34.77584",
      "lon": "113.68604",
      "adm2": "Zhengzhou",
      "adm1": "Henan",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "25",
      "fxLink": "https://www.qweather.com/en/weather/jinshui-101180112.html"
    },
    {
      "name": "Pudong",
      "id": "101020600",
      "lat": "31.24594",
      "lon": "121.56770",
      "adm2": "Shanghai",
      "adm1": "Shanghai",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "15",
      "fxLink": "https://www.qweather.com/en/weather/pudong-101020600.html"
    },
    {
      "name": "Shanghai",
      "id": "101020100",
      "lat": "31.23171",
      "lon": "121.47264",
      "adm2": "Shanghai",
      "adm1": "Shanghai",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "11",
      "fxLink": "https://www.qweather.com/en/weather/shanghai-101020100.html"
    },
    {
      "name": "Hangzhou",
      "id": "101210101",
      "lat": "30.24603",
      "lon": "120.21079",
      "adm2": "Hangzhou",
      "adm1": "Zhejiang",
      "country": "China",
      "tz": "Asia/Shanghai",
      "utcOffset": "+08:00",
      "isDst": "0",
      "type": "city",
      "rank": "11",
      "fxLink": "https://www.qweather.com/en/weather/hangzhou-101210101.html"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code

string

Status code
topCityList

object

Top city list
- name
  
  string
  
  Location Name
- id
  
  string
  
  Location ID
- lat
  
  string
  
  Latitude
- lon
  
  string
  
  Longitude
- adm2
  
  string
  
  Name of the superior administrative division of the location
- adm1
  
  string
  
  The first-level administrative area of the location
- country
  
  string
  
  Country name
- tz
  
  string
  
  Timezone for this location
- utcOffset
  
  string
  
  The number of hours offset between local time and UTC time, refer to UTC Offset
- isDst
  
  string
  
  Whether the location is observing daylight saving time: 1 for daylight saving time, 0 otherwise
- type
  
  string
  
  Location type
- rank
  
  string
  
  Location rank
- fxLink
  
  uri
  
  Responsive web page of this location, easy to embed in your website or APP
refer

object

Data sources and licensing information
- sources
  
  array
  
  Data source and other statements, may be null
- license
  
  array
  
  Data license, may be null