Current Air Quality (new)

Platform: API

The current air quality (AQI) API provides real-time air quality data for specified locations, data resolution is 1x1 km.

AQI, category, color and primary pollutant based on local standards for each country or region
Generic QWeather AQI
Pollutant concentration values and their sub-index.
Health effects and advice
Associated monitoring station information

We recommend to read Air Quality Info to learn about the AQIs, pollutants, supported regions and more.

Request URL

https://api.qweather.com/airquality/v1/current/{latitude}/{longitude}

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

Path Parameters

latitude(required)The latitude of the desired location. Decimal format, up to 2 decimal places. For example 39.92
longitude(required)The longitude of the desired location. Decimal format, up to 2 decimal places. For example 116.41

Query Parameters

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://api.qweather.com/airquality/v1/current/39.90/116.40'

Replace your_token with your JWT or learn more about Authentication

Response

The response is in JSON format and is Gzip compressed.

{
  "metadata": {
    "tag": "d75a323239766b831889e8020cba5aca9b90fca5080a1175c3487fd8acb06e84"
  },
  "indexes": [
    {
      "code": "us-epa",
      "name": "AQI (US)",
      "aqi": 46,
      "aqiDisplay": "46",
      "level": "1",
      "category": "Good",
      "color": {
        "red": 0,
        "green": 228,
        "blue": 0,
        "alpha": 1
      },
      "primaryPollutant": {
        "code": "pm2p5",
        "name": "PM 2.5",
        "fullName": "Fine particulate matter (<2.5µm)"
      },
      "health": {
        "effect": "No health effects.",
        "advice": {
          "generalPopulation": "Everyone can continue their outdoor activities normally.",
          "sensitivePopulation": "Everyone can continue their outdoor activities normally."
        }
      }
    },
    {
      "code": "qaqi",
      "name": "QAQI",
      "aqi": 0.9,
      "aqiDisplay": "0.9",
      "level": "1",
      "category": "Excellent",
      "color": {
        "red": 80,
        "green": 240,
        "blue": 230,
        "alpha": 1
      },
      "primaryPollutant": {
        "code": "pm2p5",
        "name": "PM 2.5",
        "fullName": "Fine particulate matter (<2.5µm)"
      },
      "health": {
        "effect": "No health implications.",
        "advice": {
          "generalPopulation": "Enjoy your outdoor activities.",
          "sensitivePopulation": "Enjoy your outdoor activities."
        }
      }
    }
  ],
  "pollutants": [
    {
      "code": "pm2p5",
      "name": "PM 2.5",
      "fullName": "Fine particulate matter (<2.5µm)",
      "concentration": {
        "value": 11.0,
        "unit": "μg/m3"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 46,
          "aqiDisplay": "46"
        },
        {
          "code": "qaqi",
          "aqi": 0.9,
          "aqiDisplay": "0.9"
        }
      ]
    },
    {
      "code": "pm10",
      "name": "PM 10",
      "fullName": "Inhalable particulate matter (<10µm)",
      "concentration": {
        "value": 12.0,
        "unit": "μg/m3"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 12,
          "aqiDisplay": "12"
        },
        {
          "code": "qaqi",
          "aqi": 0.5,
          "aqiDisplay": "0.5"
        }
      ]
    },
    {
      "code": "no2",
      "name": "NO2",
      "fullName": "Nitrogen dioxide",
      "concentration": {
        "value": 6.77,
        "unit": "ppb"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 7,
          "aqiDisplay": "7"
        },
        {
          "code": "qaqi",
          "aqi": 0.1,
          "aqiDisplay": "0.1"
        }
      ]
    },
    {
      "code": "o3",
      "name": "O3",
      "fullName": "Ozone",
      "concentration": {
        "value": 0.02,
        "unit": "ppb"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 21,
          "aqiDisplay": "21"
        },
        {
          "code": "qaqi",
          "aqi": 0.2,
          "aqiDisplay": "0.2"
        }
      ]
    },
    {
      "code": "co",
      "name": "CO",
      "fullName": "Carbon monoxide",
      "concentration": {
        "value": 0.25,
        "unit": "ppm"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 3,
          "aqiDisplay": "3"
        },
        {
          "code": "qaqi",
          "aqi": 0.1,
          "aqiDisplay": "0.1"
        }
      ]
    }
  ],
  "stations": [
    {
      "id": "P51762",
      "name": "North Holywood"
    },
    {
      "id": "P58056",
      "name": "Pasadena"
    },
    {
      "id": "P57327",
      "name": "Los Angeles - N. Main Street"
    }
  ]
}

metadata.tag Unique tag for this data
indexes.code Code of air quality index
indexes.name Name of air quality index
indexes.aqi Value of air quality index
indexes.aqiDisplay Display name of the AQI value
indexes.level Level of air quality index
indexes.category Category of air quality index
indexes.color.red Red in RGBA color for AQI
indexes.color.green Green in RGBA color for AQI
indexes.color.blue Blue in RGBA color for AQI
indexes.color.alpha Alpha in RGBA color for AQI
indexes.primaryPollutant.code The primary pollutant code, maybe NULL.
indexes.primaryPollutant.name Name of primary pollutant, maybe NULL.
indexes.primaryPollutant.fullName Full name of primary pollutant, maybe NULL.
indexes.health.effect Health effects of air quality, maybe NULL.
indexes.health.advice.generalPopulation Health advice for general population, maybe NULL.
indexes.health.advice.sensitivePopulation Health advice for sensitive population, maybe NULL.
pollutants.code The pollutant code.
pollutants.name Name of pollutant.
pollutants.fullName Full name of pollutant.
pollutants.concentration.value Concentration values of pollutants.
pollutants.concentration.unit Units for concentration values of pollutants.
pollutants.subIndexes.code Code of air quality sub-index, maybe NULL.
pollutants.subIndexes.aqi Sub-index value for pollutant, maybe NULL.
pollutants.subIndexes.aqiDisplay Sub-index for display, maybe NULL.
stations.id Location ID of the monitoring station for this AQI reference, maybe NULL.
stations.name Name of the monitoring station for this AQI reference, maybe NULL.