天气查询

moji-weatherGET
GEThttps://v1.apizero.cn/api/moji-weather

概述

接入平台气象数据,支持全国 3 万+ 城市实况、历史天气、未来 7 天、24 小时趋势、AQI、9 项生活指数、气象预警及农历,一次调用全量返回。 支持 4 种查询模式: - ?city=北京 · 按城市名查实况(自动模糊匹配第一个) - ?id=33 · 按 internal_id 直查(跳过搜索,更快) - ?op=search&keyword=北京 · 仅搜索城市列表,拿 id - ?op=history&city=北京&day=2026-05-12 · 历史天气(支持单日 / 整月) 历史天气范围: - 当前月:返回 1 号至昨天的数据 - 历史月(≤ 上月):返回完整 30 天 - 建议查近 40 天以内,过早的月份可能无数据 服务端缓存策略: - 实况:5 分钟;历史·当月:30 分钟;历史·过去月:24 小时 注意:本接口气象数据由极数本源平台提供,仅供参考,不应用于农业、保险、航运、防灾等专业决策场景。 联系站长:apizero.cn

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/moji-weather/raw.md
打开 Markdown

鉴权

匿名可调(每日 100 次、QPS 5);登录后每日 30 次免费、QPS 5。

获取 API Key

请求头

Authorizationstring选填

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

实况天气(推荐)

GETURL QUERY·APPLICATION/JSON

缺省模式:按城市名或 internal_id 查询实况,返回实况/未来7天/24h/AQI/预警/生活指数。city 与 id 二选一。文档示例为北京真实抓取(预报序列已截断)。

https://v1.apizero.cn/api/moji-weather?city=%E5%8C%97%E4%BA%AC&id=33

city(城市)string选填

城市中文名(如「北京」「杭州」);与 id 二选一

例北京

idinteger选填

城市 internal_id(可先调城市搜索);与 city 二选一

例33

返回结果

cityobject

城市信息:id / name / parent / pinyin / timezone

idnumber

id

namestring

名称

briefstring

brief

parentstring

parent

pinyinstring

pinyin

timezonenumber

timezone

conditionobject

实况:温度、体感、湿度、气压、风力风向、紫外线、日出日落等

iconnumber

icon

conditionstring

condition

temperaturenumber

temperature

real_feelnumber

real_feel

humiditynumber

humidity

pressurenumber

pressure

wind_levelnumber

wind_level

wind_dirstring

wind_dir

uvistring

uvi

sun_risenumber

sun_rise

sun_setnumber

sun_set

lunar_datestring

lunar_date

dew_pointnumber

dew_point

updatetimenumber

updatetime

tipsstring

tips

wind_speednumber

wind_speed

special_weathernumber

special_weather

wind_speedsnumber

wind_speeds

is_portnumber

is_port

warn_iconstring

warn_icon

warn_titlestring

warn_title

warn_descstring

warn_desc

warn_urlstring

warn_url

weather_pushstring

weather_push

aqiobject

空气质量指数与等级

valuenumber

value

levelnumber

level

descriptionstring

description

updatetimenumber

updatetime

forecast_dayarray

未来约 7 天逐日预报

condition_id_daynumber

condition_id_day

condition_id_nightnumber

condition_id_night

condition_daystring

condition_day

condition_nightstring

condition_night

temp_daynumber

temp_day

temp_nightnumber

temp_night

icon_daystring

icon_day

icon_nightstring

icon_night

wind_dir_daystring

wind_dir_day

wind_dir_nightstring

wind_dir_night

sun_risenumber

sun_rise

sun_setnumber

sun_set

predict_datenumber

predict_date

wind_level_daynumber

wind_level_day

wind_level_nightnumber

wind_level_night

wind_speed_day_realnumber

wind_speed_day_real

wind_speed_night_realnumber

wind_speed_night_real

lunar_datestring

lunar_date

aqi_desc_shortstring

aqi_desc_short

aqi_levelnumber

aqi_level

aqi_valuenumber

aqi_value

aqi_descstring

aqi_desc

uvistring

uvi

humiditynumber

humidity

forecast_hourarray

未来约 24 小时逐时预报

conditionstring

condition

temperaturenumber

temperature

real_feelnumber

real_feel

humiditynumber

humidity

wind_speedstring

wind_speed

wind_dirstring

wind_dir

wind_levelstring

wind_level

predict_hournumber

predict_hour

aqi_valuenumber

aqi_value

aqi_levelnumber

aqi_level

aqi_descstring

aqi_desc

comfort_tipstring

comfort_tip

wind_textstring

wind_text

comfort_tip_2string

comfort_tip_2

uvi_textstring

uvi_text

indexarray

生活指数(穿衣、运动等)

namestring

名称

statusstring

状态

levelnumber

level

urlstring

