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.

Note: Air Quality API v1 (new) is now available, please try to use and upgrade.

Endpoint

/v7/air/now

Parameters

Query parameters

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, please see Language to find out how our multi-language works and how to set up.

Request example

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your_api_host/v7/air/now?location=101010100'

Replace your_token and your_api_host with your JWT Authentication and API Host

Response

The response is in JSON format and is Gzip compressed.

{
  "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.