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).

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.
callback=[function] (optional: JSON-P callback)

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=38.0&lon=-78.0&key=API_KEY

Example Response (JSON):


          {  
             "lat":38,
             "lon":-78,
             "timezone":"America\/New_York",
             "city_name":"Louisa",
             "country_code":"US",
             "state_code":"VA",
             "data":[  
                {  
                   "aqi":4,
                   "o3":57.3993,
                   "so2":3.8594,
                   "no2":5.42472,
                   "co":383.437,
                   "pm10":2.1667,
                   "pm25":0.927972
                }
             ]
          }
        

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³)
  • ... ]