Copy page

Air Quality

Guide

The Air Quality API provides current conditions, forecasts, and observational data for air quality indices and pollutants worldwide.

For full request and response field details, see Air Quality Parameters.

Version 2 — Current conditions & forecasts

Endpoint	Description
Current air quality conditions	Current AQI and pollutant data
Hourly air quality forecasts	Hourly AQI forecasts (1–96 hours)
Daily air quality forecasts	Daily AQI forecasts (1–7 days)

Version 2 — Observational

Endpoint	Description
Current air quality observation	Raw observational data (China/South Korea)
Past day air quality observation	Past day raw observational data

Version 1 (deprecated)

Endpoint	Description
Current air quality (standard)	V1 standard current
Past day air quality (standard)	V1 standard past day
Current air quality (premium)	V1 premium current
Past day air quality (premium)	V1 premium past day

---

Current air quality conditions by location key

Note: this endpoint supports all AccuWeather locations. The pollutants request parameter is only available with the premium option.

Code
https://{baseUrl}/airquality/{version}/currentconditions/{locationKey}?apikey={your key}&pollutants={boolean}&language={language}

Examples

Code
https://api.accuweather.com/airquality/v2/currentconditions/201655?apikey={your key}&language=en-us

Code
{
    "success": true,
    "status": "200",
    "version": 2,
    "data": {
        "date": "2022-07-01T16:30:00+05:30",
        "epochDate": 1656673200,
        "overallIndex": 61.0,
        "overallPlumeLabsIndex": 26.6,
        "dominantPollutant": "Ozone",
        "category": "Fair",
        "categoryColor": "#FFC300",
        "hazardStatement": "The air quality is generally acceptable for most individuals. However, sensitive groups may experience minor to moderate symptoms from long-term exposure.",
        "link": "https://www.accuweather.com/en/in/shyamapur/3182693/air-quality-index/3182693?lang=en-us"
    }
}

Code
https://api.accuweather.com/airquality/v2/currentconditions/201655?apikey={your key}&pollutants=true&language=en-us

Code
{
    "success": true,
    "status": "200",
    "version": 2,
    "data": {
        "date": "2020-02-03T20:00:00+05:30",
        "epochDate": 1580760000,
        "overallIndex": 270.6,
        "overallPlumeLabsIndex": 208.8,
        "dominantPollutant": "Sulfure Dioxide",
        "category": "Very Unhealthy",
        "categoryColor": "#C72EAA",
        "hazardStatement": "Health effects will be immediately felt by sensitive groups and should avoid outdoor activity. Healthy individuals are likely to experience difficulty breathing and throat irritation; consider staying indoors and rescheduling outdoor activities.",
        "link": "https://www.accuweather.com/en/in/shyamapur/3182693/air-quality-index/3182693?lang=en-us",
        "pollutants": [
            {
                "type": "NO2",
                "name": "Nitrogen Dioxide",
                "index": 58.6,
                "plumeLabsIndex": 25.2,
                "concentration": {
                    "value": 46.9,
                    "unit": "ug/m3",
                    "unitType": 31
                },
                "source": "Plume Labs"
            },
            {
                "type": "O3",
                "name": "Ozone",
                "index": 32.9,
                "plumeLabsIndex": 13.2,
                "concentration": {
                    "value": 32.9,
                    "unit": "ug/m3",
                    "unitType": 31
                },
                "source": "Plume Labs"
            },
            {
                "type": "PM10",
                "name": "Particulate Matter 10",
                "index": 90.7,
                "plumeLabsIndex": 106.7,
                "concentration": {
                    "value": 90.7,
                    "unit": "ug/m3",
                    "unitType": 31
                },
                "source": "Plume Labs"
            },
            {...}
        ]
    }
}

Hourly air quality forecasts by location key

Note: this endpoint supports all AccuWeather locations. The pollutants request parameter is only available with the premium option.

Code
https://{baseUrl}/airquality/{version}/forecasts/hourly/{hour#}hour/{locationKey}?apikey={your key}&pollutants={boolean}&language={language}

Examples

Note: to change the forecast time span, change the 12 in "12hour" in the example below to the desired number of hours. Available time spans are 1, 12, 24, 48, 72, and 96 hours.

Code
https://api.accuweather.com/airquality/v2/forecasts/hourly/12hour/201655?apikey={your key}&language=en-us

