Air Quality Forecast

The Air Quality Forecast API returns a 3 day / hourly forecasted air quality conditions for any location in the world. It returns 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.

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

Base URL

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

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.
callback=[function] (optional: JSON-P callback)
hours=[integer] (optional: return a specific number of forecast hours)
  • 0-72 hours - [DEFAULT] 72 hours

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/forecast/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":[  
                {  
                   "timestamp_utc":"2019-03-04T17:00:00",
                   "timestamp_local":"2019-03-04T12:00:00",
                   "ts":1551718800,
                   "aqi":4,
                   "o3":57.3993,
                   "so2":3.8594,
                   "no2":5.42472,
                   "pm10":2.1667,
                   "pm25":0.927972,
                   "co":383.437 
                }, ... 
             ]
          }
        

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: [
    • timestamp_local: Timestamp at local time.
    • timestamp_utc: Timestamp at UTC time.
    • ts: Unix Timestamp at UTC time.
    • 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³)
  • ... ]