彩云天气
weatherGETGET
https://v1.apizero.cn/api/weather概述
全功能天气接口，覆盖： • 实时天气（温度/湿度/风/能见度/AQI/PM2.5） • 分钟级降水预报（未来 2 小时） • 小时预报（最长 360 小时 = 15 天） • 天预报（最长 15 天，含日出日落、温度极值、生活指数） • 综合数据（一次返回全部 + 气象预警） 特色： • 支持城市名直接查询（内置常用中国城市，也支持经纬度） • 自动中文化：skycon 转中文、风向转 16 方位、风速转蒲福风级、AQI 转等级颜色 • 预警标准化：从原始 title 提取颜色（蓝/黄/橙/红）和级别（一般/较重/严重/特别严重） • 顶层 summary 字段提供"一眼看懂"的实时摘要 • 对齐官网风级请读 summary.wind.level_si（speed_ms / level 为历史字段，数字不改）
调用约定
- 网关 ·
https://v1.apizero.cn - 鉴权 ·
Authorization: Bearer <API Key> - 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/weather/raw.md鉴权
匿名可调用：QPS 2、日 100 次；登录后：QPS 10、日 2000 次。
获取 API Key：获取 API Key/account/keys
请求头
Authorizationstring选填
推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
| Header | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 否 | 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
综合天气（推荐）
GETURL QUERY·APPLICATION/JSON
一次返回实时 + 分钟降水 + 小时/天预报 + 气象预警摘要。type 默认 weather。city 与 location 二选一。文档示例为北京真实数据（预报序列已截断）。
https://v1.apizero.cn/api/weather?type=weather&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085&alert=true&days=7&hours=48
type（类型）string选填
固定为 weather：综合数据包
例weather
city（城市）string选填
城市/地区名称，与 location 二选一
例北京
location（经纬度）string选填
经纬度「经度,纬度」，优先级高于 city
例116.3975,39.9085
alert（预警）boolean选填
是否附带气象预警
例true
days（天数）integer选填
天预报天数 1–15
例7
hours（小时数）integer选填
小时预报小时数，最长 360
例48
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type（类型） | string | 否 | 固定为 weather：综合数据包 | weather |
| city（城市） | string | 否 | 城市/地区名称，与 location 二选一 | 北京 |
| location（经纬度） | string | 否 | 经纬度「经度,纬度」，优先级高于 city | 116.3975,39.9085 |
| alert（预警） | boolean | 否 | 是否附带气象预警 | true |
| days（天数） | integer | 否 | 天预报天数 1–15 | 7 |
| hours（小时数） | integer | 否 | 小时预报小时数，最长 360 | 48 |
返回结果
typestring
查询类型，此处为 weather
locationobject
城市、经纬度、时区
citystring
城市
longitudenumber
经度
latitudenumber
纬度
timezonestring
timezone
server_timeinteger
服务端时间戳
forecast_keypointstring
一句话天气总结
summaryobject
一眼可读的实时摘要（温度/天气/风/AQI）
citystring
城市
skyconstring
skycon
skycon_emojistring
skycon_emoji
skycon_codestring
skycon_code
temperaturenumber
temperature
apparent_temperaturenumber
apparent_temperature
humidity_percentnumber
humidity_percent
cloudrate_percentnumber
cloudrate_percent
visibility_kmnumber
visibility_km
windobject
wind
speed_msnumber
speed_ms
direction_degnumber
direction_deg
direction_textstring
direction_text
levelnumber
level
level_textstring
level_text
air_qualityobject
air_quality
aqinumber
aqi
levelstring
level
level_colorstring
level_color
pm25number
pm25
alert_countnumber
alert_count
alertsarray
气象预警列表
alerts[]string
alerts 的一项
realtimeobject
实时天气原始字段
statusstring
状态
temperaturenumber
temperature
humiditynumber
humidity
cloudratenumber
cloudrate
skyconstring
skycon
visibilitynumber
visibility
dswrfnumber
dswrf
windobject
wind
speednumber
speed
directionnumber
direction
pressurenumber
pressure
apparent_temperaturenumber
apparent_temperature
precipitationobject
precipitation
localobject
local
nearestobject
nearest
air_qualityobject
air_quality
pm25number
pm25
pm10number
pm10
o3number
o3
so2number
so2
no2number
no2
conumber
co
aqiobject
aqi
descriptionobject
description
life_indexobject
life_index
ultravioletobject
ultraviolet
comfortobject
comfort
minutelyobject
分钟级降水（仅综合包）
statusstring
状态
datasourcestring
datasource
precipitation_2harray
precipitation_2h
minutely.precipitation_2h[]number
minutely.precipitation_2h 的一项
precipitationarray
precipitation
minutely.precipitation[]number
minutely.precipitation 的一项
accumulationarray
accumulation
minutely.accumulation[]number
minutely.accumulation 的一项
probabilityarray
probability
minutely.probability[]number
minutely.probability 的一项
descriptionstring
description
hourlyobject
小时预报
statusstring
状态
descriptionstring
description
precipitationarray
precipitation
datetimestring
datetime
valuenumber
value
probabilitynumber
probability
temperaturearray
temperature
datetimestring
datetime
valuenumber
value
apparent_temperaturearray
apparent_temperature
datetimestring
datetime
valuenumber
value
windarray
wind
datetimestring
datetime
speednumber
speed
directionnumber
direction
humidityarray
humidity
datetimestring
datetime
valuenumber
value
cloudratearray
cloudrate
datetimestring
datetime
valuenumber
value
skyconarray
skycon
datetimestring
datetime
valuestring
value
pressurearray
pressure
datetimestring
datetime
valuenumber
value
visibilityarray
visibility
datetimestring
datetime
valuenumber
value
dswrfarray
dswrf
datetimestring
datetime
valuenumber
value
air_qualityobject
air_quality
aqiarray
aqi
pm25array
pm25
dailyobject
天预报
statusstring
状态
astroarray
astro
datestring
date
sunriseobject
sunrise
sunsetobject
sunset
precipitation_08h_20harray
precipitation_08h_20h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
probabilitynumber
probability
precipitation_20h_32harray
precipitation_20h_32h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
probabilitynumber
probability
precipitationarray
precipitation
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
probabilitynumber
probability
temperaturearray
temperature
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
temperature_08h_20harray
temperature_08h_20h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
temperature_20h_32harray
temperature_20h_32h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
windarray
wind
datestring
date
maxobject
max
minobject
min
avgobject
avg
wind_08h_20harray
wind_08h_20h
datestring
date
maxobject
max
minobject
min
avgobject
avg
wind_20h_32harray
wind_20h_32h
datestring
date
maxobject
max
minobject
min
avgobject
avg
humidityarray
humidity
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
cloudratearray
cloudrate
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
pressurearray
pressure
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
visibilityarray
visibility
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
dswrfarray
dswrf
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
air_qualityobject
air_quality
aqiarray
aqi
pm25array
pm25
skyconarray
skycon
datestring
date
valuestring
value
skycon_08h_20harray
skycon_08h_20h
datestring
date
valuestring
value
skycon_20h_32harray
skycon_20h_32h
datestring
date
valuestring
value
life_indexobject
life_index
ultravioletarray
ultraviolet
carWashingarray
carWashing
dressingarray
dressing
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type | string | 查询类型，此处为 weather | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| location | object | 城市、经纬度、时区 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| server_time | integer | 服务端时间戳 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| forecast_keypoint | string | 一句话天气总结 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| summary | object | 一眼可读的实时摘要（温度/天气/风/AQI） | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| alerts | array | 气象预警列表 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| realtime | object | 实时天气原始字段 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| minutely | object | 分钟级降水（仅综合包） | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hourly | object | 小时预报 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| daily | object | 天预报 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"type": "weather",
"location": {
"city": "北京",
"longitude": 116.4074,
"latitude": 39.9042,
"timezone": "Asia/Shanghai"
},
"server_time": "2026-07-31 04:10:38",
"forecast_keypoint": "多云，今天晚间23点钟后转小雨，其后多云",
"summary": {
"city": "北京",
"skycon": "多云",
"skycon_emoji": "☁️",
"skycon_code": "PARTLY_CLOUDY_NIGHT",
"temperature": 28.8,
"apparent_temperature": 32.6,
"humidity_percent": 81,
"cloudrate_percent": 29,
"visibility_km": 8.2,
"wind": {
"speed_ms": 5.6,
"direction_deg": 199.6,
"direction_text": "西南偏南风",
"level": 4,
"level_text": "和风"
},
"air_quality": {
"aqi": 36,
"level": "优",
"level_color": "green",
"pm25": 15
},
"alert_count": 0
},
"alerts": [],
"realtime": {
"status": "ok",
"temperature": 28.76,
"humidity": 0.81,
"cloudrate": 0.29,
"skycon": "PARTLY_CLOUDY_NIGHT",
"visibility": 8.19,
"dswrf": 0,
"wind": {
"speed": 5.58,
"direction": 199.6
},
"pressure": 99652.7,
"apparent_temperature": 32.6,
"precipitation": {
"local": {
"status": "ok",
"datasource": "radar",
"intensity": 0
},
"nearest": {
"status": "ok",
"distance": 144.37,
"intensity": 0.1875
}
},
"air_quality": {
"pm25": 15,
"pm10": 36,
"o3": 57,
"so2": 1,
"no2": 18,
"co": 0.5,
"aqi": {
"chn": 36,
"usa": 61
},
"description": {
"chn": "优",
"usa": "良"
}
},
"life_index": {
"ultraviolet": {
"index": 0,
"desc": "无"
},
"comfort": {
"index": 0,
"desc": "闷热"
}
}
},
"minutely": {
"status": "ok",
"datasource": "radar",
"precipitation_2h": [
0,
0,
0,
0,
0,
0,
0,
0
],
"precipitation": [
0,
0,
0
],
"accumulation": [
0,
0
],
"probability": [
0,
0,
0,
0
],
"description": "未来两小时不会有雨。夜深了，注意休息哦～"
},
"hourly": {
"status": "ok",
"description": "多云，今天晚间23点钟后转小雨，其后多云",
"precipitation": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0,
"probability": 0
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0,
"probability": 0
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0,
"probability": 0
}
],
"temperature": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 28.76
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 28.44
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 28.32
}
],
"apparent_temperature": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 32.6
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 32.7
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 32.6
},
{
"datetime": "2026-07-31T07:00+08:00",
"value": 33
},
{
"datetime": "2026-07-31T08:00+08:00",
"value": 33.8
},
{
"datetime": "2026-07-31T09:00+08:00",
"value": 34.7
}
],
"wind": [
{
"datetime": "2026-07-31T04:00+08:00",
"speed": 5.58,
"direction": 199.6
},
{
"datetime": "2026-07-31T05:00+08:00",
"speed": 4.61,
"direction": 187.18
},
{
"datetime": "2026-07-31T06:00+08:00",
"speed": 4.83,
"direction": 194.24
}
],
"humidity": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0.81
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0.86
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.87
}
],
"cloudrate": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0.29
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0.29
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.8
}
],
"skycon": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": "PARTLY_CLOUDY_NIGHT"
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": "PARTLY_CLOUDY_NIGHT"
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": "PARTLY_CLOUDY_DAY"
}
],
"pressure": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 99652.7
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 99625.53
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 99621.15
}
],
"visibility": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 8.19
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 8.12
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.62
}
],
"dswrf": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 37.953125
}
],
"air_quality": {
"aqi": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": {
"chn": 36,
"usa": 61
}
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": {
"chn": 47,
"usa": 71
}
}
],
"pm25": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 15
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 22
}
]
}
},
"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": 47,
"usa": 77
},
"min": {
"chn": 36,
"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": 15
},
{
"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": "ms7y7k0z8731cc94",
"tips": "极数本源 · https://apizero.cn"
}实时天气
GETURL QUERY·APPLICATION/JSON
仅返回 realtime：温度、湿度、风、能见度、AQI、PM2.5 等即时数据。示例为北京真实抓取。
https://v1.apizero.cn/api/weather?type=realtime&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085
type（类型）string必填
固定为 realtime
例realtime
city（城市）string选填
城市名，与 location 二选一
例北京
location（经纬度）string选填
经纬度坐标
例116.3975,39.9085
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type（类型） | string | 是 | 固定为 realtime | realtime |
| city（城市） | string | 否 | 城市名，与 location 二选一 | 北京 |
| location（经纬度） | string | 否 | 经纬度坐标 | 116.3975,39.9085 |
返回结果
typestring
realtime
locationobject
定位信息
citystring
城市
longitudenumber
经度
latitudenumber
纬度
timezonestring
timezone
summaryobject
中文化摘要
citystring
城市
skyconstring
skycon
skycon_emojistring
skycon_emoji
skycon_codestring
skycon_code
temperaturenumber
temperature
apparent_temperaturenumber
apparent_temperature
humidity_percentnumber
humidity_percent
cloudrate_percentnumber
cloudrate_percent
visibility_kmnumber
visibility_km
windobject
wind
speed_msnumber
speed_ms
direction_degnumber
direction_deg
direction_textstring
direction_text
levelnumber
level
level_textstring
level_text
air_qualityobject
air_quality
aqinumber
aqi
levelstring
level
level_colorstring
level_color
pm25number
pm25
alert_countnumber
alert_count
realtimeobject
实时气象字段（温度/湿度/风/空气质量等）
statusstring
状态
temperaturenumber
temperature
humiditynumber
humidity
cloudratenumber
cloudrate
skyconstring
skycon
visibilitynumber
visibility
dswrfnumber
dswrf
windobject
wind
speednumber
speed
directionnumber
direction
pressurenumber
pressure
apparent_temperaturenumber
apparent_temperature
precipitationobject
precipitation
localobject
local
nearestobject
nearest
air_qualityobject
air_quality
pm25number
pm25
pm10number
pm10
o3number
o3
so2number
so2
no2number
no2
conumber
co
aqiobject
aqi
descriptionobject
description
life_indexobject
life_index
ultravioletobject
ultraviolet
comfortobject
comfort
alertsarray
气象预警（若有）
alerts[]string
alerts 的一项
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type | string | realtime | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| location | object | 定位信息 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| summary | object | 中文化摘要 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| realtime | object | 实时气象字段（温度/湿度/风/空气质量等） | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| alerts | array | 气象预警（若有） | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"type": "realtime",
"location": {
"city": "北京",
"longitude": 116.4074,
"latitude": 39.9042,
"timezone": "Asia/Shanghai"
},
"server_time": "2026-07-31 04:10:38",
"forecast_keypoint": null,
"summary": {
"city": "北京",
"skycon": "多云",
"skycon_emoji": "☁️",
"skycon_code": "PARTLY_CLOUDY_NIGHT",
"temperature": 28.8,
"apparent_temperature": 32.6,
"humidity_percent": 81,
"cloudrate_percent": 29,
"visibility_km": 8.2,
"wind": {
"speed_ms": 5.6,
"direction_deg": 199.6,
"direction_text": "西南偏南风",
"level": 4,
"level_text": "和风"
},
"air_quality": {
"aqi": 36,
"level": "优",
"level_color": "green",
"pm25": 15
},
"alert_count": 0
},
"alerts": [],
"realtime": {
"status": "ok",
"temperature": 28.76,
"humidity": 0.81,
"cloudrate": 0.29,
"skycon": "PARTLY_CLOUDY_NIGHT",
"visibility": 8.19,
"dswrf": 0,
"wind": {
"speed": 5.58,
"direction": 199.6
},
"pressure": 99652.7,
"apparent_temperature": 32.6,
"precipitation": {
"local": {
"status": "ok",
"datasource": "radar",
"intensity": 0
},
"nearest": {
"status": "ok",
"distance": 144.37,
"intensity": 0.1875
}
},
"air_quality": {
"pm25": 15,
"pm10": 36,
"o3": 57,
"so2": 1,
"no2": 18,
"co": 0.5,
"aqi": {
"chn": 36,
"usa": 61
},
"description": {
"chn": "优",
"usa": "良"
}
},
"life_index": {
"ultraviolet": {
"index": 0,
"desc": "无"
},
"comfort": {
"index": 0,
"desc": "闷热"
}
}
}
},
"request_id": "ms7y7k4m10fef03e",
"tips": "极数本源 · https://apizero.cn"
}分钟级降水
GETURL QUERY·APPLICATION/JSON
未来约 2 小时分钟级降水强度预报，适合短时出行决策。示例为北京真实抓取。
https://v1.apizero.cn/api/weather?type=minutely&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085
type（类型）string必填
固定为 minutely
例minutely
city（城市）string选填
城市名
例北京
location（经纬度）string选填
经纬度
例116.3975,39.9085
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type（类型） | string | 是 | 固定为 minutely | minutely |
| city（城市） | string | 否 | 城市名 | 北京 |
| location（经纬度） | string | 否 | 经纬度 | 116.3975,39.9085 |
返回结果
typestring
minutely
forecast_keypointstring
短时降水一句话提示
minutelyobject
分钟降水序列与描述文案
statusstring
状态
datasourcestring
datasource
precipitation_2harray
precipitation_2h
minutely.precipitation_2h[]number
minutely.precipitation_2h 的一项
precipitationarray
precipitation
minutely.precipitation[]number
minutely.precipitation 的一项
accumulationarray
accumulation
minutely.accumulation[]number
minutely.accumulation 的一项
probabilityarray
probability
minutely.probability[]number
minutely.probability 的一项
descriptionstring
description
summaryobject
实时摘要（若有）
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type | string | minutely | |||||||||||||||||||||||||||||||||||||||||||||
| forecast_keypoint | string | 短时降水一句话提示 | |||||||||||||||||||||||||||||||||||||||||||||
| minutely | object | 分钟降水序列与描述文案 | |||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||
| summary | object | 实时摘要（若有） | |||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | |||||||||||||||||||||||||||||||||||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"type": "minutely",
"location": {
"city": "北京",
"longitude": 116.4074,
"latitude": 39.9042,
"timezone": "Asia/Shanghai"
},
"server_time": "2026-07-31 04:10:48",
"forecast_keypoint": "未来两小时不会有雨。夜深了，注意休息哦～",
"summary": null,
"alerts": [],
"minutely": {
"status": "ok",
"datasource": "radar",
"precipitation_2h": [
0,
0,
0,
0,
0,
0,
0,
0
],
"precipitation": [
0,
0,
0
],
"accumulation": [
0,
0
],
"probability": [
0,
0,
0,
0
],
"description": "未来两小时不会有雨。夜深了，注意休息哦～"
}
},
"request_id": "ms7y7rl986e4627d",
"tips": "极数本源 · https://apizero.cn"
}小时预报
GETURL QUERY·APPLICATION/JSON
最长 360 小时（15 天）逐小时预报。可用 hours 控制返回长度。示例为北京真实抓取（序列已截断）。
https://v1.apizero.cn/api/weather?type=hourly&city=%E5%8C%97%E4%BA%AC&hours=6
type（类型）string必填
固定为 hourly
例hourly
city（城市）string选填
城市名
例北京
hours（小时数）integer选填
返回小时数，1–360
例6
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type（类型） | string | 是 | 固定为 hourly | hourly |
| city（城市） | string | 否 | 城市名 | 北京 |
| hours（小时数） | integer | 否 | 返回小时数，1–360 | 6 |
返回结果
typestring
hourly
locationobject
定位信息
citystring
城市
longitudenumber
经度
latitudenumber
纬度
timezonestring
timezone
hourlyobject
逐小时温度、降水、天气现象等
statusstring
状态
descriptionstring
description
precipitationarray
precipitation
datetimestring
datetime
valuenumber
value
probabilitynumber
probability
temperaturearray
temperature
datetimestring
datetime
valuenumber
value
apparent_temperaturearray
apparent_temperature
datetimestring
datetime
valuenumber
value
windarray
wind
datetimestring
datetime
speednumber
speed
directionnumber
direction
humidityarray
humidity
datetimestring
datetime
valuenumber
value
cloudratearray
cloudrate
datetimestring
datetime
valuenumber
value
skyconarray
skycon
datetimestring
datetime
valuestring
value
pressurearray
pressure
datetimestring
datetime
valuenumber
value
visibilityarray
visibility
datetimestring
datetime
valuenumber
value
dswrfarray
dswrf
datetimestring
datetime
valuenumber
value
air_qualityobject
air_quality
aqiarray
aqi
pm25array
pm25
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type | string | hourly | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| location | object | 定位信息 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hourly | object | 逐小时温度、降水、天气现象等 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"type": "hourly",
"location": {
"city": "北京",
"longitude": 116.4074,
"latitude": 39.9042,
"timezone": "Asia/Shanghai"
},
"server_time": "2026-07-31 04:10:15",
"forecast_keypoint": "多云，今天晚间23点钟后转小雨，其后多云",
"summary": null,
"alerts": [],
"hourly": {
"status": "ok",
"description": "多云，今天晚间23点钟后转小雨，其后多云",
"precipitation": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0,
"probability": 0
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0,
"probability": 0
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0,
"probability": 0
}
],
"temperature": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 28.76
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 28.38
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 28.19
}
],
"apparent_temperature": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 32.6
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 32.4
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 32.3
},
{
"datetime": "2026-07-31T07:00+08:00",
"value": 32
},
{
"datetime": "2026-07-31T08:00+08:00",
"value": 31.9
},
{
"datetime": "2026-07-31T09:00+08:00",
"value": 32.3
}
],
"wind": [
{
"datetime": "2026-07-31T04:00+08:00",
"speed": 5.3,
"direction": 191.77
},
{
"datetime": "2026-07-31T05:00+08:00",
"speed": 5.36,
"direction": 185.79
},
{
"datetime": "2026-07-31T06:00+08:00",
"speed": 4.26,
"direction": 175.64
}
],
"humidity": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0.81
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0.85
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.85
}
],
"cloudrate": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0.29
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0.29
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.8
}
],
"skycon": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": "PARTLY_CLOUDY_NIGHT"
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": "PARTLY_CLOUDY_NIGHT"
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": "PARTLY_CLOUDY_DAY"
}
],
"pressure": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 99614.5
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 99631.5
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 99639.94
}
],
"visibility": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 8.19
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 8.12
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.62
}
],
"dswrf": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 37.953125
}
],
"air_quality": {
"aqi": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": {
"chn": 46,
"usa": 69
}
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": {
"chn": 46,
"usa": 71
}
}
],
"pm25": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 21
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 22
}
]
}
}
},
"request_id": "ms7y7s5z4b78404d",
"tips": "极数本源 · https://apizero.cn"
}天预报
GETURL QUERY·APPLICATION/JSON
最长 15 天逐日预报，含温度极值、日出日落、生活指数等。示例为北京真实抓取（序列已截断）。
https://v1.apizero.cn/api/weather?type=daily&city=%E5%8C%97%E4%BA%AC&days=3
type（类型）string必填
固定为 daily
例daily
city（城市）string选填
城市名
例北京
days（天数）integer选填
预报天数 1–15
例3
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type（类型） | string | 是 | 固定为 daily | daily |
| city（城市） | string | 否 | 城市名 | 北京 |
| days（天数） | integer | 否 | 预报天数 1–15 | 3 |
返回结果
typestring
daily
locationobject
定位信息
citystring
城市
longitudenumber
经度
latitudenumber
纬度
timezonestring
timezone
dailyobject
逐日温度、天气、生活指数等
statusstring
状态
astroarray
astro
datestring
date
sunriseobject
sunrise
sunsetobject
sunset
precipitation_08h_20harray
precipitation_08h_20h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
probabilitynumber
probability
precipitation_20h_32harray
precipitation_20h_32h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
probabilitynumber
probability
precipitationarray
precipitation
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
probabilitynumber
probability
temperaturearray
temperature
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
temperature_08h_20harray
temperature_08h_20h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
temperature_20h_32harray
temperature_20h_32h
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
windarray
wind
datestring
date
maxobject
max
minobject
min
avgobject
avg
wind_08h_20harray
wind_08h_20h
datestring
date
maxobject
max
minobject
min
avgobject
avg
wind_20h_32harray
wind_20h_32h
datestring
date
maxobject
max
minobject
min
avgobject
avg
humidityarray
humidity
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
cloudratearray
cloudrate
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
pressurearray
pressure
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
visibilityarray
visibility
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
dswrfarray
dswrf
datestring
date
maxnumber
max
minnumber
min
avgnumber
avg
air_qualityobject
air_quality
aqiarray
aqi
pm25array
pm25
skyconarray
skycon
datestring
date
valuestring
value
skycon_08h_20harray
skycon_08h_20h
datestring
date
valuestring
value
skycon_20h_32harray
skycon_20h_32h
datestring
date
valuestring
value
life_indexobject
life_index
ultravioletarray
ultraviolet
carWashingarray
carWashing
dressingarray
dressing
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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"
}请求示例
示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。
curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/weather"错误码
先看业务 code。HTTP 也可能不是 200。
0200
成功
4000400
参数错误
4011401
API Key 无效
4013403
API Key 已暂停
4014403
当前 IP 不在 Key 白名单
4015401
此接口需要 API Key
4022402
余额不足
4029429
调用过快（QPS）
4030429
今日免费额度已用完
4040503
接口已下线
4041404
接口不存在
5000500
服务器内部错误
5020502
上游暂时不可用
5021502
上游返回格式异常
5030502
暂无可用节点
| 业务码 | HTTP | 说明 |
|---|---|---|
| 0 | 200 | 成功 |
| 4000 | 400 | 参数错误 |
| 4011 | 401 | API Key 无效 |
| 4013 | 403 | API Key 已暂停 |
| 4014 | 403 | 当前 IP 不在 Key 白名单 |
| 4015 | 401 | 此接口需要 API Key |
| 4022 | 402 | 余额不足 |
| 4029 | 429 | 调用过快（QPS） |
| 4030 | 429 | 今日免费额度已用完 |
| 4040 | 503 | 接口已下线 |
| 4041 | 404 | 接口不存在 |
| 5000 | 500 | 服务器内部错误 |
| 5020 | 502 | 上游暂时不可用 |
| 5021 | 502 | 上游返回格式异常 |
| 5030 | 502 | 暂无可用节点 |
调用限制
- 计费模式
- 完全免费
- QPS 限制
- QPS 3
- 登录免费额度
- 2000 次（已认证）
- 匿名每日额度
- 100 次（无 API Key）
- 黄金会员
- 每天 50,000 次 · QPS 10
- 钻石会员
- 每天 100,000 次 · QPS 30
- 企业会员
- 每天 1,000,000 次 · QPS 120
| 计费模式 | 完全免费 |
|---|---|
| QPS 限制 | QPS 3 |
| 登录免费额度 | 2000 次（已认证） |
| 匿名每日额度 | 100 次（无 API Key） |
| 黄金会员 | 每天 50,000 次 · QPS 10 |
| 钻石会员 | 每天 100,000 次 · QPS 30 |
| 企业会员 | 每天 1,000,000 次 · QPS 120 |
购买套餐、看评价请走商城详情。 购买 / 调试
更新日志
- 1.0.02026-05-06
首次发布：5 种 type（realtime/minutely/hourly/daily/weather）+ 城市名直查 内置 ~140 个常用城市经纬度表 + Open-Meteo Geocoding 兜底（不依赖高德/百度 Key） 顶层 summary 实时摘要：skycon 中文化、风向 16 方位、风级蒲福分级、AQI 等级颜色 预警 alerts 标准化：自动提取颜色（蓝/黄/橙/红）和级别（一般/较重/严重/特别严重）