Weather Daily Forecast

Platform: API iOS Android

Get weather daily forecasts for the next 3-30 days for cities around the world.

Request URL

3 Days Forecast

https://api.qweather.com/v7/weather/3d?{QueryParams}

7 Days Forecast

https://api.qweather.com/v7/weather/7d?{QueryParams}

10 Days Forecast

https://api.qweather.com/v7/weather/10d?{QueryParams}

15 Days Forecast

https://api.qweather.com/v7/weather/15d?{QueryParams}

30 Days Forecast

https://api.qweather.com/v7/weather/30d?{QueryParams}

For Free subscription, change the API Host to devapi.qweather.com. See data available for Free subscription.

Request Parameters

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

key(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example: key=12334567890ABC
location(required)The location to be queried, support LocationID or comma-separated longitude and latitude (decimal, up to 2 decimal places), LocationID can be obtained by GeoAPI. Example: location=101010100 or location=116.41,39.92
langMulti-language setting, please see Language to find out how our multi-language works and how to set up.
unitSet weather data unit, the available value are unit=m for metric(default) and unit=i for imperial. See more about Unit.

Request Example

3-day forecast for Beijing

curl -L -X GET --compressed 'https://api.qweather.com/v7/weather/3d?location=101010100&key=YOUR_KEY'

Response

The response is in JSON format and is Gzip compressed.

{
  "code": "200",
  "updateTime": "2021-11-15T16:35+08:00",
  "fxLink": "http://hfx.link/2ax1",
  "daily": [
    {
      "fxDate": "2021-11-15",
      "sunrise": "06:58",
      "sunset": "16:59",
      "moonrise": "15:16",
      "moonset": "03:40",
      "moonPhase": "盈凸月",
      "moonPhaseIcon": "803",
      "tempMax": "12",
      "tempMin": "-1",
      "iconDay": "101",
      "textDay": "多云",
      "iconNight": "150",
      "textNight": "晴",
      "wind360Day": "45",
      "windDirDay": "东北风",
      "windScaleDay": "1-2",
      "windSpeedDay": "3",
      "wind360Night": "0",
      "windDirNight": "北风",
      "windScaleNight": "1-2",
      "windSpeedNight": "3",
      "humidity": "65",
      "precip": "0.0",
      "pressure": "1020",
      "vis": "25",
      "cloud": "4",
      "uvIndex": "3"
    },
    {
      "fxDate": "2021-11-16",
      "sunrise": "07:00",
      "sunset": "16:58",
      "moonrise": "15:38",
      "moonset": "04:40",
      "moonPhase": "盈凸月",
      "moonPhaseIcon": "803",
      "tempMax": "13",
      "tempMin": "0",
      "iconDay": "100",
      "textDay": "晴",
      "iconNight": "101",
      "textNight": "多云",
      "wind360Day": "225",
      "windDirDay": "西南风",
      "windScaleDay": "1-2",
      "windSpeedDay": "3",
      "wind360Night": "225",
      "windDirNight": "西南风",
      "windScaleNight": "1-2",
      "windSpeedNight": "3",
      "humidity": "74",
      "precip": "0.0",
      "pressure": "1016",
      "vis": "25",
      "cloud": "1",
      "uvIndex": "3"
    },
    {
      "fxDate": "2021-11-17",
      "sunrise": "07:01",
      "sunset": "16:57",
      "moonrise": "16:01",
      "moonset": "05:41",
      "moonPhase": "盈凸月",
      "moonPhaseIcon": "803",
      "tempMax": "13",
      "tempMin": "0",
      "iconDay": "100",
      "textDay": "晴",
      "iconNight": "150",
      "textNight": "晴",
      "wind360Day": "225",
      "windDirDay": "西南风",
      "windScaleDay": "1-2",
      "windSpeedDay": "3",
      "wind360Night": "225",
      "windDirNight": "西南风",
      "windScaleNight": "1-2",
      "windSpeedNight": "3",
      "humidity": "56",
      "precip": "0.0",
      "pressure": "1009",
      "vis": "25",
      "cloud": "0",
      "uvIndex": "3"
    }
  ],
  "refer": {
    "sources": [
      "QWeather",
      "NMC",
      "ECMWF"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code See Status Code
updateTime API last update time
fxLink Responsive web page of this data, for embedded in website or APP
daily.fxDate Forecast date
daily.sunrise Sunrise time. Maybe null in high latitude area
daily.sunset Sunset time. Maybe null in high latitude area
daily.moonrise Moonrise time of current day. Maybe null
daily.moonset Moonset time of current day. Maybe null
daily.moonPhase Moon phase name
daily.moonPhaseIcon Icon code for moon phase. See also QWeather Icons
daily.tempMax The highest temperature of the day
daily.tempMin The lowest temperature of the day
daily.iconDay Icon code for daytime weather conditions. See also QWeather Icons
daily.textDay Weather conditions for daytime
daily.iconNight Icon code for night weather conditions. See also QWeather Icons
daily.textNight Weather conditions for night
daily.wind360Day Daytime wind direction in azimuth degree
daily.windDirDay Daytime wind direction
daily.windScaleDay Daytime wind scale
daily.windSpeedDay Daytime wind speed, KM/H
daily.wind360Night Nightly wind direction in azimuth degree
daily.windDirNight Nightly wind direction
daily.windScaleNight Nightly wind scale
daily.windSpeedNight Nightly wind speed, KM/H
daily.precip Estimated total precipitation for the day
daily.uvIndex UV index
daily.humidity Relative humidity in percent
daily.pressure Atmospheric pressure, hPa
daily.vis Visibility, KM
daily.cloud Cloud cover in percent, may be null
refer.sources Data source and other statements, may be null
refer.license Data license, may be null