Air Quality Programmatic APIs website screenshot

Air Quality Programmatic APIs

Air Quality Programmatic APIs provide real-time and forecast air quality data from 11,000+ monitoring stations in 1,000+ cities worldwide. APIs deliver Air Quality Index (AQI) measurements for PM2.5, PM10, NO2, CO, SO2, and ozone pollutants. Provided by AQICN (World Air Quality Index project) in partnership with the US EPA and global environmental agencies. Data is available via JSON API and map tile API for visualization.

2 APIs 8 Features
Air QualityEnvironmentEPAOpen DataPublic HealthIoTGovernment DataReal-Time Data

APIs

AQICN Real-Time Air Quality API

Real-time and forecast air quality data from 11,000+ monitoring stations globally. Returns AQI measurements for PM2.5, PM10, NO2, CO, SO2, and ozone pollutants by city, station,...

AQICN JSON Air Quality API

JSON API returning real-time AQI station data by city name, station name, geographic coordinates, or IP geolocation. Includes pollutant breakdowns (PM2.5, PM10, NO2, CO, SO2, O3...

Collections

Pricing Plans

Rate Limits

FinOps

Features

Real-Time AQI Data

Live air quality index readings from 11,000+ monitoring stations updated continuously.

Global Coverage

Data from 1,000+ cities worldwide including US EPA, China MEP, Europe EEA, and other monitoring networks.

Multi-Pollutant Data

Pollutant-specific AQI for PM2.5, PM10, nitrogen dioxide, carbon monoxide, sulfur dioxide, and ozone.

Air Quality Forecasts

3-8 day air quality forecasts for major monitoring stations.

Geolocation Queries

Find nearest stations by latitude/longitude, city name, or IP-based geolocation.

Map Tile API

Raster map tiles for overlaying real-time AQI data on web maps (Leaflet, Google Maps, etc.).

Station Search

Search and discover monitoring stations by name or location within a geographic boundary.

Weather Data

Current weather conditions co-located with air quality measurements.

Use Cases

Air Quality Mobile Apps

Build apps that show users real-time air quality for their location with health recommendations.

Environmental Monitoring Dashboards

Create web dashboards visualizing air quality trends across cities and regions.

Public Health Research

Access historical and real-time air quality data for epidemiological and public health research.

Smart City Integration

Integrate air quality data into smart city platforms and IoT systems for environmental management.

Outdoor Activity Planning

Provide air quality-based recommendations for outdoor activities in fitness and weather apps.

Semantic Vocabularies

Aqicn Context

11 classes · 24 properties

JSON-LD

API Governance Rules

Air Quality Programmatic APIs API Rules

10 rules · 5 errors 5 warnings

SPECTRAL

JSON Structure

Aqicn Aqi Station Structure

2 properties

JSON STRUCTURE

Aqicn Attribution Structure

2 properties

JSON STRUCTURE

Aqicn City Info Structure

3 properties

JSON STRUCTURE

Aqicn Forecast Data Structure

1 properties

JSON STRUCTURE

Aqicn Forecast Day Structure

4 properties

JSON STRUCTURE

Aqicn Pollutant Data Structure

6 properties

JSON STRUCTURE

Aqicn Station Data Structure

7 properties

JSON STRUCTURE

Aqicn Station Search Result Structure

2 properties

JSON STRUCTURE

Aqicn Time Info Structure

3 properties

JSON STRUCTURE

Example Payloads

Aqicn Aqi Station Example

2 fields

EXAMPLE

Aqicn Attribution Example

2 fields

EXAMPLE

Aqicn City Info Example

3 fields

EXAMPLE

Aqicn Forecast Data Example

1 fields

EXAMPLE

Aqicn Forecast Day Example

4 fields

EXAMPLE

Aqicn Pollutant Data Example

4 fields

EXAMPLE

Aqicn Station Data Example

4 fields

EXAMPLE

Aqicn Time Info Example

3 fields

EXAMPLE

Resources

👥
GitHubOrganization
GitHubOrganization
💬
FAQ
FAQ
🔑
Authentication
Authentication
🌐
Portal
Portal
🌐
Portal
Portal
📜
TermsOfService
TermsOfService
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Air Quality Programmatic APIs Real-time Air Quality Tile API
  version: 1.0.0
items:
- info:
    name: Air Quality Programmatic APIs Get Air Quality Tile
    type: http
  http:
    method: GET
    url: https://tiles.aqicn.org/tiles/:aqi/:z/:x/:y.png
    params:
    - name: aqi
      value: ''
      type: path
      description: Type of air quality marker to display
    - name: z
      value: ''
      type: path
      description: Zoom level of the tile
    - name: x
      value: ''
      type: path
      description: X coordinate of the tile
    - name: y
      value: ''
      type: path
      description: Y coordinate of the tile
    - name: token
      value: ''
      type: query
      description: API token for authentication
    auth:
      type: apikey
      key: token
      value: '{{token}}'
      placement: query
  docs: Retrieves a tile image representing air quality data for a specific location and zoom level.
bundled: true