Air Quality Station Forecast

Access Restriction

This API is a premium service available only to enterprise tier developers. Please contact Caiyun Sales to purchase.

Data

• Spatial resolution: observation stations in mainland China
• Update frequency: hourly
• Time range: hourly from the current hour through the next 120 hours
• Variables: PM2.5, PM10, O3, SO2, NO2, and CO

Forecast Examples

Guangzhou

Dongguan

Jiangmen

Foshan

Nearby Station Forecast API

• Errors

Request

GET https://singer.caiyunhub.com/v3/aqi/forecast/station

Query Parameters

Name	Required	Default	Range	Description
token	Yes	—	—	API token; see Authentication
longitude	Yes	—	—	Longitude
latitude	Yes	—	—	Latitude
hours	No	1	1~120	Number of hours

Request Example

curl "https://singer.caiyunhub.com/v3/aqi/forecast/station?token={token}&longitude=116.3883&latitude=39.9289&hours=120"

Response Example

{
  "data": [
    {
      "station_id": "xxxxx",
      "data": [
        // ...
      ]
    },
    {
      "station_id": "yyyyy",
      "data": [
        // ...
      ]
    }
  ]
}

Response Fields

JSONPath	Type	Description
$.data	array<object>	Nearby stations
$.data[].station_id	string	Station ID
$.data[].data	array<object>	Hourly forecasts
$.data[].data[].id	string	Station ID
$.data[].data[].timestamp	number	Forecast timestamp
$.data[].data[].aqi	number	AQI, Chinese standard
$.data[].data[].pm25	number	PM2.5, μg/m³
$.data[].data[].pm10	number	PM10, μg/m³
$.data[].data[].so2	number	SO₂, μg/m³
$.data[].data[].no2	number	NO₂, μg/m³
$.data[].data[].o3	number	O₃, μg/m³
$.data[].data[].co	number	CO, mg/m³
$.data[].data[].date	string	Date