Weather Warning

Weather Warning API for getting real-time local severe weather warning around the world.

You can also first get a list of all cities in a given country or region where warnings are currently in effect via Weather Warning City List API.

Request URL

  • Pro[params]
  • Dev[params]

Request Parameters

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


API authentication key, please refer to How To Get Your Key. Support Signature Authentication.

For example: key=12334567890ABC


The location to be queried, support LocationID or comma-separated longitude and latitude (decimal, up to 2 decimal places), LocationID can be obtained by GeoAPI.

For example: location=101010100 or location=116.41,39.92

Weather warnings are not available in all cities, see supported countries or regions for weather warnings.


Multi-language settings, only support Chinese and English for this data.

  • zh Chinese, default
  • en English


If there is no warning information in the queried location, the warning field is empty.

// Xiamen's weather warning 
// Pro API:
// Dev API:

  "code": "200",
  "updateTime": "2021-10-10T12:14+08:00",
  "fxLink": "",
  "warning": [
      "id": "10123020120211010110800706404402",
      "sender": "Xiamen_meteorological_observatory",
      "pubTime": "2021-10-10T11:08+08:00",
      "title": "Xiamen meteorological observatory issued a yellow typhoon warning [level III / heavy]",
      "startTime": "2021-10-10T11:15+08:00",
      "endTime": "2021-10-11T11:15+08:00",
      "status": "active",
      "level": "Yellow",
      "severity": "Moderate",
      "severityColor": "Yellow",
      "type": "1001",
      "typeName": "Typhoon",
      "text": "At 11:08 on October 10, 2021, Xiamen meteorological observatory issued a typhoon yellow warning signal: this year s No. 18 typhoon \"compass\" (tropical storm level) today at 08:00, the center is about 890 km east by north of Manila, the Philippines, and the maximum wind force near the center is level 8 (20 m / s). It is expected that the typhoon center will move northwest at a speed of about 25 kilometers per hour, and then turn to the West. Affected by the \"compass\" and cold air, the maximum northeast wind in Siming District, Huli District, Haicang District and Jimei District can reach 6 ~ 7 and gust 8 ~ 9 from day to night, Xiamen inland sea and bridges, high-altitude mountainous areas 8 ~ 9 and gust 10 ~ 11, Chongwu to Dongshan coastal area 9 ~ 10 and gust 11 ~ 12; In the southern Taiwan Strait, there are 10 ~ 11 levels and 12 gusts. Please take precautions. Tongan District and Xiang an District, please pay attention to the release of early warning signals.",
      "related": ""
      "id": "10123020120211010093800616071831",
      "sender": "Xiamen_meteorological_observatory",
      "pubTime": "2021-10-10T09:38+08:00",
      "title": "Xiamen meteorological observatory issued a yellow gale warning [level III / heavy]",
      "startTime": "2021-10-10T09:45+08:00",
      "endTime": "2021-10-11T09:45+08:00",
      "status": "active",
      "level": "Yellow",
      "severity": "Moderate",
      "severityColor": "Yellow",
      "type": "1006",
      "typeName": "Gale",
      "text": "At 09:38 on October 10, 2021, Xiamen meteorological observatory continued to issue the yellow warning signal of strong wind: affected by the typhoon \"compass\" and cold air, the wind in Jimei District, Haicang District, Huli District, Siming District and coastal areas will still be strong in the next 12 hours. It is expected that the maximum wind force in inland sea, bridges and high-altitude mountainous areas can reach 7-8 and gust 9-10; From Chongwu to Dongshan coast, the maximum can reach level 8 ~ 9 and gust level 10 ~ 11; In the south of the Taiwan Strait, the maximum can reach 9 ~ 10 and gust 11 ~ 12. Please take precautions! Tongan District and Xiang an District, please pay attention to the release of early warning signals.",
      "related": "10123020120211009213700075228006"
  "refer": {
    "sources": [
    "license": [
      "commercial license"
Parameters Description

API status code, please refer to Status Code


API last update time


Responsive web page of this data, for embedded in website or APP

The unique ID of this warning, which can be used to determine whether this warning already exists.


Warning issuing unit, may be null


Warning release time


Title of warning


Warning start time, may be null


End time of warning, may be null


Warning status


Warning level(deprecated), this field is deprecated and uses severity and severityColor instead


Warning severity


Preferred color for severity, may be null


Warning type ID


Warning type name


The urgency of the warning message, may be null


The certainty of the warning message, may be null


Description of the warning


The warning ID associated with this warning, returned when the warning status is cancel or update. May be null


Data source and other statements, may be null


Data license, may be null

See also