Code
{
    "success": true,
    "status": "200",
    "version": 2,
    "data": [
        {
            "date": "2022-07-01T19:00:00+05:30",
            "epochDate": 1656682200,
            "overallIndex": 54.6,
            "overallPlumeLabsIndex": 22.8,
            "dominantPollutant": "Ozone",
            "category": "Fair",
            "categoryColor": "#FFC300",
            "hazardStatement": "The air quality is generally acceptable for most individuals. However, sensitive groups may experience minor to moderate symptoms from long-term exposure.",
            "link": "https://www.accuweather.com/en/in/shyamapur/3182693/air-quality-index/3182693?lang=en-us"
        },
        {...}
    ]
}

Code
https://api.accuweather.com/airquality/v2/forecasts/hourly/12hour/201655?apikey={your key}&pollutants=true&language=en-us

Code
{
    "success": true,
    "status": "200",
    "version": 2,
    "data": [
        {
            "date": "2020-02-03T21:00:00+05:30",
            "epochDate": 1580763600,
            "overallIndex": 250,
            "overallPlumeLabsIndex": 180,
            "dominantPollutant": "Sulfure Dioxide",
            "category": "Very Unhealthy",
            "categoryColor": "#C72EAA",
            "hazardStatement": "Health effects will be immediately felt by sensitive groups and should avoid outdoor activity. Healthy individuals are likely to experience difficulty breathing and throat irritation; consider staying indoors and rescheduling outdoor activities.",
            "link": "https://www.accuweather.com/en/in/shyamapur/3182693/air-quality-index/3182693?lang=en-us",
            "pollutants": [
                {
                    "type": "NO2",
                    "name": "Nitrogen Dioxide",
                    "index": 54,
                    "plumeLabsIndex": 23,
                    "concentration": {
                        "value": 44,
                        "unit": "ug/m3",
                        "unitType": 31
                    },
                    "source": "Plume Labs"
                },
                {...}
            ]
        },
        {...}
    ]
}

Daily air quality forecasts by location key

Note: this endpoint supports all AccuWeather locations.

Code
https://{baseUrl}/airquality/{version}/forecasts/daily/{day#}day/{locationKey}?apikey={your key}&language={language}

Example

Note: to change the forecast time span, change the 3 in "3day" in the example below to the desired number of days. Available time spans are 1, 2, 3, 4, 5, 6, and 7 days.

Code
https://api.accuweather.com/airquality/v2/forecasts/daily/3day/201655?apikey={your key}&language=en-us

Code
{
    "success": true,
    "status": "200",
    "version": 2,
    "data": [
        {
            "date": "2020-02-03T05:00:00+05:30",
            "epochDate": 1580706000,
            "overallIndex": 270.6,
            "overallPlumeLabsIndex": 208.8,
            "dominantPollutant": "Sulfure Dioxide",
            "category": "Very Unhealthy",
            "categoryColor": "#C72EAA",
            "hazardStatement": "Health effects will be immediately felt by sensitive groups and should avoid outdoor activity. Healthy individuals are likely to experience difficulty breathing and throat irritation; consider staying indoors and rescheduling outdoor activities.",
            "link": "https://www.accuweather.com/en/in/shyamapur/3182693/air-quality-index/3182693?lang=en-us"
        },
        {...}
    ]
}

---

Current air quality observation by location key

Note: this endpoint returns the same data as V1, except formatted for V2. Supports China and South Korea only.

Code
https://{baseUrl}/airquality/{version}/global/observations/{locationKey}?apikey={your key}

Example

Code
https://api.accuweather.com/airquality/v2/global/observations/101924?apikey={your key}

Code
{
    "success": true,
    "status": "200",
    "version": 2,
    "data": {
        "date": "2020-02-04T00:00:00+08:00",
        "epochDate": 1580774400,
        "overallIndex": 56,
        "category": "Good",
        "categoryColor": "#FFFF00",
        "hazardStatement": "Some pollutants may slightly affect very few hypersensitive individuals. Only very few hypersensitive people should reduce outdoor activities.",
        "pollutants": [
            {
                "type": "NO2",
                "name": "Nitrogen Dioxide",
                "concentration": {
                    "value": 35,
                    "unit": "ug/m3",
                    "unitType": 31
                },
                "source": "MEP"
            },
            {...}
        ]
    }
}

Past day air quality observation by location key

Code
https://{baseUrl}/airquality/{version}/global/observations/1day/{locationKey}?apikey={your key}

