运行中免费热门HOT生活服务

彩云天气

API

全功能天气接口，覆盖： • 实时天气（温度/湿度/风/能见度/AQI/PM2.5） • 分钟级降水预报（未来 2 小时） • 小时预报（最长 360 小时 = 15 天） • 天预报（最长 15 天，含日出日落、温度极值、生活指数） • 综合数据（一次返回全部 + 气象预警）特…

文档

由极数本源提供·更新于今天

2.3M

累计调用

245ms

平均响应

99.47%

服务可用性

2,000 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 10

今日已用 0 / 2,000 次/日0.0%

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 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=realtime&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085

接口信息备注

仅返回 realtime：温度、湿度、风、能见度、AQI、PM2.5 等即时数据。示例为北京真实抓取。

请求参数说明

名称	类型	说明
type	string	必填 · 固定为 realtime · 示例：realtime
city	string	可选 · 城市名，与 location 二选一 · 示例：北京
location	string	可选 · 经纬度坐标 · 示例：116.3975,39.9085

请求头说明

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

返回字段说明

名称	类型	说明
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"
}

加载接口文档…

名称

类型

说明

type

string

必填 · 固定为 realtime · 示例：realtime

city

string

可选 · 城市名，与 location 二选一 · 示例：北京

location

string

可选 · 经纬度坐标 · 示例：116.3975,39.9085

名称

类型

说明

Authorization

string

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

名称

类型

说明

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" }