Daily Forecast (City-based)

Note: Daily Forecast (City-based) Web API v7 will be deprecated. Use Daily Forecast v1 instead.

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

  string

  Forecast days, supports up to 30 days, available value: 3d, 7d, 10d, 15d, 30d

Query parameters

• location ^required

  string

  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

  string

  Language setting. See Language for behavior, configuration, and data availability

Request example#

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

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 for the forecast date; may be null
  • moonset

    string

    Moonset time for the forecast date; may be 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