天气查询

API

接入平台气象数据，支持全国 3 万+ 城市实况、历史天气、未来 7 天、24 小时趋势、AQI、9 项生活指数、气象预警及农历，一次调用全量返回。支持 4 种查询模式： - ?city=北京 · 按城市名查实况（自动模糊匹配第一个） - ?id=33 · 按 internal …

文档

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

1.6万

累计调用

150ms

平均响应

99.45%

服务可用性

3,000 次/日

免费额度

访问限制

查看更多方案 →

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

QPS 5

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

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

无 Key 调用

每日 1,000 次 · QPS 5

登录免费

当前方案

每日 3,000 次 · QPS 5

黄金会员

每日 50,000 次 · QPS 60

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

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

接口请求地址

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

接口请求方式

GET

请求参数格式

URL QUERY

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/moji-weather?op=history&city=%E5%8C%97%E4%BA%AC&id=33&day=2026-05-10&month=202605

接口信息备注

查询已过去日期的真实历史天气。可传 day=YYYY-MM-DD 查单日，或 month=YYYYMM 查整月（当前月为 1 号至昨天）。city 与 id 二选一。文档示例为北京 2026-05-10。

请求参数说明

名称	类型	说明
op	string	必填 · 固定为 history · 默认 history · 示例：history
city	string	可选 · 城市中文名；与 id 二选一 · 示例：北京
id	integer	可选 · 城市 internal_id；与 city 二选一 · 示例：33
day	string	可选 · 单日：YYYY-MM-DD；或 MM-DD / DD（需配合 month） · 示例：2026-05-10
month	string	可选 · 整月 YYYYMM；不传 day/month 时默认当前月 · 示例：202605

请求头说明

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

返回字段说明

名称	类型	说明
mode	string	固定 history
city	object	城市信息
day	string	单日查询时的日期 YYYY-MM-DD
month	string	所属月份 YYYYMM
item	object	单日详情：气温、天气、风力、AQI 等
items	array	整月查询时的逐日列表
summary	string	单日一句话摘要
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "mode": "history",
    "city": {
      "id": 33,
      "name": "北京市",
      "parent": "北京市",
      "pinyin": "beijingshi"
    },
    "day": "2026-05-10",
    "month": "202605",
    "item": {
      "date": "2026-05-10",
      "datetime": 1778342400000,
      "condition": "多云",
      "temp_high": 33,
      "temp_low": 15,
      "wind_dir": "西北风",
      "wind_level": "3",
      "aqi_value": 56,
      "aqi_level": 2,
      "aqi_desc": "良",
      "icon": null
    },
    "summary": "北京市 2026-05-10，多云，15~33℃，西北风3级，AQI 56（良）。",
    "_cached": true,
    "_disclaimer": "数据由墨迹天气提供，仅供参考，不构成专业气象建议；不应用于农业、保险、航运、防灾等决策场景。详细免责声明见 marketplace 详情页。"
  },
  "request_id": "ms7yrw7p669da58e",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

string

必填 · 固定为 history · 默认 history · 示例：history

city

string

可选 · 城市中文名；与 id 二选一 · 示例：北京

integer

可选 · 城市 internal_id；与 city 二选一 · 示例：33

day

string

可选 · 单日：YYYY-MM-DD；或 MM-DD / DD（需配合 month） · 示例：2026-05-10

month

string

可选 · 整月 YYYYMM；不传 day/month 时默认当前月 · 示例：202605

名称

类型

说明

Authorization

string

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

名称

类型

说明

mode

string

固定 history

city

object

城市信息

day

string

单日查询时的日期 YYYY-MM-DD

month

string

所属月份 YYYYMM

item

object

单日详情：气温、天气、风力、AQI 等

items

array

整月查询时的逐日列表

summary

string

单日一句话摘要

tips

string

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

{ "code": 0, "msg": "成功", "data": { "mode": "history", "city": { "id": 33, "name": "北京市", "parent": "北京市", "pinyin": "beijingshi" }, "day": "2026-05-10", "month": "202605", "item": { "date": "2026-05-10", "datetime": 1778342400000, "condition": "多云", "temp_high": 33, "temp_low": 15, "wind_dir": "西北风", "wind_level": "3", "aqi_value": 56, "aqi_level": 2, "aqi_desc": "良", "icon": null }, "summary": "北京市 2026-05-10，多云，15~33℃，西北风3级，AQI 56（良）。", "_cached": true, "_disclaimer": "数据由墨迹天气提供，仅供参考，不构成专业气象建议；不应用于农业、保险、航运、防灾等决策场景。详细免责声明见 marketplace 详情页。" }, "request_id": "ms7yrw7p669da58e", "tips": "极数本源 · https://apizero.cn" }