Air Quality Daily Forecast

Air Quality Daily Forecast API for Chinese cities, including AQI, air quality levels, primary pollutants.

Request URL

  • Prohttps://api.qweather.com/v7/air/5d?[params]

Request Parameters

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

key

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

For example: key=12334567890ABC

location

The location to be queried, support LocationID or comma-separated longitude and latitude, LocationID can be obtained by GeoAPI.

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

lang

Multi-language setting, if data does not match the language you set, it will return results in English or its native language.

gzip

Enable Gzip can greatly reduce the latency of API access, save network traffic.

  • y enable gzip, default
  • n disable gzip

Response 

// Beijing air quality daily forecast 
// Business API: https://api.qweather.com/v7/air/5d?location=101010100&lang=en&key=YOUR_KEY

{
  "code": "200",
  "updateTime": "2021-02-06T16:42+08:00",
  "fxLink": "http://hfx.link/2ax4",
  "daily": [
    {
      "fxDate": "2021-02-06",
      "aqi": "54",
      "level": "2",
      "category": "Good",
      "primary": "PM10"
    },
    {
      "fxDate": "2021-02-07",
      "aqi": "49",
      "level": "1",
      "category": "Excellent",
      "primary": "NA"
    },
    {
      "fxDate": "2021-02-08",
      "aqi": "81",
      "level": "2",
      "category": "Good",
      "primary": "PM2.5"
    },
    {
      "fxDate": "2021-02-09",
      "aqi": "87",
      "level": "2",
      "category": "Good",
      "primary": "PM2.5"
    },
    {
      "fxDate": "2021-02-10",
      "aqi": "96",
      "level": "2",
      "category": "Good",
      "primary": "PM2.5"
    }
  ],
  "refer": {
    "sources": [
      "cnemc"
    ],
    "license": [
      "commercial license"
    ]
  }
}
Parameters Description
code

API status code, please refer to Status Code
updateTime

API last update time
fxLink

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

Forecast date
daily.aqi

Air Quality Index
daily.level

AQI level
daily.category

AQI category
daily.primary

The main pollutant. If level=1, return NA
refer.sources

Data source and other statements, may be null
refer.license

Data license, may be null

Air Quality Index Level

AQI Level Category Category Color
0-50 Level 1 Excellent Green
51-100 Level 2 Good Yellow
101-150 Level 3 Lightly Pollution Orange
151-200 Level 4 Moderate pollution Red
201-300 Level 5 Heavy pollution Purple
>300 Level 6 Serious pollution Maroon