Query Weather

Completely free weather API with no registration required. Supports both domestic and international cities. Query by city name (Chinese or English) or by Adcode, or skip both parameters and let the API auto-locate by client IP. Returns full meteorological data — temperature, humidity, wind direction and force — with optional extended fields (apparent temperature, visibility, pressure, UV, air quality and pollutant breakdown), 18 lifestyle indices, up to 7 days of daily forecast, hourly forecasts (24 hours), and minute-level precipitation forecasts. JSON response with millisecond-level latency. Suitable for weather apps, travel planning, smart home systems, agricultural monitoring, and similar scenarios. · Weather forecast apps, travel planning tools, smart home systems, agricultural monitoring, logistics dispatch, outdoor activity reminders, travel apps, and mini-program weather features. · Query Weather

free weather API, weather lookup endpoint, real-time weather API, city weather forecast, meteorological data API, weather forecast endpoint, city code API, temperature lookup API, no-registration weather API, public weather endpoint, free weather API calls, apparent temperature API, air quality index, lifestyle index API, UV index, multi-day weather forecast, 7-day forecast API, hourly forecast API, minute-level precipitation API, international city weather, air pollutants API

GET /misc/weather - Query Weather

Checking the weather before heading out is always a good habit. This endpoint provides accurate, real-time weather data for both domestic and international cities.

Overview

Three query modes are supported:

- Pass adcode to query by administrative district code (highest priority).

- Pass city to query by city name. Both Chinese (北京) and English (Tokyo) are accepted.

- Pass neither and the API will auto-locate using the client IP.

The lang parameter accepts zh (default) and en. City-name translations cover 7000+ cities.

Optional modules

- extended=true: extended meteorological fields (apparent temperature, visibility, pressure, UV, air quality, and pollutant breakdown).

- forecast=true: multi-day forecast (up to 7 days), with daily high/low temperature, sunrise/sunset, wind speed, and other detailed data.

- hourly=true: hourly forecast (24 hours).

- minutely=true: minute-level precipitation forecast (domestic cities only, 2-minute resolution).

- indices=true: 18 lifestyle indices (clothing, UV, car wash, sports, pollen, and more).

Notes on the weather field

weather is a free-form weather description, not a fixed enum.

Common Chinese values returned by the API include: 晴 (sunny), 多云 (cloudy), 阴 (overcast), 小雨 (light rain), 中雨 (moderate rain), 大雨 (heavy rain), 雷阵雨 (thunderstorm), 小雪 (light snow), 中雪 (moderate snow), 大雪 (heavy snow), 雨夹雪 (sleet), 雾 (fog), 霾 (haze), 沙尘 (sand).

If your application needs a stable weather classification, map against weathercode instead. See the weather icon code table for all possible values.

Misc

Query Weather

0calls

2 credits / call

Checking the weather before heading out is always a good habit. This endpoint provides accurate, real-time weather data for both domestic and international cities.

Overview

Three query modes are supported:

Pass adcode to query by administrative district code (highest priority).
Pass city to query by city name. Both Chinese (北京) and English (Tokyo) are accepted.
Pass neither and the API will auto-locate using the client IP.

The lang parameter accepts zh (default) and en. City-name translations cover 7000+ cities.

Optional modules

extended=true: extended meteorological fields (apparent temperature, visibility, pressure, UV, air quality, and pollutant breakdown).
forecast=true: multi-day forecast (up to 7 days), with daily high/low temperature, sunrise/sunset, wind speed, and other detailed data.
hourly=true: hourly forecast (24 hours).
minutely=true: minute-level precipitation forecast (domestic cities only, 2-minute resolution).
indices=true: 18 lifestyle indices (clothing, UV, car wash, sports, pollen, and more).

Notes on the weather field

weather is a free-form weather description, not a fixed enum.

If your application needs a stable weather classification, map against weather_code instead. See the weather icon code table for all possible values.

Query parameters

city

stringoptional

City name. Accepts both Chinese (北京) and English (Tokyo). Optional — when omitted, the API attempts to auto-locate by IP.

adcode

stringoptional

Administrative district code (e.g. 110000). Higher priority than city. Optional — when omitted, the API attempts to auto-locate by IP.

extended

booleanoptional

Return extended meteorological fields (apparent temperature, visibility, pressure, UV, precipitation, cloud cover, air quality index, and pollutant breakdown).

forecast

booleanoptional

Return multi-day forecast data (up to 7 days), including daily high and low temperatures, day/night weather, wind direction and force, sunrise/sunset, and more.

hourly

booleanoptional

Return an hourly forecast (24 hours), including temperature, weather, wind direction and speed, humidity, precipitation probability, and more.

minutely

booleanoptional

Return minute-level precipitation forecast (domestic cities only), 2-minute resolution.

indices

booleanoptional

Return 18 lifestyle indices (clothing, UV, car wash, drying, AC, cold-and-flu, sports, comfort, travel, fishing, allergy, sun protection, mood, beer, umbrella, traffic, air purifier, pollen).

lang

stringoptional

Response language. zh returns Chinese (default), en returns English. City-name translations cover 7000+ cities. Lifestyle indices (indices) currently support Chinese only.

