Air Quality Forecasts

This Air Quality API returns a 3 day / hourly forecast of air quality conditionas 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 API as query string parameters.

Base URL

Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.
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 (Recommended) 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:

Example Response (JSON):

                }, ... 

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