地址

descstring

说明

extrastring

extra

typenumber

类型

alertarray

气象预警列表

alert[]string

alert 的一项

summarystring

一句话天气摘要

tipsstring

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

{
  "code": 0,
  "msg": "成功",
  "data": {
    "city": {
      "id": 33,
      "name": "北京市",
      "brief": "北京市",
      "parent": "北京市",
      "pinyin": "beijingshi",
      "timezone": 8
    },
    "condition": {
      "icon": 31,
      "condition": "多云",
      "temperature": 27,
      "real_feel": 30,
      "humidity": 88,
      "pressure": 999,
      "wind_level": 3,
      "wind_dir": "南风",
      "uvi": "最弱",
      "sun_rise": 1785445920000,
      "sun_set": 1785497400000,
      "lunar_date": "丙午年六月十八",
      "dew_point": 23,
      "updatetime": 1785441252000,
      "tips": "今天有雨||今天有雨,略微偏热,注意衣物变化。",
      "wind_speed": 3,
      "special_weather": 1,
      "wind_speeds": 3.69,
      "is_port": 0,
      "warn_icon": "",
      "warn_title": "",
      "warn_desc": "",
      "warn_url": "",
      "weather_push": "北京市,今天雷阵雨☔,24~32℃,西南风2级,空气 优,这两天空气都不错。雷雨天气,出行注意安全。",
      "condition_id": 82,
      "wind_direction_id": 9,
      "weather_code": 2,
      "bg_code": 2,
      "warn_id": 0,
      "comfort_id": 6
    },
    "aqi": {
      "value": 36,
      "level": 1,
      "description": "优",
      "updatetime": 1785438000000
    },
    "forecast_day": [
      {
        "condition_id_day": 4,
        "condition_id_night": 31,
        "condition_day": "雷阵雨",
        "condition_night": "多云",
        "temp_day": 33,
        "temp_night": 26,
        "icon_day": "3",
        "icon_night": "3",
        "wind_dir_day": "南风",
        "wind_dir_night": "南风",
        "sun_rise": 1785359460000,
        "sun_set": 1785411060000,
        "predict_date": 1785340830000,
        "wind_level_day": 4,
        "wind_level_night": 4,
        "wind_speed_day_real": 4.4,
        "wind_speed_night_real": 4.4,
        "lunar_date": "丙午年六月十七",
        "aqi_desc_short": "优",
        "aqi_level": 1,
        "aqi_value": 32,
        "aqi_desc": "优",
        "uvi": "中等",
        "humidity": 61,
        "pressure": 1003
      },
      {
        "condition_id_day": 4,
        "condition_id_night": 4,
        "condition_day": "雷阵雨",
        "condition_night": "雷阵雨",
        "temp_day": 32,
        "temp_night": 24,
        "icon_day": "2",
        "icon_night": "2",
        "wind_dir_day": "南风",
        "wind_dir_night": "西南风",
        "sun_rise": 1785445920000,
        "sun_set": 1785497400000,
        "predict_date": 1785427230000,
        "wind_level_day": 2,
        "wind_level_night": 2,
        "wind_speed_day_real": 2.4,
        "wind_speed_night_real": 2.4,
        "lunar_date": "丙午年六月十八",
        "aqi_desc_short": "优",
        "aqi_level": 1,
        "aqi_value": 36,
        "aqi_desc": "优",
        "uvi": "弱",
        "humidity": 75,
        "pressure": 1002
      },
      {
        "condition_id_day": 4,
        "condition_id_night": 4,
        "condition_day": "雷阵雨",
        "condition_night": "雷阵雨",
        "temp_day": 32,
        "temp_night": 25,
        "icon_day": "2",
        "icon_night": "1",
        "wind_dir_day": "南风",
        "wind_dir_night": "东南风",
        "sun_rise": 1785532380000,
        "sun_set": 1785583740000,
        "predict_date": 1785513630000,
        "wind_level_day": 2,
        "wind_level_night": 0,
        "wind_speed_day_real": 2.4,
        "wind_speed_night_real": 0.9,
        "lunar_date": "丙午年六月十九",
        "aqi_desc_short": "良",
        "aqi_level": 2,
        "aqi_value": 60,
        "aqi_desc": "良",
        "uvi": "弱",
        "humidity": 77,
        "pressure": 1001
      }
    ],
    "forecast_hour": [
      {
        "condition": "多云",
        "temperature": 27,
        "real_feel": 29,
        "humidity": 88,
        "wind_speed": "10.116",
        "wind_dir": "南风",
        "wind_level": "0",
        "predict_hour": 1785438000000,
        "aqi_value": 36,
        "aqi_level": 1,
        "aqi_desc": "优",
        "comfort_tip": "潮湿",
        "wind_text": "微风",
        "comfort_tip_2": "适宜",
        "uvi_text": "较低"
      },
      {
        "condition": "多云",
        "temperature": 27,
        "real_feel": 29,
        "humidity": 88,
        "wind_speed": "13",
        "wind_dir": "南风",
        "wind_level": "0",
        "predict_hour": 1785441600000,
        "aqi_value": 38,
        "aqi_level": 1,
        "aqi_desc": "优",
        "comfort_tip": "潮湿",
        "wind_text": "微风",
        "comfort_tip_2": "适宜",
        "uvi_text": "较低"
      },
      {
        "condition": "多云",
        "temperature": 26,
        "real_feel": 29,
        "humidity": 89,
        "wind_speed": "7.2",
        "wind_dir": "南风",
        "wind_level": "0",
        "predict_hour": 1785445200000,
        "aqi_value": 41,
        "aqi_level": 1,
        "aqi_desc": "优",
        "comfort_tip": "潮湿",
        "wind_text": "微风",
        "comfort_tip_2": "适宜",
        "uvi_text": "较低"
      }
    ],
    "index": [
      {
        "name": "限行",
        "status": "尾号",
        "level": 1,
        "url": "$1/?indexid=1&cityid=33&appshare=1",
        "desc": "",
        "extra": "5, 0",
        "type": 0
      },
      {
        "name": "六月十八",
        "status": "万年历",
        "level": 2,
        "url": "https://html5.moji.com/nb/wnlh5/index.html?channel=speed",
        "desc": "$0/index/lunar_v6.png",
        "extra": "",
        "type": 0
      },
      {
        "name": "闷热",
        "status": "穿衣",
        "level": 20,
        "url": "$1/?indexid=20&cityid=33&appshare=1",
        "desc": "$0/index/dress_v6.png",
        "extra": "潮湿闷热,衣物排汗透气,手帕擦汗环保时尚,不建议在露天场所逛街。",
        "type": 2
      }
    ],
    "alert": [],
    "updatetime": 1785443154731,
    "summary": "北京市,多云,27℃,南风3级,空气优。",
    "_cached": true,
    "_disclaimer": "数据由墨迹天气提供,仅供参考,不构成专业气象建议;不应用于农业、保险、航运、防灾等决策场景。详细免责声明见 marketplace 详情页。"
  },
  "request_id": "ms7yrw773bba2d1a",
  "tips": "极数本源 · https://apizero.cn"
}

