Air Quality API (Current)

This Air Quality API returns current air quality conditions for any location in the world. It returns air quality data on the 6 major surface pollutants - PM 2.5, PM 10, CO, SO2, NO2, and O3. Additionally, this API returns an air quality index score (AQI) as well as pollen levels (USA and EU only).

All parameters should be supplied to the Air Quality API as query string parameters.

Base URL

HTTP: http://api.weatherbit.io/v2.0/current/airquality
HTTPS: https://api.weatherbit.io/v2.0/current/airquality
Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.

API Endpoints

Description Required Parameters Example(s)
Get forecast by lat/lon lat,lon &lat=38.123&lon=-78.543
Get forecast by city name city, state(optional), country (optional)
  • &city=Raleigh&country=US
  • &city=Raleigh,NC
  • &city=Raleigh,North+Carolina
Get forecast by postal code postal_code, country (optional) &postal_code=27601&country=US
Get forecast by city id city_id &city_id=8953360

Example Request:

https://api.weatherbit.io/v2.0/current/airquality?lat=35.7721&lon=-78.63861&key=API_KEY

Example Response (JSON):


          {  
             "lat":35.7721,
             "lon":-78.63861,
             "timezone":"America\/New_York",
             "city_name":"Raleigh",
             "country_code":"US",
             "state_code":"NC",
             "data":[  
                {  
                   "aqi":47,
                   "o3":101.2,
                   "so2":3.8594,
                   "no2":5.42472,
                   "co":251.9,
                   "pm10":16,
                   "pm25":11,
                   "pollen_level_tree": 4,
                   "pollen_level_grass": 2,
                   "pollen_level_weed": 2,
                   "mold_level": 0,
                   "predominant_pollen_type": "Trees"
                }
             ]
          }
        

Field Decriptions:

  • lat: Latitude (Degrees).
  • lon: Longitude (Degrees).
  • timezone: Local IANA Timezone.
  • city_name: City name.
  • country_code: Country abbreviation.
  • state_code: State abbreviation/code.
  • data: [
    • aqi: Air Quality Index [US - EPA standard 0 - +500]
    • o3: Concentration of surface O3 (µg/m³)
    • so2: Concentration of surface SO2 (µg/m³)
    • no2: Concentration of surface NO2 (µg/m³)
    • co: Concentration of carbon monoxide (µg/m³)
    • pm25: Concentration of particulate matter < 2.5 microns (µg/m³)
    • pm10: Concentration of particulate matter < 10 microns (µg/m³)
    • pollen_level_tree: Tree pollen level (0 = None, 1 = Low, 2 = Moderate, 3 = High, 4 = Very High)
    • pollen_level_grass:Grass pollen level (0 = None, 1 = Low, 2 = Moderate, 3 = High, 4 = Very High)
    • pollen_level_weed:Weed pollen level (0 = None, 1 = Low, 2 = Moderate, 3 = High, 4 = Very High)
    • mold_level: Mold level (0 = None, 1 = Low, 2 = Moderate, 3 = High, 4 = Very High)
    • predominant_pollen_type: Predominant pollen type (Trees/Weeds/Molds/Grasses)
  • ... ]