加载接口文档…
2.3M
累计调用
245ms
平均响应
99.47%
服务可用性
2,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 100 次 · QPS 2
登录免费
当前方案每日 2,000 次 · QPS 10
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/weather/raw.md接口请求地址
https://v1.apizero.cn/api/weather
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/weather?type=hourly&city=%E5%8C%97%E4%BA%AC&hours=6
接口信息备注
最长 360 小时（15 天）逐小时预报。可用 hours 控制返回长度。示例为北京真实抓取（序列已截断）。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| type | string | 必填 · 固定为 hourly · 示例：hourly |
| city | string | 可选 · 城市名 · 示例：北京 |
| hours | integer | 可选 · 返回小时数，1–360 · 默认 24 · 示例：6 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| 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"
}