Misc

Weather History

0calls

1 credits / call

Need to know whether it rained in a city over the past few days, or how much rainfall was recorded? This endpoint queries up to 366 days of daily historical weather.

GET

uapis.cn

/api/v1/misc/weather/history

Query parameters

city

string

City name in Chinese or English. Optional; when city/adcode are omitted, IP auto-location is attempted.

adcode

string

Six-digit administrative region code. Takes precedence over city.

start_date

string

Start date in YYYY-MM-DD format. Use together with end_date.

end_date

string

End date in YYYY-MM-DD format. Defaults to yesterday.

days

integer

Look-back days, 1-366. Defaults to 365 and only applies when start_date is not provided.

lang

string

Response language: zh (default) or en.

Overview

You can query by city, adcode, or let the system auto-locate by client IP. Use start_date + end_date for an explicit range, or days to look back a number of days. The response focuses on rained and rain, making it useful for travel reviews, agriculture records, weather dashboards, and data analysis.

Notes

Note

Location priority:adcode > city > IP auto-location. When both start_date and days are provided, the start_date + end_date range takes precedence.

Query parameters

city

stringoptional

City name in Chinese or English. Optional; when city/adcode are omitted, IP auto-location is attempted.

adcode

stringoptional

Six-digit administrative region code. Takes precedence over city.

start_date

stringoptional

Start date in YYYY-MM-DD format. Use together with end_date.

end_date

stringoptional

End date in YYYY-MM-DD format. Defaults to yesterday.

days

integeroptional

Look-back days, 1-366. Defaults to 365 and only applies when start_date is not provided.

lang

stringoptional

Response language: zh (default) or en.

Name	Type	Attributes	Description
`city`	string	optional	City name in Chinese or English. Optional; when city/adcode are omitted, IP auto-location is attempted.
`adcode`	string	optional	Six-digit administrative region code. Takes precedence over city.
`start_date`	string	optional	Start date in YYYY-MM-DD format. Use together with end_date.
`end_date`	string	optional	End date in YYYY-MM-DD format. Defaults to yesterday.
`days`	integer	optional	Look-back days, 1-366. Defaults to 365 and only applies when start_date is not provided.
`lang`	string	optional	Response language: zh (default) or en.

Response

200 / OK

Returns daily historical weather for the city.

JSON

{
  "city": "Beijing",
  "adcode": "110000",
  "start_date": "2026-05-01",
  "end_date": "2026-05-31",
  "days": [
    {
      "date": "2026-05-01",
      "weather": "Light rain",
      "temp_max": 24,
      "temp_min": 15,
      "rained": true,
      "rain": 3.6
    }
  ]
}

400 / Bad Request

Invalid parameters, such as an invalid date format or lang not being zh/en.

404 / Not Found

Location was not found.

502 / Bad Gateway

Service temporarily unavailable. Please try again later.

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

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

Frequently asked questions

Are there any special restrictions for the Weather History API?

Weather History follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

Related APIs

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.

Query World Time

Need to schedule a meeting with someone overseas and wonder what time it is there? Use this endpoint for an instant answer.

Adcode Administrative Region Lookup (Domestic & International)

One endpoint covering 243 countries and China’s four-level administrative hierarchy (province / city / district / subdistrict). Three query modes are supported (at least one parameter is required): keyword search, administrative-code lookup, and reverse-geocoding by coordinates.

PreviousAdcode Administrative Region Lookup (Domestic & International)

NextMovie/TV Rating Rank