Current Air Quality API
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).
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_KEY
Example 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)... ]