运行中免费热门生活服务

天气查询

API

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

接入文档

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

先试用，再接接口

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

打开天气查询

17万

累计调用

136ms

平均响应

100.00%

服务可用性

3,000 次/日

免费额度

访问限制

查看更多方案 →

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

QPS 3

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

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

无 Key 调用

每天 1,000 次 · QPS 2

登录免费

当前方案

每天 3,000 次 · QPS 3

黄金会员

每天 50,000 次 · QPS 10

钻石会员

每天 100,000 次 · QPS 30

企业会员

每天 1,000,000 次 · QPS 120

AI 文档

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

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=search&keyword=%E5%8C%97%E4%BA%AC&city=%E5%8C%97%E4%BA%AC&limit=5

接口信息备注

本地城市库模糊匹配（中文 / 拼音 / 首字母），返回 id 供实况或历史查询。文档示例为「北京」真实搜索。

请求参数说明

opstring

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

keyword（关键词）string

可选 · 搜索关键字；也可用 city 传同样含义 · 示例：北京

city（城市）string

可选 · 与 keyword 等价的别名参数 · 示例：北京

limit（条数）integer

可选 · 返回条数 1–50，默认 20 · 默认 20 · 示例：5

名称	类型	说明
op	string	必填 · 固定为 search · 默认 search · 示例：search
keyword（关键词）	string	可选 · 搜索关键字；也可用 city 传同样含义 · 示例：北京
city（城市）	string	可选 · 与 keyword 等价的别名参数 · 示例：北京
limit（条数）	integer	可选 · 返回条数 1–50，默认 20 · 默认 20 · 示例：5

请求头说明

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

返回字段说明

keywordstring

实际搜索词

countinteger

命中数量

citiesarray

城市列表：id / city_id / name / pinyin / parent

idnumber

city_idnumber

city_id

namestring

名称

pinyinstring

pinyin

parentstring

parent

tipsstring

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

名称

类型

说明

keyword

string

实际搜索词

count

integer

命中数量

cities

array

城市列表：id / city_id / name / pinyin / parent

id	number	id
city_id	number	city_id
name	string	名称
pinyin	string	pinyin
parent	string	parent

tips

string

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

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "keyword": "北京",
    "count": 3,
    "cities": [
      {
        "id": 33,
        "city_id": 2,
        "name": "北京市",
        "pinyin": "beijingshi",
        "parent": "北京市"
      },
      {
        "id": 600,
        "city_id": 3,
        "name": "北京市朝阳区",
        "pinyin": "beijingshichaoyangqu",
        "parent": "北京市"
      },
      {
        "id": 601,
        "city_id": 4,
        "name": "北京市通州区",
        "pinyin": "beijingshitongzhouqu",
        "parent": "北京市"
      }
    ],
    "_disclaimer": "数据由墨迹天气提供，仅供参考，不构成专业气象建议；不应用于农业、保险、航运、防灾等决策场景。详细免责声明见 marketplace 详情页。"
  },
  "request_id": "ms7yrw7h50851c03",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

string

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

keyword（关键词）

string

可选 · 搜索关键字；也可用 city 传同样含义 · 示例：北京

city（城市）

string

可选 · 与 keyword 等价的别名参数 · 示例：北京

limit（条数）

integer

可选 · 返回条数 1–50，默认 20 · 默认 20 · 示例：5

名称

类型

说明

Authorization

string

{ "code": 0, "msg": "成功", "data": { "keyword": "北京", "count": 3, "cities": [ { "id": 33, "city_id": 2, "name": "北京市", "pinyin": "beijingshi", "parent": "北京市" }, { "id": 600, "city_id": 3, "name": "北京市朝阳区", "pinyin": "beijingshichaoyangqu", "parent": "北京市" }, { "id": 601, "city_id": 4, "name": "北京市通州区", "pinyin": "beijingshitongzhouqu", "parent": "北京市" } ], "_disclaimer": "数据由墨迹天气提供，仅供参考，不构成专业气象建议；不应用于农业、保险、航运、防灾等决策场景。详细免责声明见 marketplace 详情页。" }, "request_id": "ms7yrw7h50851c03", "tips": "极数本源 · https://apizero.cn" }