腾讯天气

API

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

接入文档

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

先试用，再接接口

不用写代码。打开工具页跑一遍腾讯天气，看清结果再来订阅。

打开腾讯天气

累计调用

174ms

平均响应

100.00%

服务可用性

1,000 次/日

免费额度

访问限制

查看更多方案 →

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

QPS 3

今日已用 … / 1,000 次/日…

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

无 Key 调用

每天 500 次 · QPS 2

登录免费

当前方案

每天 1,000 次 · QPS 3

黄金会员

每天 50,000 次 · QPS 10

钻石会员

每天 100,000 次 · QPS 30

企业会员

每天 1,000,000 次 · QPS 120

AI 文档

把这个地址发给 AI，就能生成调用代码

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

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

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

请求头说明

Authorizationstring

可选 · 推荐：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_ 形态时生效）。匿名可不传，受每日免费额度限制。

返回字段说明

locationobject

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

provincestring

province

citystring

城市

countystring

county

observeobject

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

weatherstring

weather

temperaturenumber

temperature

humiditynumber

humidity

wind_directionstring

wind_direction

wind_powerstring

wind_power

update_timestring

update_time

airobject

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

aqinumber

aqi

levelnumber

level

qualitystring

清晰度

pm25number

pm25

pm10number

pm10

daily_forecastarray

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

datestring

date

temperatureobject

temperature

minnumber

min

maxnumber

max

hourly_forecastarray

未来 24 小时逐时预报

timestring

时间

temperaturenumber

temperature

weatherstring

weather

life_indexarray

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

keystring

key

namestring

名称

levelstring

level

detailstring

detail

sunrise_sunsetarray

未来数日日出日落时间

datestring

date

sunrisestring

sunrise

sunsetstring

sunset

alarmarray

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

alarm[]string

alarm 的一项

limitobject

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

tail_numberstring

tail_number

datestring

date

tipsstring

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

名称

类型

说明

location

object

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

province	string	province
city	string	城市
county	string	county

observe

object

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

weather	string	weather
temperature	number	temperature
humidity	number	humidity
wind_direction	string	wind_direction
wind_power	string	wind_power
update_time	string	update_time

air

object

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

aqi	number	aqi
level	number	level
quality	string	清晰度
pm25	number	pm25
pm10	number	pm10

daily_forecast

array

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

date

string

date

temperature

object

temperature

min	number	min
max	number	max

hourly_forecast

array

未来 24 小时逐时预报

time	string	时间
temperature	number	temperature
weather	string	weather

life_index

array

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

key	string	key
name	string	名称
level	string	level
detail	string	detail

sunrise_sunset

array

未来数日日出日落时间

date	string	date
sunrise	string	sunrise
sunset	string	sunset

alarm

array

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

alarm[]

string

alarm 的一项

limit

object

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

tail_number	string	tail_number
date	string	date

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

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