Current Air Quality

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.

Endpoint#

GET /airquality/v1/current/{latitude}/{longitude}

Parameters#

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

  • lang Multi-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/airquality/v1/current/39.92/116.41?lang=en'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "metadata": {
    "tag": "d75a323239766b831889e8020cba5aca9b90fca5080a1175c3487fd8acb06e84",
    "attributions": [
      "https://developer.qweather.com/attribution.html"
    ]
  },
  "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 object Metadata for this response
    • tag string Unique tag for this data
    • attributions array Data attribution list that must be displayed with the current data
  • indexes array Air quality index list
    • code string Code of air quality index
    • name string Name of air quality index
    • aqi number Value of air quality index
    • aqiDisplay string Display name of the AQI value
    • level string Level of air quality index
    • category string Category of air quality index
    • color object RGBA color for the air quality index
      • red number Red component in RGBA, [0, 255]
      • green number Green component in RGBA, [0, 255]
      • blue number Blue component in RGBA, [0, 255]
      • alpha number Alpha (opacity) in RGBA, [0, 1]
    • primaryPollutant object Primary pollutant. May be NULL
      • code string Code of primary pollutan
      • name string Name of primary pollutant
      • fullName string Full name of primary pollutant
    • health object AQI health information
      • effect string Health effects of air quality, maybe NULL
      • advice object Health advice, may be NULL
        • generalPopulation string Health advice for general population, maybe NULL
        • sensitivePopulation string Health advice for sensitive population, maybe NULL
  • pollutants array Pollutant list, may be NULL
    • code string Code of pollutant
    • name string Name of pollutant
    • fullName string Full name of pollutant
    • concentration object Concentration of pollutant
      • value number Value
      • unit string Unit
    • subIndexes array Sub-index list, maybe NULL
      • code string Code of sub-index
      • aqi number Sub-index value for pollutant
      • aqiDisplay string Sub-index for display
  • stations array Monitoring station for this AQI reference, maybe NULL
    • id string Location ID of the monitoring station
    • name string Name of the monitoring station