International Air Quality API Guide

Version 2

Types of searches:

Current conditions/forecast endpoints

Observational endpoints (raw data)

 

 

 

 

Current conditions/forecast endpoints

 

 

 

Current air quality conditions by location key

Note: this endpoint supports all AccuWeather locations. The pollutants parameter is only available for premium users.

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

 

Example:

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

Top of page

 

 

 

Hourly air quality forecasts by location key

Note: this endpoint supports all AccuWeather locations. The pollutants parameter is only available for premium users.

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

 

Example:

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}&pollutants=true&language=en-us

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, and 4 days.

https://api.accuweather.com/airquality/v2/forecasts/daily/3day/201655?apikey={your key}&language=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}

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}

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. 

 

 

Types of Searches:

 

 

 

 

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}

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}

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}

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}

Top of section

Top of page