Real-time Air Quality

Platform: API iOS Android

Real-time air quality for Chinese cities and 1,700 monitoring stations, including AQI, air quality levels, primary pollutants, PM10, PM2.5, ozone, nitrogen dioxide sulfur dioxide and carbon monoxide values.

Request URL

https://api.qweather.com/v7/air/now?[params]

For Free subscription, change the API Host to devapi.qweather.com. See data available for Free subscription.

Request Parameters

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

key(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example: key=12334567890ABC
location(required)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. Example: location=101010100 or location=116.41,39.92
langMulti-language setting, see Language code for available value. If data does not match the language you set, it will return results in English or its native language.

Request Example

Real-time air quality for Beijing

curl -L -X GET --compressed 'https://api.qweather.com/v7/air/now?location=101010100&key=YOUR_KEY'

Response

The response is in JSON format and is Gzip compressed, all fields are Strings.

{
  "code": "200",
  "updateTime": "2021-02-16T14:42+08:00",
  "fxLink": "http://hfx.link/2ax4",
  "now": {
    "pubTime": "2021-02-16T14:00+08:00",
    "aqi": "28",
    "level": "1",
    "category": "优",
    "primary": "NA",
    "pm10": "28",
    "pm2p5": "5",
    "no2": "3",
    "so2": "2",
    "co": "0.2",
    "o3": "76"
  },
  "station": [
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "密云镇",
      "id": "CNA3697",
      "aqi": "20",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "4",
      "pm2p5": "4",
      "no2": "4",
      "so2": "3",
      "co": "0.2",
      "o3": "63"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "丰台小屯",
      "id": "CNA3696",
      "aqi": "57",
      "level": "2",
      "category": "良",
      "primary": "PM10",
      "pm10": "63",
      "pm2p5": "6",
      "no2": "4",
      "so2": "2",
      "co": "0.2",
      "o3": "73"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "怀柔新城",
      "id": "CNA3695",
      "aqi": "25",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "7",
      "pm2p5": "3",
      "no2": "2",
      "so2": "3",
      "co": "0.1",
      "o3": "78"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "延庆石河营",
      "id": "CNA3694",
      "aqi": "26",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "15",
      "pm2p5": "3",
      "no2": "4",
      "so2": "2",
      "co": "0.4",
      "o3": "83"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "大兴旧宫",
      "id": "CNA3675",
      "aqi": "31",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "31",
      "pm2p5": "5",
      "no2": "2",
      "so2": "1",
      "co": "0.2",
      "o3": "73"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "房山燕山",
      "id": "CNA3674",
      "aqi": "26",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "19",
      "pm2p5": "4",
      "no2": "3",
      "so2": "4",
      "co": "0.2",
      "o3": "83"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "通州东关",
      "id": "CNA3673",
      "aqi": "22",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "15",
      "pm2p5": "4",
      "no2": "1",
      "so2": "3",
      "co": "0.3",
      "o3": "70"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "丰台云岗",
      "id": "CNA3672",
      "aqi": "45",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "45",
      "pm2p5": "5",
      "no2": "1",
      "so2": "1",
      "co": "0.2",
      "o3": "82"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "门头沟三家店",
      "id": "CNA3671",
      "aqi": "66",
      "level": "2",
      "category": "良",
      "primary": "PM10",
      "pm10": "82",
      "pm2p5": "6",
      "no2": "2",
      "so2": "1",
      "co": "0.2",
      "o3": "76"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "密云新城",
      "id": "CNA3418",
      "aqi": "23",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "11",
      "pm2p5": "3",
      "no2": "2",
      "so2": "3",
      "co": "0.2",
      "o3": "73"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "平谷新城",
      "id": "CNA3417",
      "aqi": "24",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "7",
      "pm2p5": "3",
      "no2": "1",
      "so2": "2",
      "co": "0.2",
      "o3": "74"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "延庆夏都",
      "id": "CNA3281",
      "aqi": "25",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "15",
      "pm2p5": "3",
      "no2": "2",
      "so2": "1",
      "co": "0.2",
      "o3": "80"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "古城",
      "id": "CNA1012",
      "aqi": "56",
      "level": "2",
      "category": "良",
      "primary": "PM10",
      "pm10": "61",
      "pm2p5": "8",
      "no2": "2",
      "so2": "1",
      "co": "0.2",
      "o3": "76"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "奥体中心",
      "id": "CNA1011",
      "aqi": "24",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "23",
      "pm2p5": "3",
      "no2": "4",
      "so2": "2",
      "co": "0.2",
      "o3": "74"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "昌平镇",
      "id": "CNA1010",
      "aqi": "24",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "17",
      "pm2p5": "5",
      "no2": "2",
      "so2": "1",
      "co": "0.2",
      "o3": "75"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "怀柔镇",
      "id": "CNA1009",
      "aqi": "25",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "10",
      "pm2p5": "8",
      "no2": "2",
      "so2": "3",
      "co": "0.2",
      "o3": "77"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "顺义新城",
      "id": "CNA1008",
      "aqi": "33",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "33",
      "pm2p5": "5",
      "no2": "1",
      "so2": "3",
      "co": "0.2",
      "o3": "73"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "海淀区万柳",
      "id": "CNA1007",
      "aqi": "34",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "34",
      "pm2p5": "6",
      "no2": "6",
      "so2": "1",
      "co": "0.2",
      "o3": "75"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "官园",
      "id": "CNA1006",
      "aqi": "25",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "25",
      "pm2p5": "5",
      "no2": "4",
      "so2": "3",
      "co": "0.2",
      "o3": "78"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "农展馆",
      "id": "CNA1005",
      "aqi": "28",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "28",
      "pm2p5": "4",
      "no2": "2",
      "so2": "3",
      "co": "0.2",
      "o3": "85"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "天坛",
      "id": "CNA1004",
      "aqi": "29",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "29",
      "pm2p5": "10",
      "no2": "2",
      "so2": "1",
      "co": "0.2",
      "o3": "78"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "东四",
      "id": "CNA1003",
      "aqi": "30",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "30",
      "pm2p5": "7",
      "no2": "2",
      "so2": "3",
      "co": "0.1",
      "o3": "80"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "定陵",
      "id": "CNA1002",
      "aqi": "23",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "22",
      "pm2p5": "3",
      "no2": "2",
      "so2": "1",
      "co": "0.2",
      "o3": "73"
    },
    {
      "pubTime": "2021-02-16T14:00+08:00",
      "name": "万寿西宫",
      "id": "CNA1001",
      "aqi": "29",
      "level": "1",
      "category": "优",
      "primary": "NA",
      "pm10": "29",
      "pm2p5": "5",
      "no2": "3",
      "so2": "1",
      "co": "0.3",
      "o3": "75"
    }
  ],
  "refer": {
    "sources": [
      "cnemc"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

station, the air data from monitoring station are only response for cities in POI-Air-Monitoring-Station-List.

code See Status Code
updateTime API last update time
fxLink Responsive web page of this data, for embedded in website or APP
now.pubTime The data release time from the data source
now.aqi Air Quality Index
now.level AQI level
now.category AQI category
now.primary The main pollutant. If level=1, return NA
now.pm10 PM10
now.pm2p5 PM2.5
now.no2 Nitrogen dioxide
now.so2 Sulfur dioxide
now.co Carbon monoxide
now.o3 Ozone
station.name The name of the monitoring station
station.id ID of the monitoring station
station.pubTime The data release time from the data source
station.aqi Air Quality Index
station.level AQI level
station.category AQI category
station.primary The main pollutant. If level=1, return NA
station.pm10 PM10
station.pm2p5 PM2.5
station.no2 Nitrogen dioxide
station.so2 Sulfur dioxide
station.co Carbon monoxide
station.o3 Ozone
refer.sources Data source and other statements, may be null
refer.license Data license, may be null

Air Quality Index Level

See Air Quality Info.