提供全国 1,600+ 个环境监测站点的实时空气质量数据，涵盖 AQI、PM2.5、PM10、SO₂、NO₂、CO、O₃ 等核心指标，支持按城市名或行政区划编码查询，数据每小时更新，适用于环保监测、户外运动、健康管理等场景。
空气质量指数 API 通过标准 HTTP GET 请求返回 JSON 格式的空气质量数据。支持按城市名称或行政区划编码查询，可选择返回实时数据或最近 24 小时逐时数据。返回字段涵盖 AQI 综合指数、六项污染物浓度、首要污染物、空气质量等级等信息。接口全程 HTTPS 加密传输，支持高并发调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| city | string | 是 | 城市名称，如「北京」「上海市」，与 adcode 二选一填写。 |
| adcode | string | 否 | 行政区划编码（6 位），如 110000，与 city 二选一，优先级高于 city。 |
| type | string | 否 | 返回类型：hour=实时数据（默认）、day=最近 24 小时逐时数据。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.city | string | 查询城市名称。 |
| data.aqi | int | 空气质量指数（AQI），范围 0-500。 |
| data.pm25 | float | PM2.5 浓度，单位 μg/m³。 |
| data.pm10 | float | PM10 浓度，单位 μg/m³。 |
| data.so2 | float | 二氧化硫浓度，单位 μg/m³。 |
| data.primary_pollutant | string | 首要污染物名称，如「PM2.5」「PM10」。 |
| data.quality_level | string | 空气质量等级：优、良、轻度污染、中度污染、重度污染、严重污染。 |
| data.update_time | string | 数据更新时间，格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"city": "北京",
"aqi": 78,
"pm25": 56.3,
"pm10": 89.7,
"so2": 5.2,
"primary_pollutant": "PM2.5",
"quality_level": "良",
"update_time": "2026-07-25 15:00:00"
}
}