Weather Daily Forecast

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

Endpoint#

GET /v7/weather/{days}

Parameters#

Path parameters

  • days (required) Forecast days, supports up to 30 days, available value: 3d, 7d, 10d, 15d, 30d

Query parameters

  • 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
  • lang Multi-language setting, please see Language to find out how our multi-language works and how to set up.

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/v7/weather/3d?location=116.41%2C39.92&lang=en'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "code": "200",
  "updateTime": "2023-04-12T18:32+08:00",
  "fxLink": "https://www.qweather.com/en/weather/beijing-101010100.html",
  "daily": [
    {
      "fxDate": "2023-04-12",
      "sunrise": "04:46",
      "sunset": "19:45",
      "moonrise": "04:11",
      "moonset": "20:28",
      "moonPhase": "New Moon",
      "moonPhaseIcon": "800",
      "tempMax": "27",
      "tempMin": "20",
      "iconDay": "302",
      "textDay": "Thundershower",
      "iconNight": "302",
      "textNight": "Thundershower",
      "wind360Day": "180",
      "windDirDay": "S",
      "windScaleDay": "1-3",
      "windSpeedDay": "3",
      "wind360Night": "180",
      "windDirNight": "S",
      "windScaleNight": "1-3",
      "windSpeedNight": "3",
      "humidity": "80",
      "precip": "4.1",
      "pressure": "1003",
      "vis": "24",
      "cloud": "55",
      "uvIndex": "8"
    },
    {
      "fxDate": "2023-04-13",
      "sunrise": "04:46",
      "sunset": "19:45",
      "moonrise": "05:17",
      "moonset": "21:24",
      "moonPhase": "Waxing crescent",
      "moonPhaseIcon": "801",
      "tempMax": "27",
      "tempMin": "20",
      "iconDay": "302",
      "textDay": "Thundershower",
      "iconNight": "302",
      "textNight": "Thundershower",
      "wind360Day": "225",
      "windDirDay": "SW",
      "windScaleDay": "1-3",
      "windSpeedDay": "3",
      "wind360Night": "45",
      "windDirNight": "NE",
      "windScaleNight": "1-3",
      "windSpeedNight": "3",
      "humidity": "78",
      "precip": "1.3",
      "pressure": "1002",
      "vis": "24",
      "cloud": "65",
      "uvIndex": "3"
    },
    {
      "fxDate": "2023-04-14",
      "sunrise": "04:46",
      "sunset": "19:46",
      "moonrise": "06:31",
      "moonset": "22:09",
      "moonPhase": "Waxing crescent",
      "moonPhaseIcon": "801",
      "tempMax": "30",
      "tempMin": "22",
      "iconDay": "101",
      "textDay": "Cloudy",
      "iconNight": "151",
      "textNight": "Cloudy",
      "wind360Day": "135",
      "windDirDay": "SE",
      "windScaleDay": "1-3",
      "windSpeedDay": "3",
      "wind360Night": "135",
      "windDirNight": "SE",
      "windScaleNight": "1-3",
      "windSpeedNight": "3",
      "humidity": "63",
      "precip": "0.0",
      "pressure": "1000",
      "vis": "25",
      "cloud": "1",
      "uvIndex": "11"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}
  • code string Status code
  • updateTime date-time API latest update time
  • fxLink uri Responsive web page of this data, for embedded in website or APP
  • daily array Daily forecast data list
    • fxDate date Forecast date in ISO 8601 format
    • sunrise string Sunrise time. Maybe null in high latitude area
    • sunset string Sunset time. Maybe null in high latitude area
    • moonrise string Moonrise time of current day. Maybe null
    • moonset string Moonset time of current day. Maybe null
    • moonPhase string Moon phase name
    • moonPhaseIcon string Icon code for moon phase
    • tempMax string The highest temperature of the day
    • tempMin string The lowest temperature of the day
    • iconDay string Icon code for daytime weather conditions. See also QWeather Icons
    • textDay string Weather conditions for daytime
    • iconNight string Icon code for night weather conditions. See also QWeather Icons
    • textNight string Weather conditions for night
    • wind360Day string Daytime wind direction in azimuth degree
    • windDirDay string Daytime wind direction
    • windScaleDay string Daytime wind scale
    • windSpeedDay string Daytime wind speed, KM/H
    • wind360Night string Nightly wind direction in azimuth degree
    • windDirNight string Nightly wind direction
    • windScaleNight string Nightly wind scale
    • windSpeedNight string Nightly wind speed, KM/H
    • humidity string Relative humidity in percent
    • precip string Estimated total precipitation for the day
    • pressure string Station pressure, default unit: hPa
    • uvIndex string UV index
    • vis string Visibility, KM
    • cloud string Cloud cover in percent
  • refer object Data sources and licensing information
    • sources array Data source and other statements, may be null
    • license array Data license, may be null