Example

Code
https://api.accuweather.com/airquality/v2/global/observations/1day/101924?apikey={your key}

Code
{
    "success": true,
    "status": "200",
    "version": 2,
    "data": [
        {
            "date": "2020-02-03T02:00:00+08:00",
            "epochDate": 1580695200,
            "overallIndex": 20,
            "category": "Excellent",
            "categoryColor": "#00FF00",
            "hazardStatement": "No health implications. Everyone can continue their outdoor activities normally.",
            "pollutants": [
                {
                    "type": "NO2",
                    "name": "Nitrogen Dioxide",
                    "concentration": {
                        "value": 5,
                        "unit": "ug/m3",
                        "unitType": 31
                    },
                    "source": "MEP"
                },
                {...}
            ]
        },
        {...}
    ]
}

---

Current air quality by location key (standard)

Deprecated — V1 endpoint. New integrations should use the V2 current air quality conditions endpoint. Specialized V1 premium content may be made available under specific business terms.

Code
https://{baseUrl}/airquality/{version}/global/observations/{locationKey}{.format}?apikey={your key}

Example

Code
https://api.accuweather.com/airquality/v1/global/observations/102244.json?apikey={your key}

Code
{
    "Date": "2015-07-07T22:00:00+08:00",
    "EpochDate": 1436306400,
    "Index": 114,
    "ParticulateMatter2_5": 39,
    "ParticulateMatter10": 178,
    "Ozone": 90,
    "CarbonMonoxide": 0.8,
    "NitrogenMonoxide": null,
    "NitrogenDioxide": 14,
    "SulfurMonoxide": null,
    "Lead": null,
    "Source": "MEP"
}

Past day air quality by location key (standard)

Code
https://{baseUrl}/airquality/{version}/global/observations/1day/{locationKey}{.format}?apikey={your key}

Example

Code
https://api.accuweather.com/airquality/v1/global/observations/1day/226081.json?apikey={your key}

Code
[
    {
        "Date": "2016-09-18T22:00:00+09:00",
        "EpochDate": 1474236000,
        "Index": 42,
        "ParticulateMatter2_5": 12,
        "ParticulateMatter10": 20,
        "Ozone": 25,
        "CarbonMonoxide": 0.3,
        "NitrogenMonoxide": null,
        "NitrogenDioxide": 19,
        "SulfurDioxide": 5,
        "Lead": null,
        "Source": "Air Korea"
    },
    {...}
]

Current air quality by location key (premium)

Code
https://{baseUrl}/airquality/{version}/observations/{locationKey}{.format}?apikey={your key}

Example

Code
https://api.accuweather.com/airquality/v1/observations/102244.json?apikey={your key}

Code
{
    "Date": "2015-07-07T22:00:00+08:00",
    "EpochDate": 1436306400,
    "Index": 114,
    "ParticulateMatter2_5": 39,
    "ParticulateMatter10": 178,
    "Ozone": 90,
    "CarbonMonoxide": 0.8,
    "NitrogenMonoxide": null,
    "NitrogenDioxide": 14,
    "SulfurMonoxide": null,
    "Lead": null,
    "Source": "MEP"
}

Past day air quality by location key (premium)

Code
https://{baseUrl}/airquality/{version}/observations/1day/{locationKey}{.format}?apikey={your key}

Example

Code
https://api.accuweather.com/airquality/v1/observations/1day/102244.json?apikey={your key}

Code
[
  {
    "Date": "2015-07-07T22:00:00+08:00",
    "EpochDate": 1436306400,
    "Index": 114,
    "ParticulateMatter2_5": 39,
    "ParticulateMatter10": 178,
    "Ozone": 90,
    "CarbonMonoxide": 0.8,
    "NitrogenMonoxide": null,
    "NitrogenDioxide": 14,
    "SulfurMonoxide": null,
    "Lead": null,
    "Source": "MEP"
  },
  {
    "Date": "2015-07-07T23:00:00+08:00",
    "EpochDate": 1436310000,
    "Index": 114,
    "ParticulateMatter2_5": 39,
    "ParticulateMatter10": 178,
    "Ozone": 90,
    "CarbonMonoxide": 0.8,
    "NitrogenMonoxide": null,
    "NitrogenDioxide": 14,
    "SulfurMonoxide": null,
    "Lead": null,
    "Source": "MEP"
  }
  // ...24 hourly observations omitted
]