## 空气质量指数 >[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)  > 查询全国三百多个城市或地区的空气质量指数，较小地区的数据返回上级地区的空气质量。 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ### 请求地址 ``` GET https://api.topthink.com/aqi/search ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | area| 是 | string | 地区名| ### 返回`data`参数 | 名称 | 类型 | 示例值 | 说明 | | --- | --- | --- | --- | | area | string | 上海 | 地区 | | area\_code | string | shanghai | 地区代码 | | so2 | string | 7 | 二氧化硫一小时平均，μg/m³ | | o3 | string | 89 | 臭氧1小时平均，μg/m³ | | pm2\_5 | string | 22 | 颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³ | | primary\_pollutant | string | 颗粒物(PM10) | 首要污染物 | | co | string | 0.4 | 一氧化碳1小时平均，mg/m³ | | num | string | 330 | 污染数 | | no2 | string | 21 | 二氧化氮1小时平均，μg/m³ | | quality | string | 轻度污染 | 空气质量指数类别，有“优、良、轻度污染、中度污染、重度污染、严重污染”6类 | | aqi | string | 113 | 空气质量指数(AQI) | | pm10 | string | 175 | 颗粒物（粒径小于等于10μm）1小时平均，μg/m³ | | o3\_8h | string | 83 | 臭氧8小时滑动平均，μg/m³ | | time | string | 2020-03-19 14:00:34.778 | 更新时间 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->aqiSearch() ->withArea('上海') ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功的返回", "data": { "area":"上海", "area_code":"shanghai", "so2":"7", "o3":"89", "pm2_5":"22", "primary_pollutant":"颗粒物(PM10)", "co":"0.4", "num":"330", "no2":"21", "quality":"轻度污染", "aqi":"113", "pm10":"175", "o3_8h":"83", "time":"2020-03-19 14:00:34.778" } } ~~~