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.

Air Quality Programmatic APIs publishes 6 APIs on the APIs.io network, including Air Quality Programmatic APIs Real Time Air Quality Tile API API, Cities API, Geolocation API, and 3 more. Tagged areas include Air Quality, Environment, EPA, Open Data, and Public Health.

The Air Quality Programmatic APIs catalog on APIs.io includes 1 JSON-LD context and 3 Spectral governance rulesets.

Air Quality Programmatic APIs’ developer surface includes authentication, FAQ, developer portal, and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub
48.1/100 developing ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
6 APIs 8 Features 5 Use Cases
Air QualityEnvironmentEPAOpen DataPublic HealthIoTGovernment DataReal-Time Data

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 48.1/100 · developing
Contract Quality 16.3 / 25
Developer Ergonomics 3.9 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 37/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/air-quality-programmatic-apis: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Air Quality Programmatic APIs Air Quality Programmatic APIs Real Time Air Quality Tile API API

The Air Quality Programmatic APIs Real Time Air Quality Tile API API from Air Quality Programmatic APIs — 1 operation(s) for air quality programmatic apis real time air quality ...

Air Quality Programmatic APIs Cities API

The Cities API from Air Quality Programmatic APIs — 1 operation(s) for cities.

Air Quality Programmatic APIs Geolocation API

The Geolocation API from Air Quality Programmatic APIs — 2 operation(s) for geolocation.

Air Quality Programmatic APIs Map API

The Map API from Air Quality Programmatic APIs — 1 operation(s) for map.

Air Quality Programmatic APIs Search API

The Search API from Air Quality Programmatic APIs — 1 operation(s) for search.

Air Quality Programmatic APIs Stations API

The Stations API from Air Quality Programmatic APIs — 5 operation(s) for stations.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Air Quality Programmatic APIs Real-time Air Quality Tile API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Air Quality Programmatic Apis Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Air Quality Programmatic Apis Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Air Quality Programmatic Apis Finops

FINOPS

Features 8

Notable capabilities this provider offers.

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.

Scroll for all 8

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Aqicn Context

11 classes · 24 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

Air Quality Programmatic APIs API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Air Quality Programmatic APIs API Rules

9 rules · 1 errors 8 warnings

SPECTRAL

Air Quality Programmatic APIs API Rules

10 rules · 5 errors 5 warnings

SPECTRAL

JSON Schema 9

Standalone JSON Schema definitions for this provider's data models.

AQIStation

2 properties

JSON SCHEMA

Attribution

2 properties

JSON SCHEMA

CityInfo

3 properties

JSON SCHEMA

ForecastData

1 properties

JSON SCHEMA

ForecastDay

4 properties

JSON SCHEMA

PollutantData

6 properties

JSON SCHEMA

StationData

7 properties

JSON SCHEMA

StationSearchResult

2 properties

JSON SCHEMA

TimeInfo

3 properties

JSON SCHEMA

Scroll for all 9

JSON Structure 9

JSON Structure definitions describing this provider's data shapes.

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

Scroll for all 9

Examples 9

Example request and response payloads for these APIs.

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 Station Search Result Example

2 fields

EXAMPLE

Aqicn Time Info Example

3 fields

EXAMPLE

Scroll for all 9

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Air Quality Programmatic Apis Authentication

apiKey · 1 scheme

SECURITY

Air Quality Programmatic Apis Domain Security

TLSv1.2 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Air Quality Programmatic Apis Agentic Access

6 operations

6 operations · 0 acting

AGENTIC

Use Cases 5

What developers build with this provider.

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.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal
Portal
 Portal
Portal

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

SpectralRules
SpectralRules
 Vocabulary
Vocabulary

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 Authentication
Authentication

Operate 1

Status, limits, changes, and where to get help

FAQ
FAQ

Commercial 1

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService

Source (apis.yml)

