8.2M
累计调用
131ms
平均响应
100.00%
服务可用性
20 次/日
免费额度
未携带 API Key
每天 5 次 · QPS 2
已登录(未开通会员)
每天 20 次 · QPS 3
免费试用
一次性 5 次
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 60
最长 360 小时(15 天)逐小时预报。可用 hours 控制返回长度。示例为北京真实抓取(序列已截断)。
必填 · 固定为 hourly · 示例:hourly
可选 · 城市名 · 示例:北京
可选 · 返回小时数,1–360 · 默认 24 · 示例:6
| 名称 | 类型 | 说明 |
|---|---|---|
| type(类型) | string | 必填 · 固定为 hourly · 示例:hourly |
| city(城市) | string | 可选 · 城市名 · 示例:北京 |
| hours(小时数) | integer | 可选 · 返回小时数,1–360 · 默认 24 · 示例:6 |
可选 · 推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。匿名可不传,受每日免费额度限制。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。匿名可不传,受每日免费额度限制。 |
hourly
定位信息
城市或地区名
经度,十进制度
纬度,十进制度
时区,IANA 名称,如 Asia/Shanghai
逐小时温度、降水、天气现象等
这一段数据的状态,ok 表示成功
接下来天气怎么变的一句话,例如几点转雨
逐小时降水。value 是强度(默认公制 mm/h),probability 是概率 0–100
这条记录的时刻,ISO8601,带时区
该小时降水强度。默认公制是 mm/h
降水概率,0–100,单位是百分数
逐小时地表 2 米气温,℃
这条记录的时刻,ISO8601,带时区
该小时气温,℃
逐小时体感温度,℃
这条记录的时刻,ISO8601,带时区
该小时体感温度,℃
逐小时地表 10 米风。speed 是风速,默认公制 km/h,不是 m/s;direction 是从正北顺时针的角度
这条记录的时刻,ISO8601,带时区
风速。默认公制是 km/h,不是 m/s
风向角度,从正北起顺时针,0–360
逐小时相对湿度,0–1。0.81 即 81%,不是百分数
这条记录的时刻,ISO8601,带时区
该小时相对湿度,0–1(0.81 即 81%,不是百分数)
逐小时总云量,0–1。0.29 大约是三成云
这条记录的时刻,ISO8601,带时区
该小时云量,0–1
逐小时天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾
这条记录的时刻,ISO8601,带时区
该时刻的天气现象代码,取值见 skycon
逐小时地面气压,Pa
这条记录的时刻,ISO8601,带时区
该小时地面气压,Pa
逐小时水平能见度,km
这条记录的时刻,ISO8601,带时区
该小时水平能见度,km
逐小时向下短波辐射通量,W/m²。夜里通常是 0
这条记录的时刻,ISO8601,带时区
该小时向下短波辐射通量,W/m²
空气质量
逐小时空气质量指数。value 里 chn 是国标,usa 是美标
逐小时 PM2.5 浓度,μg/m³
品牌提示(所有接口统一返回):极数本源 · 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"
}