Name	Type	Attributes	Description
`city`	string	optional	City name. Accepts both Chinese (`北京`) and English (`Tokyo`). Optional — when omitted, the API attempts to auto-locate by IP.
`adcode`	string	optional	Administrative district code (e.g. `110000`). Higher priority than `city`. Optional — when omitted, the API attempts to auto-locate by IP.
`extended`	boolean	optional	Return extended meteorological fields (apparent temperature, visibility, pressure, UV, precipitation, cloud cover, air quality index, and pollutant breakdown).
`forecast`	boolean	optional	Return multi-day forecast data (up to 7 days), including daily high and low temperatures, day/night weather, wind direction and force, sunrise/sunset, and more.
`hourly`	boolean	optional	Return an hourly forecast (24 hours), including temperature, weather, wind direction and speed, humidity, precipitation probability, and more.
`minutely`	boolean	optional	Return minute-level precipitation forecast (domestic cities only), 2-minute resolution.
`indices`	boolean	optional	Return 18 lifestyle indices (clothing, UV, car wash, drying, AC, cold-and-flu, sports, comfort, travel, fishing, allergy, sun protection, mood, beer, umbrella, traffic, air purifier, pollen).
`lang`	string	optional	Response language. `zh` returns Chinese (default), `en` returns English. City-name translations cover 7000+ cities. Lifestyle indices (`indices`) currently support Chinese only.

Response

200 / OK

Lookup succeeded. Returns the real-time weather for the area.

JSON

400 / Bad Request

Invalid parameter. Common causes: malformed adcode, invalid lang (only zh/en are supported), wrong parameter type, or invalid parameter combination.

JSON

404 / Not Found

City not found.

JSON

500 / Internal Server Error

Internal server error.

JSON

503 / Service Unavailable

Weather service temporarily unavailable.

JSON

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/misc/weather'

Frequently asked questions

Is this weather API free?

Yes. The endpoint is completely free to use, with no registration or API key required. It is suitable for both personal and commercial projects.

Which cities are supported?

Both domestic Chinese cities and international cities. Domestic coverage spans 3000+ cities (province / city / district level); international cities are also widely supported. You can query by Chinese city name, English city name, or `adcode`.

Can I omit both `city` and `adcode`?

Yes. When neither parameter is provided, the API auto-locates by client IP and returns the weather for that area. If auto-location fails, pass `city` or `adcode` explicitly.

How do I find a city's adcode?

`adcode` is the administrative-district code, e.g. Beijing is 110000. You can query by city name directly, or look up Chinese administrative-division codes online.

How often is the data updated?

Weather data is fetched in real time. Each call returns the latest meteorological information.

What information is included in the response?

Base data: weather condition, temperature, humidity, wind direction and force, and update time. With `extended=true` you also get apparent temperature, visibility, pressure, UV, AQI, and per-pollutant breakdown. With `forecast=true` you get up to a 7-day forecast including daily high/low, sunrise/sunset, and other detailed fields. With `hourly=true` you get a 24-hour hourly forecast. With `minutely=true` you get a 2-minute-resolution precipitation forecast (domestic cities only). With `indices=true` you get 18 lifestyle indices.

What is the difference between hourly forecast and minute-level precipitation?

The hourly forecast (`hourly`) returns full meteorological data (temperature, weather, wind, etc.) for each of the next 24 hours. Minute-level precipitation (`minutely`) returns precipitation amount and type at 2-minute resolution, which is useful for deciding whether it will rain in the very near future. Minute-level precipitation is available for domestic cities only.

What does `life_indices` contain?

18 indices in total: clothing, UV, car wash, drying, AC, cold risk, exercise, comfort, travel, fishing, allergy, sunscreen, mood, beer, umbrella, traffic, air purifier, and pollen dispersion. Each entry includes a level, a short description, and detailed advice. All cities support these indices, computed in real time from current weather data.

Which fields are translated when `lang=en`?

Text fields such as city name, province, weather description, wind direction, wind force, and weekday are automatically translated to English. City-name translations cover 7000+ cities. Lifestyle indices (`life_indices`) are currently only available in Chinese.

Why are some fields missing from the response?

Some optional fields depend on data-source coverage. International cities tend to have more complete data; domestic cities may be missing certain fields. When `extended=false` (default), no extended fields are returned at all.

PreviousConvert Timestamp (legacy — use /convert/unixtime instead)

NextQuery World Time

天气查询 API 完成重大升级，新增多项功能并包含破坏性变更。

破坏性变更

错误响应码调整：移除 502（UPSTREAM_ERROR / IP_LOCATION_FAILED），新增 503（SERVICE_UNAVAILABLE）；400 错误码由 INVALID_ARGUMENT 改为 INVALID_PARAMETER，404 由 LOCATION_NOT_FOUND 改为 NOT_FOUND

新增功能

新增 hourly 参数，支持逐小时预报（24小时），返回温度、天气、风向风速、湿度、降水概率、体感温度、露点、能见度等
新增 minutely 参数，支持分钟级降水预报（仅国内城市），每5分钟一个数据点，含降水类型（rain/snow）
indices 生活指数从 8 项扩展至 18 项，新增：出行、钓鱼、过敏、防晒、心情、啤酒、雨伞、交通、空气净化器、花粉扩散
extended=true 新增字段：aqi_level（AQI等级1-6）、aqi_category（等级描述）、aqi_primary（主要污染物）、air_pollutants（PM2.5/PM10/O3/NO2/SO2/CO 分项数据）
forecast 预报从最多3天扩展至最多7天，数组新增 wind_speed_day（风速）、sunrise（日出）、sunset（日落）
city 参数支持国际城市和英文名称（如 Tokyo）
lang=en 城市名翻译覆盖扩展至 7000+ 城市

祝大家新年快乐~

Overview

Optional modules

Notes on the weather field

Query parameters

Response

200 / OK

400 / Bad Request

404 / Not Found

500 / Internal Server Error

503 / Service Unavailable