加载接口文档…
彩云天气
API全功能天气接口，覆盖： • 实时天气（温度/湿度/风/能见度/AQI/PM2.5） • 分钟级降水预报（未来 2 小时） • 小时预报（最长 360 小时 = 15 天） • 天预报（最长 15 天，含日出日落、温度极值、生活指数） • 综合数据（一次返回全部 + 气象预警） 特…
由 极数本源 提供·更新于 今天
4.2M
累计调用
197ms
平均响应
99.67%
服务可用性
2,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 100 次 · QPS 2
登录免费
当前方案每日 2,000 次 · QPS 3
黄金会员
每日 50,000 次 · QPS 10
钻石会员
每日 100,000 次 · QPS 30
企业会员
企业接口额度 · QPS 120
接入文档
在线工具
接口请求地址
https://v1.apizero.cn/api/weather
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/weather?type=daily&city=%E5%8C%97%E4%BA%AC&days=3
接口信息备注
最长 15 天逐日预报，含温度极值、日出日落、生活指数等。示例为北京真实抓取（序列已截断）。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| type（类型） | string | 必填 · 固定为 daily · 示例：daily |
| city（城市） | string | 可选 · 城市名 · 示例：北京 |
| days（天数） | integer | 可选 · 预报天数 1–15 · 默认 7 · 示例：3 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| type | string | daily |
| location | object | 定位信息 |
| daily | object | 逐日温度、天气、生活指数等 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"type": "daily",
"location": {
"city": "北京",
"longitude": 116.4074,
"latitude": 39.9042,
"timezone": "Asia/Shanghai"
},
"server_time": "2026-07-31 04:10:49",
"forecast_keypoint": null,
"summary": null,
"alerts": [],
"daily": {
"status": "ok",
"astro": [
{
"date": "2026-07-31T00:00+08:00",
"sunrise": {
"time": "05:11"
},
"sunset": {
"time": "19:29"
}
},
{
"date": "2026-08-01T00:00+08:00",
"sunrise": {
"time": "05:12"
},
"sunset": {
"time": "19:28"
}
},
{
"date": "2026-08-02T00:00+08:00",
"sunrise": {
"time": "05:13"
},
"sunset": {
"time": "19:27"
}
}
],
"precipitation_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 0,
"min": 0,
"avg": 0,
"probability": 0
},
{
"date": "2026-08-01T00:00+08:00",
"max": 0.4096,
"min": 0,
"avg": 0.0341,
"probability": 60
},
{
"date": "2026-08-02T00:00+08:00",
"max": 1.8265,
"min": 0,
"avg": 0.5487,
"probability": 70
}
],
"precipitation_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 3.6836,
"min": 0,
"avg": 0.6972,
"probability": 70
},
{
"date": "2026-08-01T00:00+08:00",
"max": 1.1707,
"min": 0,
"avg": 0.1741,
"probability": 60
},
{
"date": "2026-08-02T00:00+08:00",
"max": 4.1774,
"min": 0,
"avg": 0.4281,
"probability": 60
}
],
"precipitation": [
{
"date": "2026-07-31T00:00+08:00",
"max": 0.9151,
"min": 0,
"avg": 0.0458,
"probability": 60
},
{
"date": "2026-08-01T00:00+08:00",
"max": 3.6836,
"min": 0,
"avg": 0.3275,
"probability": 60
},
{
"date": "2026-08-02T00:00+08:00",
"max": 1.8265,
"min": 0,
"avg": 0.4506,
"probability": 70
}
],
"temperature": [
{
"date": "2026-07-31T00:00+08:00",
"max": 32.97,
"min": 27.63,
"avg": 30.4
},
{
"date": "2026-08-01T00:00+08:00",
"max": 32.08,
"min": 25.93,
"avg": 28.99
},
{
"date": "2026-08-02T00:00+08:00",
"max": 33.45,
"min": 26.76,
"avg": 29.39
}
],
"temperature_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 32.97,
"min": 28.59,
"avg": 31.54
},
{
"date": "2026-08-01T00:00+08:00",
"max": 32.08,
"min": 26.59,
"avg": 30.26
},
{
"date": "2026-08-02T00:00+08:00",
"max": 33.45,
"min": 27.39,
"avg": 30.84
}
],
"temperature_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 29.71,
"min": 25.93,
"avg": 27.38
},
{
"date": "2026-08-01T00:00+08:00",
"max": 30.74,
"min": 26.76,
"avg": 28.39
},
{
"date": "2026-08-02T00:00+08:00",
"max": 29.32,
"min": 26.49,
"avg": 27.33
}
],
"wind": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"speed": 9.44,
"direction": 219.58
},
"min": {
"speed": 3.39,
"direction": 197.28
},
"avg": {
"speed": 6.19,
"direction": 193.96
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"speed": 6.31,
"direction": 182.94
},
"min": {
"speed": 1.43,
"direction": 40.91
},
"avg": {
"speed": 3.88,
"direction": 179.33
}
},
{
"date": "2026-08-02T00:00+08:00",
"max": {
"speed": 7.42,
"direction": 178.05
},
"min": {
"speed": 1.81,
"direction": 47.42
},
"avg": {
"speed": 3.64,
"direction": 154.29
}
}
],
"wind_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"speed": 9.44,
"direction": 219.58
},
"min": {
"speed": 3.39,
"direction": 197.28
},
"avg": {
"speed": 6.77,
"direction": 189.98
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"speed": 6.31,
"direction": 182.94
},
"min": {
"speed": 1.43,
"direction": 40.91
},
"avg": {
"speed": 2.92,
"direction": 164.04
}
},
{
"date": "2026-08-02T00:00+08:00",
"max": {
"speed": 7.42,
"direction": 178.05
},
"min": {
"speed": 2.89,
"direction": 3.58
},
"avg": {
"speed": 3.27,
"direction": 172
}
}
],
"wind_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"speed": 6.16,
"direction": 201.61
},
"min": {
"speed": 2.17,
"direction": 184.76
},
"avg": {
"speed": 4.41,
"direction": 203.52
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"speed": 5.17,
"direction": 205.14
},
"min": {
"speed": 1.81,
"direction": 47.42
},
"avg": {
"speed": 2.73,
"direction": 152.69
}
},
{
"date": "2026-08-02T00:00+08:00",
"max": {
"speed": 7.07,
"direction": 26.62
},
"min": {
"speed": 1.99,
"direction": 84.81
},
"avg": {
"speed": 5.19,
"direction": 38.41
}
}
],
"humidity": [
{
"date": "2026-07-31T00:00+08:00",
"max": 0.87,
"min": 0.56,
"avg": 0.7
},
{
"date": "2026-08-01T00:00+08:00",
"max": 0.86,
"min": 0.57,
"avg": 0.74
},
{
"date": "2026-08-02T00:00+08:00",
"max": 0.87,
"min": 0.55,
"avg": 0.74
}
],
"cloudrate": [
{
"date": "2026-07-31T00:00+08:00",
"max": 1,
"min": 0.07,
"avg": 0.49
},
{
"date": "2026-08-01T00:00+08:00",
"max": 0.92,
"min": 0,
"avg": 0.39
},
{
"date": "2026-08-02T00:00+08:00",
"max": 1,
"min": 0.77,
"avg": 0.99
}
],
"pressure": [
{
"date": "2026-07-31T00:00+08:00",
"max": 99755.52,
"min": 99330.88,
"avg": 99516.91
},
{
"date": "2026-08-01T00:00+08:00",
"max": 99706.07,
"min": 99385.45,
"avg": 99525.87
},
{
"date": "2026-08-02T00:00+08:00",
"max": 99979.26,
"min": 99645.55,
"avg": 99818.24
}
],
"visibility": [
{
"date": "2026-07-31T00:00+08:00",
"max": 24.18,
"min": 0.62,
"avg": 15.59
},
{
"date": "2026-08-01T00:00+08:00",
"max": 29.1,
"min": 5.83,
"avg": 19.48
},
{
"date": "2026-08-02T00:00+08:00",
"max": 24.14,
"min": 0.23,
"avg": 15.4
}
],
"dswrf": [
{
"date": "2026-07-31T00:00+08:00",
"max": 776.5,
"min": 0,
"avg": 229.5
},
{
"date": "2026-08-01T00:00+08:00",
"max": 782,
"min": 0,
"avg": 214.2
},
{
"date": "2026-08-02T00:00+08:00",
"max": 604.5,
"min": 0,
"avg": 138.5
}
],
"air_quality": {
"aqi": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"chn": 53,
"usa": 86
},
"avg": {
"chn": 48,
"usa": 78
},
"min": {
"chn": 37,
"usa": 61
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"chn": 53,
"usa": 102
},
"avg": {
"chn": 50,
"usa": 90
},
"min": {
"chn": 43,
"usa": 86
}
}
],
"pm25": [
{
"date": "2026-07-31T00:00+08:00",
"max": 29,
"avg": 24,
"min": 17
},
{
"date": "2026-08-01T00:00+08:00",
"max": 36,
"avg": 31,
"min": 29
}
]
},
"skycon": [
{
"date": "2026-07-31T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-01T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-02T00:00+08:00",
"value": "MODERATE_RAIN"
}
],
"skycon_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"value": "PARTLY_CLOUDY_DAY"
},
{
"date": "2026-08-01T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-02T00:00+08:00",
"value": "MODERATE_RAIN"
}
],
"skycon_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"value": "MODERATE_RAIN"
},
{
"date": "2026-08-01T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-02T00:00+08:00",
"value": "LIGHT_RAIN"
}
],
"life_index": {
"ultraviolet": [
{
"date": "2026-07-31T00:00+08:00",
"index": "1",
"desc": "最弱"
},
{
"date": "2026-08-01T00:00+08:00",
"index": "2",
"desc": "弱"
}
],
"carWashing": [
{
"date": "2026-07-31T00:00+08:00",
"index": "3",
"desc": "较不适宜"
},
{
"date": "2026-08-01T00:00+08:00",
"index": "3",
"desc": "较不适宜"
}
],
"dressing": [
{
"date": "2026-07-31T00:00+08:00",
"index": "2",
"desc": "很热"
},
{
"date": "2026-08-01T00:00+08:00",
"index": "2",
"desc": "很热"
}
]
}
}
},
"request_id": "ms7y7sqff6490a75",
"tips": "极数本源 · https://apizero.cn"
}