Overview
ColorfulClouds (Caiyun Weather) is a Chinese weather API that delivers real-time and forecast weather data with minute-level precipitation predictions. It is especially useful for apps targeting users in China, offering hyperlocal rainfall forecasting. Getting started requires signing up for an API key on the Caiyun open platform.
Beginner Tip
Set your API key as part of the request URL path. Start with the real-time weather endpoint to verify your key before exploring forecast and alert endpoints.
Available Data
Example Response
{
"location": "Tokyo",
"temperature": {
"current": 22,
"feels_like": 24,
"min": 18,
"max": 26
},
"condition": "Partly Cloudy",
"humidity": 65,
"wind": {
"speed": 12,
"direction": "NE"
},
"forecast": [
{
"date": "2025-01-16",
"high": 25,
"low": 17,
"condition": "Sunny"
}
]
} Field Reference
result.realtime.temperature Current air temperature in degrees Celsius. result.realtime.precipitation.local.intensity Current precipitation intensity at the requested location in mm/h. result.realtime.skycon Sky condition code such as CLEAR_DAY, RAIN, or CLOUDY. result.realtime.wind.speed Wind speed in km/h at the current moment. result.realtime.humidity Relative humidity as a fraction between 0 and 1. Implementation Example
const url = "https://open.caiyunapp.com/ColorfulClouds_Weather_API";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Partially tested on Apr 5, 2026
Technical Specifications
Similar APIs
View All →AccuWeather
AccuWeather's API provides highly detailed weather forecasts, current conditions, and severe weather alerts for locations around the world.
Aemet
Aemet OpenData is Spain's official meteorological agency API providing weather forecasts, observations, and climate data for Spanish territory including the Canary Islands and Balearics.
APIXU
APIXU (now rebranded as Weatherstack) is a weather data API that provides current conditions, forecasts, and historical weather for locations around the world.
AQICN
⭐ Beginner's PickAQICN (Air Quality Index CN) provides real-time air quality data for over 1,000 cities worldwide, including PM2.5, PM10, ozone, and other pollutant readings.
Euskalmet
Euskalmet is the official meteorological API for the Basque Country in Spain, providing weather observations, forecasts, and climate records for the region.