Air Quality Daily Forecast

Get daily AQI forecasts, pollutant concentrations, and health guidance for the next 3 days.

Endpoint#

GET /airquality/v1/daily/{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/daily/39.92/116.41'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "metadata": {
    "tag": "4b78230843e636a6f910631d94878da73aa980a66abfcf53d35f9c06493a292d",
    "attributions": [
      "https://developer.qweather.com/attribution.html"
    ]
  },
  "days": [
    {
      "forecastStartTime": "2023-02-14T23:00Z",
      "forecastEndTime": "2023-02-15T23:00Z",
      "indexes": [
        {
          "code": "qaqi",
          "name": "QAQI",
          "aqi": 1.0,
          "aqiDisplay": "1.0",
          "level": "1",
          "category": "Excellent",
          "color": {
            "red": 195,
            "green": 217,
            "blue": 78,
            "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."
            }
          }
        },
        {
          "code": "eu-eea",
          "name": "EAQI (EU)",
          "aqi": 2,
          "aqiDisplay": "2",
          "level": "2",
          "category": "Fair",
          "color": {
            "red": 80,
            "green": 204,
            "blue": 170,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "pm2p5",
            "name": "PM 2.5",
            "fullName": "Fine particulate matter (<2.5µm)"
          },
          "health": {
            "effect": null,
            "advice": {
              "generalPopulation": "Enjoy your usual outdoor activities.",
              "sensitivePopulation": "Enjoy your usual outdoor activities."
            }
          }
        }
      ],
      "pollutants": [
        {
          "code": "pm2p5",
          "name": "PM 2.5",
          "fullName": "Fine particulate matter (<2.5µm)",
          "concentration": {
            "value": 11.88,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 2,
              "aqiDisplay": "2"
            },
            {
              "code": "qaqi",
              "aqi": 1,
              "aqiDisplay": "1"
            }
          ]
        },
        {
          "code": "pm10",
          "name": "PM 10",
          "fullName": "Inhalable particulate matter (<10µm)",
          "concentration": {
            "value": 2.38,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "no2",
          "name": "NO2",
          "fullName": "Nitrogen dioxide",
          "concentration": {
            "value": 4.1,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "o3",
          "name": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 36.33,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.8,
              "aqiDisplay": "0.8"
            }
          ]
        },
        {
          "code": "so2",
          "name": "SO2",
          "fullName": "Sulfur dioxide",
          "concentration": {
            "value": 32.13,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.7,
              "aqiDisplay": "0.7"
            }
          ]
        }
      ]
    },
    {
      "forecastStartTime": "2023-02-15T23:00Z",
      "forecastEndTime": "2023-02-16T23:00Z",
      "indexes": [
        {
          "code": "qaqi",
          "name": "QAQI",
          "aqi": 1.1,
          "aqiDisplay": "1.1",
          "level": "1",
          "category": "Excellent",
          "color": {
            "red": 195,
            "green": 217,
            "blue": 78,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": "No health implications.",
            "advice": {
              "generalPopulation": "Enjoy your outdoor activities.",
              "sensitivePopulation": "Enjoy your outdoor activities."
            }
          }
        },
        {
          "code": "eu-eea",
          "name": "EAQI (EU)",
          "aqi": 2,
          "aqiDisplay": "2",
          "level": "2",
          "category": "Fair",
          "color": {
            "red": 80,
            "green": 204,
            "blue": 170,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": null,
            "advice": {
              "generalPopulation": "Enjoy your usual outdoor activities.",
              "sensitivePopulation": "Enjoy your usual outdoor activities."
            }
          }
        }
      ],
      "pollutants": [
        {
          "code": "pm2p5",
          "name": "PM 2.5",
          "fullName": "Fine particulate matter (<2.5µm)",
          "concentration": {
            "value": 9.13,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.8,
              "aqiDisplay": "0.8"
            }
          ]
        },
        {
          "code": "pm10",
          "name": "PM 10",
          "fullName": "Inhalable particulate matter (<10µm)",
          "concentration": {
            "value": 1.08,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "no2",
          "name": "NO2",
          "fullName": "Nitrogen dioxide",
          "concentration": {
            "value": 2.34,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "o3",
          "name": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 53.33,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 2,
              "aqiDisplay": "2"
            },
            {
              "code": "qaqi",
              "aqi": 1.1,
              "aqiDisplay": "1.1"
            }
          ]
        },
        {
          "code": "so2",
          "name": "SO2",
          "fullName": "Sulfur dioxide",
          "concentration": {
            "value": 22.17,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.5,
              "aqiDisplay": "0.5"
            }
          ]
        }
      ]
    },
    {
      "forecastStartTime": "2023-02-16T23:00Z",
      "forecastEndTime": "2023-02-17T23:00Z",
      "indexes": [
        {
          "code": "qaqi",
          "name": "QAQI",
          "aqi": 0.9,
          "aqiDisplay": "0.9",
          "level": "1",
          "category": "Excellent",
          "color": {
            "red": 195,
            "green": 217,
            "blue": 78,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": "No health implications.",
            "advice": {
              "generalPopulation": "Enjoy your outdoor activities.",
              "sensitivePopulation": "Enjoy your outdoor activities."
            }
          }
        },
        {
          "code": "eu-eea",
          "name": "EAQI (EU)",
          "aqi": 1,
          "aqiDisplay": "1",
          "level": "1",
          "category": "Good",
          "color": {
            "red": 80,
            "green": 240,
            "blue": 230,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": null,
            "advice": {
              "generalPopulation": "The air quality is good. Enjoy your usual outdoor activities.",
              "sensitivePopulation": "The air quality is good. Enjoy your usual outdoor activities."
            }
          }
        }
      ],
      "pollutants": [
        {
          "code": "pm2p5",
          "name": "PM 2.5",
          "fullName": "Fine particulate matter (<2.5µm)",
          "concentration": {
            "value": 8.5,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.7,
              "aqiDisplay": "0.7"
            }
          ]
        },
        {
          "code": "pm10",
          "name": "PM 10",
          "fullName": "Inhalable particulate matter (<10µm)",
          "concentration": {
            "value": 1.54,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "no2",
          "name": "NO2",
          "fullName": "Nitrogen dioxide",
          "concentration": {
            "value": 2.77,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "o3",
          "name": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 43.86,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.9,
              "aqiDisplay": "0.9"
            }
          ]
        },
        {
          "code": "so2",
          "name": "SO2",
          "fullName": "Sulfur dioxide",
          "concentration": {
            "value": 20.94,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.5,
              "aqiDisplay": "0.5"
            }
          ]
        }
      ]
    }
  ]
}
  • 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
  • days
    array
    Daily AQI list
    • forecastStartTime
      date-time
      Forecast start time
    • forecastEndTime
      date-time
      Forecast end time
    • 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
      • 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
      • 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