Air Quality Programmatic APIs Search API
The Search API from Air Quality Programmatic APIs — 1 operation(s) for search.
OpenAPI Specification
openapi: 3.1.0
info:
title: Air Quality Programmatic APIs Real-time Air Quality Tile Air Quality Programmatic APIs Real Time Air Quality Tile API Search API
description: API providing real-time air quality data as map tiles.
version: 1.0.0
servers:
- url: https://tiles.aqicn.org/tiles
description: Production server
tags:
- name: Search
paths:
/search/:
get:
operationId: searchStations
summary: Air Quality Programmatic APIs AQICN Search Monitoring Stations
description: Search for air quality monitoring stations by keyword, city name, or station name.
tags:
- Search
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- name: keyword
in: query
required: true
description: Search keyword (city or station name)
schema:
type: string
example: London
- name: token
in: query
required: true
description: API authentication token
schema:
type: string
example: demo
responses:
'200':
description: List of matching stations
content:
application/json:
schema:
$ref: '#/components/schemas/StationSearchResult'
examples:
searchStations200Example:
summary: Default searchStations 200 response
x-microcks-default: true
value:
status: ok
data:
- uid: 5724
aqi: '42'
station:
name: London, United Kingdom
geo:
- 51.5074
- -0.1278
components:
schemas:
StationSearchResult:
type: object
description: Station search result
properties:
status:
type: string
example: ok
data:
type: array
description: List of matching stations
items:
type: object
properties:
uid:
type: integer
description: Station unique ID
example: 8502
aqi:
type: string
description: Current AQI value or "N/A"
example: '45'
station:
type: object
properties:
name:
type: string
description: Station name
example: Beijing, China
geo:
type: array
items:
type: number
securitySchemes:
ApiKeyAuth:
type: apiKey
in: query
name: token
description: API key for authentication