apis.yml Raw ↑ 
aid: air-quality-programmatic-apis
url: https://raw.githubusercontent.com/api-search/air-quality-programmatic-apis/refs/heads/main/apis.yml
apis:
- aid: air-quality-programmatic-apis:air-quality-programmatic-apis-air-quality-programmatic-apis-real-time-air-quality-tile-api-api
  name: Air Quality Programmatic APIs Air Quality Programmatic APIs Real Time Air Quality Tile API API
  description: The Air Quality Programmatic APIs Real Time Air Quality Tile API API from Air Quality Programmatic APIs — 1
    operation(s) for air quality programmatic apis real time air quality tile api.
  humanURL: https://aqicn.org/api/
  tags:
  - Air Quality Programmatic APIs Real Time Air Quality Tile API
  properties:
  - type: OpenAPI
    url: openapi/air-quality-programmatic-apis-air-quality-programmatic-apis-real-time-air-quality-tile-api-api-openapi.yml
  - type: Documentation
    url: https://aqicn.org/api/
  - type: APIReference
    url: https://aqicn.org/json-api/doc/
  - type: Authentication
    url: https://aqicn.org/data-platform/token/
  - type: Documentation
    url: https://aqicn.org/json-api/doc/
- aid: air-quality-programmatic-apis:air-quality-programmatic-apis-cities-api
  name: Air Quality Programmatic APIs Cities API
  description: The Cities API from Air Quality Programmatic APIs — 1 operation(s) for cities.
  humanURL: https://aqicn.org/api/
  tags:
  - Cities
  properties:
  - type: OpenAPI
    url: openapi/air-quality-programmatic-apis-cities-api-openapi.yml
  - type: Documentation
    url: https://aqicn.org/api/
  - type: APIReference
    url: https://aqicn.org/json-api/doc/
  - type: Authentication
    url: https://aqicn.org/data-platform/token/
  - type: Documentation
    url: https://aqicn.org/json-api/doc/
- aid: air-quality-programmatic-apis:air-quality-programmatic-apis-geolocation-api
  name: Air Quality Programmatic APIs Geolocation API
  description: The Geolocation API from Air Quality Programmatic APIs — 2 operation(s) for geolocation.
  humanURL: https://aqicn.org/api/
  tags:
  - Geolocation
  properties:
  - type: OpenAPI
    url: openapi/air-quality-programmatic-apis-geolocation-api-openapi.yml
  - type: Documentation
    url: https://aqicn.org/api/
  - type: APIReference
    url: https://aqicn.org/json-api/doc/
  - type: Authentication
    url: https://aqicn.org/data-platform/token/
  - type: Documentation
    url: https://aqicn.org/json-api/doc/
- aid: air-quality-programmatic-apis:air-quality-programmatic-apis-map-api
  name: Air Quality Programmatic APIs Map API
  description: The Map API from Air Quality Programmatic APIs — 1 operation(s) for map.
  humanURL: https://aqicn.org/api/
  tags:
  - Map
  properties:
  - type: OpenAPI
    url: openapi/air-quality-programmatic-apis-map-api-openapi.yml
  - type: Documentation
    url: https://aqicn.org/api/
  - type: APIReference
    url: https://aqicn.org/json-api/doc/
  - type: Authentication
    url: https://aqicn.org/data-platform/token/
  - type: Documentation
    url: https://aqicn.org/json-api/doc/
- aid: air-quality-programmatic-apis:air-quality-programmatic-apis-search-api
  name: Air Quality Programmatic APIs Search API
  description: The Search API from Air Quality Programmatic APIs — 1 operation(s) for search.
  humanURL: https://aqicn.org/api/
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/air-quality-programmatic-apis-search-api-openapi.yml
  - type: Documentation
    url: https://aqicn.org/api/
  - type: APIReference
    url: https://aqicn.org/json-api/doc/
  - type: Authentication
    url: https://aqicn.org/data-platform/token/
  - type: Documentation
    url: https://aqicn.org/json-api/doc/
- aid: air-quality-programmatic-apis:air-quality-programmatic-apis-stations-api
  name: Air Quality Programmatic APIs Stations API
  description: The Stations API from Air Quality Programmatic APIs — 5 operation(s) for stations.
  humanURL: https://aqicn.org/api/
  tags:
  - Stations
  properties:
  - type: OpenAPI
    url: openapi/air-quality-programmatic-apis-stations-api-openapi.yml
  - type: Documentation
    url: https://aqicn.org/api/
  - type: APIReference
    url: https://aqicn.org/json-api/doc/
  - type: Authentication
    url: https://aqicn.org/data-platform/token/
  - type: Documentation
    url: https://aqicn.org/json-api/doc/