历史天气

GETURL QUERY·APPLICATION/JSON

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

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

opstring必填

固定为 history

例history

city(城市)string选填

城市中文名;与 id 二选一

例北京

idinteger选填

城市 internal_id;与 city 二选一

例33

daystring选填

单日:YYYY-MM-DD;或 MM-DD / DD(需配合 month)

例2026-05-10

monthstring选填

整月 YYYYMM;不传 day/month 时默认当前月

例202605

返回结果

modestring

固定 history

cityobject

城市信息

idnumber

id

namestring

名称

parentstring

parent

pinyinstring

pinyin

daystring

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

monthstring

所属月份 YYYYMM

itemobject

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

datestring

date

datetimenumber

datetime

conditionstring

condition

temp_highnumber

temp_high

temp_lownumber

temp_low

wind_dirstring

wind_dir

wind_levelstring

wind_level

aqi_valuenumber

aqi_value

aqi_levelnumber

aqi_level

aqi_descstring

aqi_desc

iconstring

icon

itemsarray

整月查询时的逐日列表

items[]string

items 的一项

summarystring

单日一句话摘要

tipsstring

品牌提示(所有接口统一返回):极数本源 · 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"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/moji-weather?city=%E5%A4%A7%E5%8C%96&id=1205&op=history&keyword=%E5%A4%A7%E5%8C%96&limit=10&day=2026-05-12&month=202604"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快(QPS)

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
完全免费
QPS 限制
QPS 3
登录免费额度
3000 次(已认证)
匿名每日额度
1000 次(无 API Key)
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.1.02026-05-15

    【重大功能】新增 op=history:查过去某一天/整月的真实历史天气 支持 day=YYYY-MM-DD 单日查询,自动推月份 支持 month=YYYYMM 整月查询;当前月返回 1 号 ~ 昨天,历史月返回完整 30 天 返回字段:当日天气描述 / 高低温 / 风向风力 / AQI;整月还含去年同期、最好/最差空气日 服务端按月缓存:当前月 30 分钟、历史月 24 小时 服务能查到的最早日期约今天往前 40 天

  • 1.0.02026-05-14

    首次上线 支持城市名 / internal_id / 拼音 / 拼音首字母 检索 实况一次返回:当前天气 + 未来 7 天 + 24 小时 + AQI + 9 项生活指数 + 气象预警 + 农历 服务端 5 分钟缓存,device UID 复用