Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

World Air Quality Index (WAQI) Feed API

Air quality feed endpoints for city, geo, and IP-based queries

World Air Quality Index (WAQI) Feed API is one of 3 APIs that World Air Quality Index (WAQI) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Feed. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 3 operations across 3 paths, and defines 10 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.waqi.info.

3 operations 3 paths 10 schemas 3 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.waqi.info
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

World Air Quality Index (WAQI) Feed API declares 1 security scheme for authenticating requests. An API key is passed in the query as token (tokenAuth). By default, every request must be authenticated.

  • tokenAuth — API token obtained from the Air Quality Open Data Platform at https://aqicn.org/data-platform/token/

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.

Feed 3

Air quality feed endpoints for city, geo, and IP-based queries

GET
/feed/{city}/
Get air quality feed for a city
getCityFeed 2 params → 200400401
GET
/feed/geo:{lat};{lng}/
Get air quality feed by geographic coordinates
getGeoFeed 3 params → 200400401
GET
/feed/here/
Get air quality feed based on requester IP address
getIPFeed 1 param → 200401

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are IndividualAQI (11 properties), FeedData (9 properties), ForecastDay (4 properties), TimeInfo (4 properties). Each schema is shown below with its type and property counts.

ForecastDay
object
Daily forecast values for a single pollutant
4 properties 4 required
PollutantValue
object
A single pollutant or measurement value
1 property 1 required
Attribution
object
Data attribution source
3 properties 2 required
ErrorResponse
object
Error response returned when a request fails
2 properties 2 required
TimeInfo
object
Timestamp information for the data reading
4 properties 3 required
Forecast
object
Air quality forecast data (3-8 days)
1 property
CityInfo
object
City or station location information
3 properties 3 required
IndividualAQI
object
Individual pollutant AQI sub-index values
11 properties
FeedData
object
Air quality feed data for a monitoring station
9 properties 5 required
FeedResponse
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

waqi-feed-api-openapi.yml Raw ↑

Other APIs World Air Quality Index (WAQI) publishes across the network.

World Air Quality Index (WAQI) Map API
World Air Quality Index (WAQI) Search API