Current Air Quality
This 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).
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/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 data by lat/lon | lat,lon | &lat=38.123&lon=-78.543 |
| Get data by city name | city, state(optional), country (optional) |
|
| Get data by postal code | postal_code, country (optional) | &postal_code=27601&country=US |
| Get data 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_KEYExample 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)... ]