Version 2

Current conditions/forecast endpoints

Observational endpoints (raw data)

Version 1 (deprecated)

Current conditions/forecast endpoints

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.

https://{{api} or {apidev}}.accuweather.com/airquality/{version}/currentconditions/{locationKey}?apikey={your key}&pollutants={boolean}&language={language}

Examples

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

{ "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" } }

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

{ "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": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "O3", "name": "Ozone", "index": 32.9, "plumeLabsIndex": 13.2, "concentration": { "value": 32.9, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "PM10", "name": "Particulate Matter 10", "index": 90.7, "plumeLabsIndex": 106.7, "concentration": { "value": 90.7, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, {... } ] } }

Top of page

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.

https://{{api} or {apidev}}.accuweather.com/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.

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

{ "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" }, { "date": "2022-07-01T20:00:00+05:30", "epochDate": 1656685800, "overallIndex": 49.1, "overallPlumeLabsIndex": 19.6, "dominantPollutant": "Ozone", "category": "Excellent", "categoryColor": "#00E39B", "hazardStatement": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.", "link": "https://www.accuweather.com/en/in/shyamapur/3182693/air-quality-index/3182693?lang=en-us" }, { "date": "2022-07-01T21:00:00+05:30", "epochDate": 1656689400, "overallIndex": 43.6, "overallPlumeLabsIndex": 19.7, "dominantPollutant": "Particulate Matter 10", "category": "Excellent", "categoryColor": "#00E39B", "hazardStatement": "The air quality is ideal for most individuals; enjoy your normal outdoor activities.", "link": "https://www.accuweather.com/en/in/shyamapur/3182693/air-quality-index/3182693?lang=en-us" }, {... } ] }

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

{ "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": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "O3", "name": "Ozone", "index": 32, "plumeLabsIndex": 13, "concentration": { "value": 33, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "PM10", "name": "Particulate Matter 10", "index": 89, "plumeLabsIndex": 110, "concentration": { "value": 90, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, {... } ] }, { "date": "2020-02-03T22:00:00+05:30", "epochDate": 1580767200, "overallIndex": 240, "overallPlumeLabsIndex": 170, "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": 49, "plumeLabsIndex": 20, "concentration": { "value": 40, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "O3", "name": "Ozone", "index": 33, "plumeLabsIndex": 13, "concentration": { "value": 33, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "PM10", "name": "Particulate Matter 10", "index": 89, "plumeLabsIndex": 110, "concentration": { "value": 89, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, {... } ] }, { "date": "2020-02-03T23:00:00+05:30", "epochDate": 1580770800, "overallIndex": 230, "overallPlumeLabsIndex": 150, "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": 44, "plumeLabsIndex": 18, "concentration": { "value": 36, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "O3", "name": "Ozone", "index": 33, "plumeLabsIndex": 13, "concentration": { "value": 33, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, { "type": "PM10", "name": "Particulate Matter 10", "index": 86, "plumeLabsIndex": 100, "concentration": { "value": 86, "unit": "µg/m³", "unitType": 31 }, "source": "Plume Labs" }, {... } ] }, {... } ] }

Top of page

Daily air quality forecasts by location key

Note: this endpoint supports all AccuWeather locations.

https://{{api} or {{apidev}}.accuweather.com/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.

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

{ "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 }, { "date": "2020-02-04T05:00:00+05:30", "epochDate": 1580792400, "overallIndex": 274.4, "overallPlumeLabsIndex": 214.2, "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 }, { "date": "2020-02-05T05:00:00+05:30", "epochDate": 1580878800, "overallIndex": 286.7, "overallPlumeLabsIndex": 166, "dominantPollutant": "Particulate Matter 2.5", "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 } ] }

Top of page

Observational endpoints

Note: these endpoints return the same data as V1, except formatted for V2. These endpoints support China and South Korea only.

Current air quality observation by location key

https://{{api} or {{apidev}}.accuweather.com/airquality/{version}/observations/{locationKey}{.{format}}?apikey={your key}

Example

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

{ "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": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "O3", "name": "Ozone", "concentration": { "value": 29, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "PM10", "name": "Particulate Matter 10", "concentration": { "value": 52, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, {... } ] } }

Top of page

Past day air quality observation by location key

https://{{api} or {{apidev}}.accuweather.com/airquality/{version}/observations/1day/{locationKey}{.{format}}?apikey={your key}

Example

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

{ "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": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "O3", "name": "Ozone", "concentration": { "value": 65, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "PM10", "name": "Particulate Matter 10", "concentration": { "value": 10, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, {... } ] }, { "date": "2020-02-03T03:00:00+08:00", "epochDate": 1580698800, "overallIndex": 19, "category": "Excellent", "categoryColor": "#00FF00", "hazardStatement": "No health implications. Everyone can continue their outdoor activities normally.", "pollutants": [ { "type": "NO2", "name": "Nitrogen Dioxide", "concentration": { "value": 6, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "O3", "name": "Ozone", "concentration": { "value": 62, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "PM10", "name": "Particulate Matter 10", "concentration": { "value": 9, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, {... } ] }, { "date": "2020-02-03T04:00:00+08:00", "epochDate": 1580702400, "overallIndex": 19, "category": "Excellent", "categoryColor": "#00FF00", "hazardStatement": "No health implications. Everyone can continue their outdoor activities normally.", "pollutants": [ { "type": "NO2", "name": "Nitrogen Dioxide", "concentration": { "value": 7, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "O3", "name": "Ozone", "concentration": { "value": 61, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, { "type": "PM10", "name": "Particulate Matter 10", "concentration": { "value": 7, "unit": "µg/m³", "unitType": 31 }, "source": "MEP" }, {... } ] }, {... } ] }

Top of page

Version 1 (deprecated)

As applicable, additional specialized air quality content can be made available though the premium air quality endpoints, under specific business terms.

Current air quality by location key (standard)

https://{{api} or {{apidev}}.accuweather.com/airquality/{version}/global/observations/{locationKey}{.{format}}?apikey={your key}

Example

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

{ 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 }

Top of section

Top of page

Past day air quality by location key (standard)

https://{{api} or {{apidev}}.accuweather.com/airquality/{version}/global/observations/1day/{locationKey}{.{format}}?apikey={your key}

Example

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

[ { 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" }, { Date: "2016-09-18T23:00:00+09:00", EpochDate: 1474239600, Index: 40, ParticulateMatter2_5: 10, ParticulateMatter10: 19, Ozone: 22, CarbonMonoxide: 0.3, NitrogenMonoxide: null, NitrogenDioxide: 20, SulfurDioxide: 5, Lead: null, Source: "Air Korea" }, { Date: "2016-09-19T00:00:00+09:00", EpochDate: 1474243200, Index: 45, ParticulateMatter2_5: 10, ParticulateMatter10: 20, Ozone: 27, CarbonMonoxide: 0.3, NitrogenMonoxide: null, NitrogenDioxide: 15, SulfurDioxide: 5, Lead: null, Source: "Air Korea" }, { Date: "2016-09-19T01:00:00+09:00", EpochDate: 1474246800, Index: 53, ParticulateMatter2_5: 9, ParticulateMatter10: 18, Ozone: 33, CarbonMonoxide: 0.2, NitrogenMonoxide: null, NitrogenDioxide: 10, SulfurDioxide: 5, Lead: null, Source: "Air Korea" }, { Date: "2016-09-19T02:00:00+09:00", EpochDate: 1474250400, Index: 54, ParticulateMatter2_5: 9, ParticulateMatter10: 20, Ozone: 35, CarbonMonoxide: 0.2, NitrogenMonoxide: null, NitrogenDioxide: 8, SulfurDioxide: 5, Lead: null, Source: "Air Korea" }, { Date: "2016-09-19T03:00:00+09:00", EpochDate: 1474254000, Index: 56, ParticulateMatter2_5: 9, ParticulateMatter10: 15, Ozone: 37, CarbonMonoxide: 0.2, NitrogenMonoxide: null, NitrogenDioxide: 6, SulfurDioxide: 5, Lead: null, Source: "Air Korea" }, { Date: "2016-09-19T04:00:00+09:00", EpochDate: 1474257600, Index: 56, ParticulateMatter2_5: 7, ParticulateMatter10: 14, Ozone: 37, CarbonMonoxide: 0.2, NitrogenMonoxide: null, NitrogenDioxide: 6, SulfurDioxide: 5, Lead: null, Source: "Air Korea" }... ]

Top of section

Top of page

Current air quality by location key (premium)

https://{{api} or {{apidev}}.accuweather.com/airquality/{version}/observations/{locationKey}{.{format}}?apikey={your key}

Example

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

{ 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 }

Top of section

Top of page

Past day air quality by location key (premium)

https://{{api} or {{apidev}}.accuweather.com/airquality/{version}/observations/1day/{locationKey}{.{format}}?apikey={your key}

Example

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

[ { 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 }, { Date: "2015-07-08T00:00:00+08:00", EpochDate: 1436313600, 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-08T01:00:00+08:00", EpochDate: 1436317200, 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-08T02:00:00+08:00", EpochDate: 1436320800, 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-08T03:00:00+08:00", EpochDate: 1436324400, 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-08T04:00:00+08:00", EpochDate: 1436328000, 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-08T05:00:00+08:00", EpochDate: 1436331600, Index: 114, ParticulateMatter2_5: 39, ParticulateMatter10: 178, Ozone: 90, CarbonMonoxide: 0.8, NitrogenMonoxide: null, NitrogenDioxide: 14, SulfurMonoxide: null, Lead: null Source: MEP }... ]

Top of section

Top of page