Air Quality API
Real-time air quality index and pollutant concentrations for any location worldwide.
Query current PM2.5, PM10, carbon monoxide (CO), nitrogen dioxide (NO₂), sulphur dioxide (SO₂), and ozone (O₃) readings alongside the US EPA Air Quality Index (1–6 categories) and UK DEFRA index. Data is sourced from ground-monitoring networks and satellite-derived estimates, making coverage genuinely global — including areas with sparse station infrastructure.
What You Get with the Air Quality API
PM2.5 & PM10 concentrations
The two most health-relevant particulate measures, expressed in μg/m³ for direct comparison with WHO guidelines.
US EPA & UK DEFRA indices
Standardised air quality indices so your UI can show meaningful categories (Good, Moderate, Unhealthy) instantly.
Six key pollutants
CO, NO₂, SO₂, O₃, PM2.5, and PM10 — everything needed for a comprehensive air quality display.
Global station & satellite blend
Coverage even where ground stations are sparse, using satellite-derived aerosol optical depth to fill gaps.
Bundled with weather
Add aqi=yes to any Current Weather or Forecast request to include air quality without an extra API call.
No extra cost
Air quality data is part of the Standard tier — included in your 1,000 free daily calls.
Who Uses This API
From startups to enterprise teams, the Air Quality API powers a wide range of real-world applications.
Fitness & outdoor activity apps
Warn runners, cyclists, and parents whether it's safe to exercise or let children play outdoors based on real PM2.5 levels.
Smart home & HVAC systems
Trigger ventilation, air purifiers, or window closure based on outdoor AQI crossing a threshold.
Urban planning & public health
Monitor air quality patterns across a city to identify hotspots and support evidence-based policy decisions.
Travel & tourism platforms
Display destination air quality to health-conscious travellers and those with respiratory conditions.
Request Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| q | string | Required | Location — city, lat/lon, postcode, or IP | Beijing |
Authenticate every request with the X-API-Key header.
Code Example
Request
curl "https://api.weatherai.io/v1/airquality?q=Beijing" \
-H "X-API-Key: your-api-key"Response
{
"location": { "name": "Beijing", "country": "China" },
"airQuality": {
"co": 233.5,
"no2": 18.2,
"o3": 52.1,
"so2": 6.3,
"pm2_5": 38.7,
"pm10": 51.2,
"usEpaIndex": 2,
"gbDefraIndex": 3
}
}Response Fields
| Field | Type | Description |
|---|---|---|
| location | object | Location details (name, country, coordinates) |
| airQuality.co | number | Carbon monoxide (μg/m³) |
| airQuality.no2 | number | Nitrogen dioxide (μg/m³) |
| airQuality.o3 | number | Ozone (μg/m³) |
| airQuality.so2 | number | Sulphur dioxide (μg/m³) |
| airQuality.pm2_5 | number | Fine particulate matter (μg/m³) |
| airQuality.pm10 | number | Coarse particulate matter (μg/m³) |
| airQuality.usEpaIndex | integer | US EPA AQI category (1 = Good … 6 = Hazardous) |
| airQuality.gbDefraIndex | integer | UK DEFRA air quality band (1–10) |
Related APIs
Start Using the Air Quality API Today
Create a free account and get your API key in under a minute. 1,000 free calls per day. No credit card required.
Get Your Free API Key