ColorfulClouds
ColorfulClouds Tech (彩云科技, Beijing-based) operates the Caiyun Weather API (api.caiyunapp.com), a hyperlocal weather + air quality forecasting service with minute-level precipitation, hourly forecasts up to 360 hours, daily forecasts up to 15 days, real-time AQI/pollutant readings, severe-weather alerts, and a precipitation map raster. The v2.6 platform powers consumer apps (Amap, Sina Weather) and enterprise weather integrations across China and globally, billed via tiered token plans on the Open Platform.
1 APIs
0 Features
WeatherForecastingAir QualityPrecipitationHyperlocalGeospatialChina
opencollection: 1.0.0
info:
name: Caiyun Weather API
version: '2.6'
request:
auth:
type: apikey
key: token
value: '{{token}}'
placement: query
items:
- info:
name: Realtime
type: folder
items:
- info:
name: Caiyun Weather Get Realtime Weather
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/:token/:lnglat/realtime
params:
- name: token
value: TAkhjf8d1nlSlspN
type: path
description: Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather
than a header.
- name: lnglat
value: 116.4074,39.9042
type: path
description: Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees.
- name: lang
value: en_US
type: query
description: Response language for description fields.
- name: unit
value: metric:v2
type: query
description: Unit system for numeric values (temperature, wind, precipitation, pressure).
docs: Returns the current weather conditions at the requested location — temperature, humidity, wind, cloud cover, sky
condition (skycon), visibility, downward shortwave radiation, pressure, apparent temperature, precipitation, air quality,
and life indices.
- info:
name: Forecast
type: folder
items:
- info:
name: Caiyun Weather Get Minutely Precipitation Forecast
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/:token/:lnglat/minutely
params:
- name: token
value: TAkhjf8d1nlSlspN
type: path
description: Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather
than a header.
- name: lnglat
value: 116.4074,39.9042
type: path
description: Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees.
- name: lang
value: en_US
type: query
description: Response language for description fields.
- name: unit
value: metric:v2
type: query
description: Unit system for numeric values (temperature, wind, precipitation, pressure).
docs: Returns 120-minute minute-level precipitation nowcast (mm/hr) and per-minute probability series for the requested
location, plus a natural-language summary of the precipitation pattern.
- info:
name: Caiyun Weather Get Hourly Weather Forecast
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/:token/:lnglat/hourly
params:
- name: token
value: TAkhjf8d1nlSlspN
type: path
description: Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather
than a header.
- name: lnglat
value: 116.4074,39.9042
type: path
description: Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees.
- name: lang
value: en_US
type: query
description: Response language for description fields.
- name: unit
value: metric:v2
type: query
description: Unit system for numeric values (temperature, wind, precipitation, pressure).
- name: hourlysteps
value: '72'
type: query
description: Number of hourly forecast steps to return.
- name: begin
value: '1748563200'
type: query
description: Anchor the forecast or historical series at a specific Unix epoch second instead of "now". Used to fetch
past 24h (historical) or shift the start of the forecast window.
docs: Returns hourly forecast series for up to 360 hours covering temperature, apparent temperature, humidity, cloud cover,
sky condition, precipitation (value + probability), pressure, visibility, downward shortwave radiation, wind, and air
quality (AQI + PM2.5). When the begin parameter is supplied the series is anchored at that Unix epoch second instead
of "now".
- info:
name: Caiyun Weather Get Daily Weather Forecast
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/:token/:lnglat/daily
params:
- name: token
value: TAkhjf8d1nlSlspN
type: path
description: Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather
than a header.
- name: lnglat
value: 116.4074,39.9042
type: path
description: Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees.
- name: lang
value: en_US
type: query
description: Response language for description fields.
- name: unit
value: metric:v2
type: query
description: Unit system for numeric values (temperature, wind, precipitation, pressure).
- name: dailysteps
value: '7'
type: query
description: Number of daily forecast days to return. Free tier caps at 3.
- name: begin
value: '1748563200'
type: query
description: Anchor the forecast or historical series at a specific Unix epoch second instead of "now". Used to fetch
past 24h (historical) or shift the start of the forecast window.
docs: Returns daily forecast series for up to 15 days covering astronomical sunrise/sunset, precipitation, temperature,
humidity, cloud cover, pressure, visibility, downward shortwave radiation, wind, sky condition, air quality, and life
indices. Includes daytime (08h-20h) and nighttime (20h-32h) splits for skycon, precipitation, temperature, and wind.
Free tier returns 3 days; paid tiers extend to 15.
- info:
name: Weather
type: folder
items:
- info:
name: Caiyun Weather Get Combined Weather Envelope
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/:token/:lnglat/weather
params:
- name: token
value: TAkhjf8d1nlSlspN
type: path
description: Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather
than a header.
- name: lnglat
value: 116.4074,39.9042
type: path
description: Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees.
- name: lang
value: en_US
type: query
description: Response language for description fields.
- name: unit
value: metric:v2
type: query
description: Unit system for numeric values (temperature, wind, precipitation, pressure).
- name: dailysteps
value: '7'
type: query
description: Number of daily forecast days to return. Free tier caps at 3.
- name: hourlysteps
value: '72'
type: query
description: Number of hourly forecast steps to return.
- name: alert
value: 'true'
type: query
description: Include severe-weather alerts in the combined weather response.
- name: begin
value: '1748563200'
type: query
description: Anchor the forecast or historical series at a specific Unix epoch second instead of "now". Used to fetch
past 24h (historical) or shift the start of the forecast window.
- name: granu
value: hourly
type: query
description: Restrict the combined /weather response to a single granularity instead of returning the full envelope.
docs: Returns a combined response containing realtime, minutely, hourly, and daily forecast blocks in a single call, optionally
with severe- weather alerts. The granu parameter narrows the response to a single granularity (realtime, minutely, hourly,
daily) when only part of the envelope is needed.
- info:
name: Air Quality
type: folder
items:
- info:
name: Caiyun Weather Get Realtime Air Quality
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/:token/:lnglat/air-quality
params:
- name: token
value: TAkhjf8d1nlSlspN
type: path
description: Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather
than a header.
- name: lnglat
value: 116.4074,39.9042
type: path
description: Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees.
- name: lang
value: en_US
type: query
description: Response language for description fields.
docs: Returns real-time air quality readings — PM2.5, PM10, O3, SO2, NO2, CO concentrations plus AQI values and category
descriptions under both Chinese (HJ 633-2012) and US EPA standards.
- info:
name: Alerts
type: folder
items:
- info:
name: Caiyun Weather Get Severe Weather Alerts
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/:token/:lnglat/alert
params:
- name: token
value: TAkhjf8d1nlSlspN
type: path
description: Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather
than a header.
- name: lnglat
value: 116.4074,39.9042
type: path
description: Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees.
- name: lang
value: en_US
type: query
description: Response language for description fields.
docs: Returns the active severe-weather alerts published by the China Meteorological Administration for the requested
location, including title, code, status, description, region (province/city/county), adcode, publication timestamp,
and originating source.
- info:
name: Precipitation Map
type: folder
items:
- info:
name: Caiyun Weather Get Precipitation Map Tile
type: http
http:
method: GET
url: https://api.caiyunapp.com/v2.6/precipitation/:z/:x/:y.png
params:
- name: z
value: ''
type: path
description: Web Mercator zoom level (0-9 typical).
- name: x
value: ''
type: path
description: Web Mercator tile column.
- name: y
value: ''
type: path
description: Web Mercator tile row.
- name: timestamp
value: ''
type: query
description: Optional Unix epoch second for the nowcast frame. Omit to receive the most recent observation; provide
a future timestamp within the nowcast horizon to render a forecast frame.
docs: Returns a 256x256 PNG raster tile representing radar + nowcast precipitation intensity colored by the standard dBZ
palette. Suitable for overlaying on Web Mercator base maps (Mapbox, MapLibre, OpenLayers, Leaflet) to render live precipitation
animations.
bundled: true
