Current Air Quality

The Current Air Quality API provides real-time air quality data worldwide for a specified location at 1-kilometer resolution, including:

• AQI, category, color and primary pollutant based on local standards for each country or region
• Generic QWeather AQI
• Pollutant concentrations and sub-indexes
• Health guidance

Endpoint#

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

Parameters#

Path parameters

• latitude ^required

  number

  Latitude of the requested location in decimal degrees
• longitude ^required

  number

  Longitude of the requested location in decimal degrees

Query parameters

• lang

  string

  Language setting. See Language for behavior, configuration, and data availability

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/airquality/v1/current/39.92/116.41'

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 data identifier
  • attributions

    array

    Data attribution or statements that must be displayed with the response data
• indexes

  array

  Air quality index list. See Supported AQIs
  • code

    string

    Air quality index code
  • name

    string

    Name of air quality index
  • aqi

    number

    Numeric air quality index value, including a numeric conversion when the standard value contains non-numeric characters, for use in calculations
  • aqiDisplay

    string

    Standard display value of the air quality index, which may contain non-numeric characters and is recommended for display to users
  • 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, range [0, 255]
    • green

      number

      Green component, range [0, 255]
    • blue

      number

      Blue component, range [0, 255]
    • alpha

      number

      Alpha component, range [0, 1]
  • primaryPollutant

    object

    The primary pollutant is the main component responsible for the current air pollution
    • code

      string

      Primary pollutant code
    • name

      string

      Name of primary pollutant
    • fullName

      string

      Full name of primary pollutant
  • health

    object

    Air quality health effects and guidance for the general and sensitive populations
    • 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
  • code

    string

    Pollutant code. Available values: pm10, pm2p5, co, no, no2, so2, o3, and nmhc
  • name

    string

    Name of pollutant
  • fullName

    string

    Full name of pollutant
  • concentration

    object

    Concentration of pollutant
    • value

      number

      Value
    • unit

      string

      Unit
  • subIndexes

    array

    Air quality sub-indexes for the pollutant. The highest pollutant sub-index generally determines the current AQI and the primary pollutant
    • code

      string

      Air quality index code associated with the sub-index
    • aqi

      number

      Sub-index value for pollutant
    • aqiDisplay

      string

      Sub-index for display