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).
This API is available to the following plans (See: pricing):
- Business plan
- Enterprise plan
All parameters should be supplied to the 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.
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) |
|
| 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_KEYExample 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³)... ]