name: Air Quality Programmatic APIs
tags:
- Air Quality
- Environment
- EPA
- Open Data
- Public Health
- IoT
- Government Data
- Real-Time Data
kind: contract
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/air-quality-programmatic-apis.png
access: 3rd-Party
common:
- type: AgenticAccess
  url: agentic-access/air-quality-programmatic-apis-agentic-access.yml
- type: DomainSecurity
  url: security/air-quality-programmatic-apis-domain-security.yml
- type: Authentication
  url: authentication/air-quality-programmatic-apis-authentication.yml
- type: GitHubOrganization
  url: https://github.com/USEPA
- name: AQICN FAQ
  url: https://aqicn.org/faq/
  type: FAQ
  description: Frequently asked questions about AQICN air quality data and APIs.
- name: AQICN API Token
  url: https://aqicn.org/data-platform/token/
  type: Authentication
  description: Request an API access token for AQICN programmatic APIs.
- name: AQICN Map
  url: https://aqicn.org/map/
  type: Portal
  description: World air quality index map powered by the AQICN API.
- name: AQICN Data Platform
  url: https://aqicn.org/data-platform/
  type: Portal
  description: AQICN data platform for historical downloads and enterprise access.
- name: AQICN Terms of Use
  url: https://aqicn.org/api/tos/
  type: TermsOfService
  description: Terms of service for AQICN API usage (non-commercial free use).
- type: Features
  data:
  - name: Real-Time AQI Data
    description: Live air quality index readings from 11,000+ monitoring stations updated continuously.
  - name: Global Coverage
    description: Data from 1,000+ cities worldwide including US EPA, China MEP, Europe EEA, and other monitoring networks.
  - name: Multi-Pollutant Data
    description: Pollutant-specific AQI for PM2.5, PM10, nitrogen dioxide, carbon monoxide, sulfur dioxide, and ozone.
  - name: Air Quality Forecasts
    description: 3-8 day air quality forecasts for major monitoring stations.
  - name: Geolocation Queries
    description: Find nearest stations by latitude/longitude, city name, or IP-based geolocation.
  - name: Map Tile API
    description: Raster map tiles for overlaying real-time AQI data on web maps (Leaflet, Google Maps, etc.).
  - name: Station Search
    description: Search and discover monitoring stations by name or location within a geographic boundary.
  - name: Weather Data
    description: Current weather conditions co-located with air quality measurements.
- type: UseCases
  data:
  - name: Air Quality Mobile Apps
    description: Build apps that show users real-time air quality for their location with health recommendations.
  - name: Environmental Monitoring Dashboards
    description: Create web dashboards visualizing air quality trends across cities and regions.
  - name: Public Health Research
    description: Access historical and real-time air quality data for epidemiological and public health research.
  - name: Smart City Integration
    description: Integrate air quality data into smart city platforms and IoT systems for environmental management.
  - name: Outdoor Activity Planning
    description: Provide air quality-based recommendations for outdoor activities in fitness and weather apps.
- type: Integrations
  data:
  - name: Leaflet Maps
    description: Integrate AQI map tiles with Leaflet.js for interactive air quality maps.
  - name: Google Maps
    description: Overlay AQI data on Google Maps using the tile API.
  - name: US EPA AirNow
    description: Data aggregated from US EPA AirNow monitoring network.
  - name: OpenAQ
    description: Complementary open air quality data platform with API access.
- name: AQICN Spectral Rules
  url: rules/aqicn-spectral-rules.yml
  type: SpectralRules
  description: Spectral rules for AQICN API conventions.
- name: AQICN Vocabulary
  url: vocabulary/aqicn-vocabulary.yaml
  type: Vocabulary
  description: Taxonomy for AQICN air quality APIs.
- type: Integrations
  url: https://aqicn.org/integrations
created: '2024-11-07'
modified: '2026-05-19'
position: Consuming
description: 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.
integrations:
- name: the World Air Quality Index project
- name: made in å京
- name: made in Scheveningen
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.19'