腾讯天气

API

腾讯天气官方数据源，中文省市名直接查询全国天气，无需经纬度。输入省 + 市（可选区县）即可获取：实时天气、空气质量（AQI/PM2.5/PM10）、未来 7 天预报、24 小时逐时预报、23 项生活指数、日出日落与机动车限行信息。数据来自腾讯天气，权威稳定。完全免费：未登录每日…

文档

由腾讯天气提供·更新于昨天

459

累计调用

134ms

平均响应

100.00%

服务可用性

1,000 次/日

免费额度

访问限制

查看更多方案 →

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

QPS 10

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

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

无 Key 调用

每日 500 次 · QPS 5

登录免费

当前方案

每日 1,000 次 · QPS 10

黄金会员

每日 50,000 次 · QPS 60

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

https://apizero.cn/aidocs/tencent-weather/raw.md

接口请求地址

https://v1.apizero.cn/api/tencent-weather

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/tencent-weather

接口信息备注

完全免费。未登录每日 500 次；携带 API Key（Authorization: Bearer <key>）登录用户每日 1000 次。

请求参数说明

名称	类型	说明
province	string	必填 · 省 / 直辖市（中文名） · 示例：广东
city	string	必填 · 市（中文名） · 示例：深圳
county	string	可选 · 区 / 县（中文名），可提升定位精度与限行准确度 · 示例：南山

请求头说明

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

返回字段说明

名称	类型	说明
location	object	查询位置 { province, city, county? }
observe	object	实时天气（weather/temperature/humidity/wind_direction/wind_power/update_time 等）
air	object	空气质量（aqi/level/quality/pm25/pm10/so2/no2/o3/co）
daily_forecast	array	未来 7 天预报（含昼夜天气、风向风力、最高/最低温）
hourly_forecast	array	未来 24 小时逐时预报
life_index	array	生活指数（穿衣/舒适/感冒/运动/紫外线等 23 项）
sunrise_sunset	array	未来数日日出日落时间
alarm	array	气象预警列表（无预警时为空数组）
limit	object	机动车尾号限行（无则为 null）
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "location": {
      "province": "广东",
      "city": "深圳",
      "county": "南山"
    },
    "observe": {
      "weather": "多云",
      "temperature": 30,
      "humidity": 77,
      "wind_direction": "北风",
      "wind_power": "3-4",
      "update_time": "2026-07-01 10:15"
    },
    "air": {
      "aqi": 13,
      "level": 1,
      "quality": "优",
      "pm25": 4,
      "pm10": 12
    },
    "daily_forecast": [
      {
        "date": "2026-07-01",
        "temperature": {
          "min": 26,
          "max": 33
        }
      }
    ],
    "hourly_forecast": [
      {
        "time": "07-01 10:00",
        "temperature": 30,
        "weather": "多云"
      }
    ],
    "life_index": [
      {
        "key": "clothes",
        "name": "穿衣",
        "level": "炎热",
        "detail": "..."
      }
    ],
    "sunrise_sunset": [
      {
        "date": "2026-07-01",
        "sunrise": "05:43",
        "sunset": "19:12"
      }
    ],
    "alarm": [],
    "limit": {
      "tail_number": "3和8",
      "date": "2026-07-01"
    }
  },
  "request_id": "abc123",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

province

string

必填 · 省 / 直辖市（中文名） · 示例：广东

city

string

必填 · 市（中文名） · 示例：深圳

county

string

可选 · 区 / 县（中文名），可提升定位精度与限行准确度 · 示例：南山

名称

类型

说明

Authorization

string

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

名称

类型

说明

location

object

查询位置 { province, city, county? }

observe

object

实时天气（weather/temperature/humidity/wind_direction/wind_power/update_time 等）

air

object

空气质量（aqi/level/quality/pm25/pm10/so2/no2/o3/co）

daily_forecast

array

未来 7 天预报（含昼夜天气、风向风力、最高/最低温）

hourly_forecast

array

未来 24 小时逐时预报

life_index

array

生活指数（穿衣/舒适/感冒/运动/紫外线等 23 项）

sunrise_sunset

array

未来数日日出日落时间

alarm

array

气象预警列表（无预警时为空数组）

limit

object

机动车尾号限行（无则为 null）

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{ "code": 0, "msg": "成功", "data": { "location": { "province": "广东", "city": "深圳", "county": "南山" }, "observe": { "weather": "多云", "temperature": 30, "humidity": 77, "wind_direction": "北风", "wind_power": "3-4", "update_time": "2026-07-01 10:15" }, "air": { "aqi": 13, "level": 1, "quality": "优", "pm25": 4, "pm10": 12 }, "daily_forecast": [ { "date": "2026-07-01", "temperature": { "min": 26, "max": 33 } } ], "hourly_forecast": [ { "time": "07-01 10:00", "temperature": 30, "weather": "多云" } ], "life_index": [ { "key": "clothes", "name": "穿衣", "level": "炎热", "detail": "..." } ], "sunrise_sunset": [ { "date": "2026-07-01", "sunrise": "05:43", "sunset": "19:12" } ], "alarm": [], "limit": { "tail_number": "3和8", "date": "2026-07-01" } }, "request_id": "abc123", "tips": "极数本源 · https://apizero.cn" }