Air Pollution - OpenWeatherMap

Air Pollution API concept

Air Pollution API provides current, forecast and historical air pollution data for any coordinates on the globe.

Besides basic Air Quality Index, the API returns data about polluting gases, such as Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO₂), Ozone (O₃), Sulphur dioxide (SO₂), Ammonia (NH₃), and particulates (PM_2.5 and PM₁₀).

Air pollution forecast is available for 4 days with hourly granularity. Historical data is accessible from 27th November 2020.

Here is a description of Air Quality Index levels:

Qualitative name	Index	Pollutant concentration in μg/m³
		SO₂	NO₂	PM₁₀	PM_2.5	O₃	CO
Good	1	0-20	0-40	0-20	0-10	0-60	0-4400
Fair	2	20-80	40-70	20-50	10-25	60-100	4400-9400
Moderate	3	80-250	70-150	50-100	25-50	100-140	9400-12400
Poor	4	250-350	150-200	100-200	50-75	140-180	12400-15400
Very Poor	5	>350	>200	>200	>75	>180	>15400

Other parameters that do not affect the AQI calculation:

NH₃: min value 0.1 - max value 200

NO: min value 0.1 - max value 100

Current air pollution data

API call

http://api.openweathermap.org/data/2.5/air_pollution?lat={lat}&lon={lon}&appid={API key}

Parameters
`lat, lon`	required	Geographical coordinates (latitude, longitude). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API.
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)

Example of API request

http://api.openweathermap.org/data/2.5/air_pollution?lat=50&lon=50&appid={API key}

                
{
  "coord": [
    50.0,
    50.0
  ],
  "list": [
    {
      "dt": 1606147200,
      "main": {
        "aqi": 4.0
      },
      "components": {
        "co": 203.609,
        "no": 0.0,
        "no2": 0.396,
        "o3": 75.102,
        "so2": 0.648,
        "pm2_5": 23.253,
        "pm10": 92.214,
        "nh3": 0.117
      }
    }
  ]
}

Forecast air pollution data

API call

http://api.openweathermap.org/data/2.5/air_pollution/forecast?lat={lat}&lon={lon}&appid={API key}

Parameters
`lat, lon`	required	Geographical coordinates (latitude, longitude). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API.
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)

Example of API request

http://api.openweathermap.org/data/2.5/air_pollution/forecast?lat=50&lon=50&appid={API key}

                
{
  "coord": [
    50.0,
    50.0
  ],
  "list": [
    {
      "dt": 1605916800,
      "main": {
        "aqi": 1.0
      },
      "components": {
        "co": 211.954,
        "no": 0.0,
        "no2": 0.217,
        "o3": 72.956,
        "so2": 0.514,
        "pm2_5": 2.563,
        "pm10": 5.757,
        "nh3": 0.216
      }
    },
    {
      "dt": 1605920400,
      "main": {
        "aqi": 1.0
      },
      "components": {
        "co": 211.954,
        "no": 0.0,
        "no2": 0.201,
        "o3": 72.241,
        "so2": 0.469,
        "pm2_5": 2.662,
        "pm10": 5.622,
        "nh3": 0.224
      }
    },
    {
      "dt": 1605924000,
      "main": {
        "aqi": 1.0
      },
      "components": {
        "co": 213.623,
        "no": 0.0,
        "no2": 0.185,
        "o3": 71.526,
        "so2": 0.443,
        "pm2_5": 2.724,
        "pm10": 5.51,
        "nh3": 0.23
      }
    },
    {
      "dt": 1605927600,
      "main": {
        "aqi": 1.0
      },
      "components": {
        "co": 213.623,
        "no": 0.0,
        "no2": 0.17,
        "o3": 72.241,
        "so2": 0.432,
        "pm2_5": 2.812,
        "pm10": 5.687,
        "nh3": 0.234
      }
    },
    .....

Historical air pollution data

API call

http://api.openweathermap.org/data/2.5/air_pollution/history?lat={lat}&lon={lon}&start={start}&end={end}&appid={API key}

Parameters
`lat, lon`	required	Geographical coordinates (latitude, longitude). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API.
`start`	required	Start date (unix time, UTC time zone), e.g. start=1606488670
`end`	required	End date (unix time, UTC time zone), e.g. end=1606747870
`appid`	required	Your unique API key (you can always find it on your account page under the "API key" tab)

Example of API request

http://api.openweathermap.org/data/2.5/air_pollution/history?lat=508&lon=50&start=1606223802&end=1606482999&appid={API key}

                
{
  "coord": [
    50.0,
    50.0
  ],
  "list": [
    {
      "main": {
        "aqi": 2
      },
      "components": {
        "co": 270.367,
        "no": 5.867,
        "no2": 43.184,
        "o3": 4.783,
        "so2": 14.544,
        "pm2_5": 13.448,
        "pm10": 15.524,
        "nh3": 0.289
      },
      "dt": 1606482000
    },
    {
      "main": {
        "aqi": 2
      },
      "components": {
        "co": 280.38,
        "no": 8.605,
        "no2": 42.155,
        "o3": 2.459,
        "so2": 14.901,
        "pm2_5": 15.103,
        "pm10": 17.249,
        "nh3": 0.162
      },
      "dt": 1606478400
    },
    {
      "main": {
        "aqi": 2
      },
      "components": {
        "co": 293.732,
        "no": 13.523,
        "no2": 41.47,
        "o3": 1.173,
        "so2": 15.14,
        "pm2_5": 17.727,
        "pm10": 19.929,
        "nh3": 0.072
      },
      "dt": 1606474800
    },
    .....

Air Pollution API response

Example of the API response

                   
{
  "coord":[
    50,
    50
  ],
  "list":[
    {
      "dt":1605182400,
      "main":{
        "aqi":1
      },
      "components":{
        "co":201.94053649902344,
        "no":0.01877197064459324,
        "no2":0.7711350917816162,
        "o3":68.66455078125,
        "so2":0.6407499313354492,
        "pm2_5":0.5,
        "pm10":0.540438711643219,
        "nh3":0.12369127571582794
      }
    }
  ]
}

Fields in API response

coord Coordinates from the specified location (latitude, longitude)
list

dt Date and time, Unix, UTC
main

main.aqi Air Quality Index. Possible values: 1, 2, 3, 4, 5. Where 1 = Good, 2 = Fair, 3 = Moderate, 4 = Poor, 5 = Very Poor.

components

components.co Сoncentration of CO (Carbon monoxide), μg/m³
components.no Сoncentration of NO (Nitrogen monoxide), μg/m³
components.no2 Сoncentration of NO₂ (Nitrogen dioxide), μg/m³
components.o3 Сoncentration of O₃ (Ozone), μg/m³
components.so2 Сoncentration of SO₂ (Sulphur dioxide), μg/m³
components.pm2_5 Сoncentration of PM_2.5 (Fine particles matter), μg/m³
components.pm10 Сoncentration of PM₁₀ (Coarse particulate matter), μg/m³
components.nh3 Сoncentration of NH₃ (Ammonia), μg/m³