Weather Hourly Forecast

Hour-by-hour weather forecast for the next 168 hours, including: temperature, weather conditions, wind speed, wind direction, relative humidity, atmospheric pressure, precipitation probability, dew point temperature, and cloud cover.

Request URL #

Hourly Forecast (24hrs)

  • Prohttps://api.qweather.com/v7/weather/24h?[params]
  • Devhttps://devapi.qweather.com/v7/weather/24h?[params]

Hourly Forecast (72hrs)

  • Prohttps://api.qweather.com/v7/weather/72h?[params]

Hourly Forecast (168hrs)

  • Prohttps://api.qweather.com/v7/weather/168h?[params]

Request Parameters #

All parameters are separated by &. If no optional parameters are set, the default value will be used.

location

The location to be queried, support LocationID or comma-separated longitude and latitude, LocationID can be obtained by GeoAPI.

For example: location=101010100 or location=116.41,39.92

key

API authentication key, please refer to How To Get Your Key. Support Signature Authentication.

For example: key=12334567890ABC

lang

Multi-language setting, if data does not match the language you set, it will return results in English or its native language.

unit

Select weather data unit, for unit parameters of all data, please refer Unit

  • m metric unit, default
  • i imperial unit

Response #

// 24 Hours forecast for Beijing 
// Pro API:  https://api.qweather.com/v7/weather/24h?location=101010100&lang=en&key=YOUR_KEY
// Dev API:  https://devapi.qweather.com/v7/weather/24h?location=101010100&lang=en&key=YOUR_KEY

