Storm List

Platform: API iOS Android

Get a list of tropical cyclones for the last 2 years in major ocean basins around the world.

Only the coastal areas of China are supported now, i.e. basin=NP

Request URL

https://api.qweather.com/v7/tropical/storm-list?{QueryParams}

Request Parameters

All parameters are separated by &. If no optional parameters are set, the default value will be used.

basin(required)The basin where the storm needs to be queried. For now, only support NP.
- AL North Atlantic
- EP Eastern Pacific
- NP NorthWest Pacific
- SP SouthWestern Pacific
- NI North Indian North Indian Ocean
- SI South Indian South Indian Ocean
year(required)Support to query storm of this year and last year, e.g., year=2020
key(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example: key=12334567890ABC

Request Example

Storm list for NorthWest Pacific in 2020

curl -L -X GET --compressed 'https://api.qweather.com/v7/tropical/storm-list?basin=NP&year=2020&key=YOUR_KEY'

Response

The response is in JSON format and is Gzip compressed.

{
  "code": "200",
  "updateTime": "2020-12-31T16:00+00:00",
  "fxLink": "https://www.qweather.com",
  "storm": [
    {
      "id": "NP_2022",
      "name": "环高",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2021",
      "name": "艾涛",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2020",
      "name": "艾莎尼",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2019",
      "name": "天鹅",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2018",
      "name": "莫拉菲",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2017",
      "name": "沙德尔",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_200012",
      "name": "无命名",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2016",
      "name": "浪卡",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2015",
      "name": "莲花",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2014",
      "name": "灿鸿",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2013",
      "name": "鲸鱼",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2012",
      "name": "白海豚",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2011",
      "name": "红霞",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2010",
      "name": "海神",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2009",
      "name": "美莎克",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2008",
      "name": "巴威",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2007",
      "name": "海高斯",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2006",
      "name": "米克拉",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2005",
      "name": "蔷薇",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2004",
      "name": "黑格比",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2003",
      "name": "森拉克",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2002",
      "name": "鹦鹉",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2001",
      "name": "黄蜂",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    }
  ],
  "refer": {
    "sources": [
      "NMC"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code See Status Code
updateTime API last update time
fxLink Responsive web page of this data, for embedded in website or APP
storm.id Storm ID
storm.stormId Storm ID
storm.name Storm name
storm.basin The basin of the storm
storm.year Year of the storm
storm.isActive Whether it is an active storm? 1 = Active and 0 = Stopped
refer.sources Data source and other statements, may be null
refer.license Data license, may be null