{
  "code": "200",
  "updateTime": "2021-02-14T15:35+08:00",
  "fxLink": "http://hfx.link/2ax1",
  "hourly": [
    {
      "fxTime": "2021-02-14T17:00+08:00",
      "temp": "3",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "40",
      "windDir": "NE",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "71",
      "pop": "18",
      "precip": "0.0",
      "pressure": "1020",
      "cloud": "89",
      "dew": "-1"
    },
    {
      "fxTime": "2021-02-14T18:00+08:00",
      "temp": "2",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "19",
      "windDir": "NE",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "77",
      "pop": "12",
      "precip": "0.0",
      "pressure": "1020",
      "cloud": "92",
      "dew": "-1"
    },
    {
      "fxTime": "2021-02-14T19:00+08:00",
      "temp": "1",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "34",
      "windDir": "NE",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "80",
      "pop": "7",
      "precip": "0.0",
      "pressure": "1019",
      "cloud": "94",
      "dew": "-1"
    },
    {
      "fxTime": "2021-02-14T20:00+08:00",
      "temp": "2",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "16",
      "windDir": "NE",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "74",
      "pop": "7",
      "precip": "0.0",
      "pressure": "1018",
      "cloud": "94",
      "dew": "-2"
    },
    {
      "fxTime": "2021-02-14T21:00+08:00",
      "temp": "1",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "4",
      "windDir": "N",
      "windScale": "3-4",
      "windSpeed": "16",
      "humidity": "71",
      "pop": "7",
      "precip": "0.0",
      "pressure": "1018",
      "cloud": "76",
      "dew": "-2"
    },
    {
      "fxTime": "2021-02-14T22:00+08:00",
      "temp": "1",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "354",
      "windDir": "N",
      "windScale": "3-4",
      "windSpeed": "18",
      "humidity": "58",
      "pop": "7",
      "precip": "0.0",
      "pressure": "1018",
      "cloud": "76",
      "dew": "-6"
    },
    {
      "fxTime": "2021-02-14T23:00+08:00",
      "temp": "1",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "348",
      "windDir": "NW",
      "windScale": "3-4",
      "windSpeed": "20",
      "humidity": "44",
      "pop": "7",
      "precip": "0.0",
      "pressure": "1018",
      "cloud": "76",
      "dew": "-9"
    },
    {
      "fxTime": "2021-02-15T00:00+08:00",
      "temp": "0",
      "icon": "101",
      "text": "Cloudy",
      "wind360": "343",
      "windDir": "NW",
      "windScale": "3-4",
      "windSpeed": "18",
      "humidity": "36",
      "pop": "5",
      "precip": "0.0",
      "pressure": "1018",
      "cloud": "76",
      "dew": "-13"
    },
    {
      "fxTime": "2021-02-15T01:00+08:00",
      "temp": "0",
      "icon": "150",
      "text": "Clear",
      "wind360": "339",
      "windDir": "NW",
      "windScale": "3-4",
      "windSpeed": "16",
      "humidity": "31",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1018",
      "cloud": "26",
      "dew": "-15"
    },
    {
      "fxTime": "2021-02-15T02:00+08:00",
      "temp": "0",
      "icon": "150",
      "text": "Clear",
      "wind360": "334",
      "windDir": "NW",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "28",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1017",
      "cloud": "26",
      "dew": "-17"
    },
    {
      "fxTime": "2021-02-15T03:00+08:00",
      "temp": "-1",
      "icon": "150",
      "text": "Clear",
      "wind360": "332",
      "windDir": "NW",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "27",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1015",
      "cloud": "26",
      "dew": "-18"
    },
    {
      "fxTime": "2021-02-15T04:00+08:00",
      "temp": "-1",
      "icon": "150",
      "text": "Clear",
      "wind360": "331",
      "windDir": "NW",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "26",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1014",
      "cloud": "26",
      "dew": "-19"
    },
    {
      "fxTime": "2021-02-15T05:00+08:00",
      "temp": "-2",
      "icon": "150",
      "text": "Clear",
      "wind360": "329",
      "windDir": "NW",
      "windScale": "3-4",
      "windSpeed": "13",
      "humidity": "26",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1012",
      "cloud": "26",
      "dew": "-19"
    },
    {
      "fxTime": "2021-02-15T06:00+08:00",
      "temp": "-2",
      "icon": "150",
      "text": "Clear",
      "wind360": "332",
      "windDir": "NW",
      "windScale": "1-2",
      "windSpeed": "11",
      "humidity": "25",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1009",
      "cloud": "26",
      "dew": "-20"
    },
    {
      "fxTime": "2021-02-15T07:00+08:00",
      "temp": "-4",
      "icon": "150",
      "text": "Clear",
      "wind360": "346",
      "windDir": "NW",
      "windScale": "1-2",
      "windSpeed": "9",
      "humidity": "30",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1007",
      "cloud": "0",
      "dew": "-19"
    },
    {
      "fxTime": "2021-02-15T08:00+08:00",
      "temp": "-2",
      "icon": "100",
      "text": "Sunny",
      "wind360": "1",
      "windDir": "N",
      "windScale": "1-2",
      "windSpeed": "7",
      "humidity": "28",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1006",
      "cloud": "0",
      "dew": "-18"
    },
    {
      "fxTime": "2021-02-15T09:00+08:00",
      "temp": "0",
      "icon": "100",
      "text": "Sunny",
      "wind360": "224",
      "windDir": "SW",
      "windScale": "1-2",
      "windSpeed": "11",
      "humidity": "23",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1005",
      "cloud": "0",
      "dew": "-19"
    },
    {
      "fxTime": "2021-02-15T10:00+08:00",
      "temp": "2",
      "icon": "100",
      "text": "Sunny",
      "wind360": "219",
      "windDir": "SW",
      "windScale": "3-4",
      "windSpeed": "14",
      "humidity": "18",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1005",
      "cloud": "0",
      "dew": "-19"
    },
    {
      "fxTime": "2021-02-15T11:00+08:00",
      "temp": "3",
      "icon": "100",
      "text": "Sunny",
      "wind360": "218",
      "windDir": "SW",
      "windScale": "3-4",
      "windSpeed": "16",
      "humidity": "16",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1007",
      "cloud": "0",
      "dew": "-20"
    },
    {
      "fxTime": "2021-02-15T12:00+08:00",
      "temp": "4",
      "icon": "100",
      "text": "Sunny",
      "wind360": "218",
      "windDir": "SW",
      "windScale": "3-4",
      "windSpeed": "18",
      "humidity": "16",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1008",
      "cloud": "0",
      "dew": "-19"
    },
    {
      "fxTime": "2021-02-15T13:00+08:00",
      "temp": "5",
      "icon": "100",
      "text": "Sunny",
      "wind360": "218",
      "windDir": "SW",
      "windScale": "3-4",
      "windSpeed": "18",
      "humidity": "18",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1009",
      "cloud": "0",
      "dew": "-17"
    },
    {
      "fxTime": "2021-02-15T14:00+08:00",
      "temp": "5",
      "icon": "100",
      "text": "Sunny",
      "wind360": "218",
      "windDir": "SW",
      "windScale": "3-4",
      "windSpeed": "20",
      "humidity": "23",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1011",
      "cloud": "0",
      "dew": "-14"
    },
    {
      "fxTime": "2021-02-15T15:00+08:00",
      "temp": "5",
      "icon": "100",
      "text": "Sunny",
      "wind360": "217",
      "windDir": "SW",
      "windScale": "3-4",
      "windSpeed": "20",
      "humidity": "27",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1013",
      "cloud": "6",
      "dew": "-12"
    },
    {
      "fxTime": "2021-02-15T16:00+08:00",
      "temp": "6",
      "icon": "100",
      "text": "Sunny",
      "wind360": "217",
      "windDir": "SW",
      "windScale": "3-4",
      "windSpeed": "22",
      "humidity": "29",
      "pop": "0",
      "precip": "0.0",
      "pressure": "1014",
      "cloud": "12",
      "dew": "-10"
    }
  ],
  "refer": {
    "sources": [
      "Weather China"
    ],
    "license": [
      "commercial license"
    ]
  }
}
Parameters Description
code

API status code, please refer to Status Code

updateTime

API last update time

fxLink

Responsive web page of this data, for embedded in website or APP

hourly.fxTime

Forecast time

hourly.temp

temperature

hourly.icon

Icon code of weather conditions, free to download weather icons

hourly.text

Weather conditions

hourly.wind360

Wind direction in azimuth degree

hourly.windDir

Wind direction

hourly.windScale

Wind scale

hourly.windSpeed

Wind speed, KM/H

hourly.humidity

Relative humidity in percent

hourly.precip

Accumulated precipitation in the current hour

hourly.pop

Precipitation probability in percent, may be null

hourly.pressure

Atmospheric pressure, hPa

hourly.cloud

Cloud cover in percent

hourly.dew

Dew point temperature

refer.sources

Data source and other statements, may be null

refer.license

Data license, may be null