Daily Forecast - (3, 5, 7, 10, 15 Day) - v3.0

Overview

The Daily Forecast API is sourced from The Weather Company Forecast system. It returns weather forecasts starting on the current day. Your content licensing agreement with TWC determines the number of days returned in the API response and is constrained by the API Key provided to your company.

Forecast Composition: Each forecast day can contain up to two 12-hour temporal segments — day (7am to 7pm) and night (7pm to 7am) — plus one 24-hour daily summary, for up to three forecasts per day. The 24-hour segment is represented by the top-level object; the day and night segments are interlaced within the daypart object.

Note: All wind values are calculated based on wind status 10 meters above ground.

HTTP Headers and Data Lifetime — Caching and Expiration

For details on appropriate header values as well as caching and expiration definitions, see the Weather Company Data API Common Usage Guide.

Atomic Endpoints

URL Construction

https://api.weather.com/v3/wx/forecast/daily/7day?geocode=33.74,-84.39&format=json&units=e&language=en-US&apiKey=yourApiKey

https://api.weather.com/v3/wx/forecast/daily/7day?iataCode=DEN&units=e&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/wx/forecast/daily/7day?icaoCode=KDEN&units=e&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/wx/forecast/daily/7day?placeid=327145917e06d09373dd2760425a88622a62d248fd97550eb4883737d8d1173b&units=e&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/wx/forecast/daily/7day?postalKey=81657:US&units=e&language=en-US&format=json&apiKey=yourApiKey

Data Elements & Definitions

Field names are sorted alphabetically for presentation. This does not represent the sort order of the API response.

JSON Sample

{
  "calendarDayTemperatureMax": [88, 88],
  "calendarDayTemperatureMin": [70, 62],
  "dayOfWeek": ["Saturday", "Sunday"],
  "expirationTimeUtc": [1474132620, 1474132620],
  "moonPhase": ["Waning Gibbous", "Waning Gibbous"],
  "moonPhaseCode": ["WXG", "WXG"],
  "moonPhaseDay": ["10", "11"],
  "moonriseTimeLocal": ["2016-09-17T20:30:02-0400", "2016-09-18T21:12:36-0400"],
  "moonriseTimeUtc": [1474158602, 1474247556],
  "moonsetTimeLocal": ["2016-09-17T08:08:29-0400", "2016-09-18T09:16:30-0400"],
  "moonsetTimeUtc": [1474114109, 1474204590],
  "narrative": [
    "Mix of sun and clouds. Highs in the upper 80s and lows in the low 70s.",
    "Showers and thunderstorms late. Highs in the upper 80s."
  ],
  "qpf": [0, 0.2],
  "qpfIce": [0.0, 0.0],
  "qpfRain": [0.0, 0.0],
  "qpfSnow": [0, 0],
  "sunriseTimeLocal": ["2016-09-17T07:21:26-0400", "2016-09-18T07:22:05-0400"],
  "sunriseTimeUtc": [1474111286, 1474197725],
  "sunsetTimeLocal": ["2016-09-17T19:39:03-0400", "2016-09-18T19:37:41-0400"],
  "sunsetTimeUtc": [1474155543, 1474241861],
  "temperatureMax": [88, 88],
  "temperatureMin": [70, 71],
  "validTimeLocal": ["2016-09-17T07:00:00-0400", "2016-09-18T07:00:00-0400"],
  "validTimeUtc": [1474110000, 1474196400],
  "daypart": [
    {
      "cloudCover": [44, 63],
      "dayOrNight": ["D", "N"],
      "daypartName": ["Today", "Tonight"],
      "iconCode": [30, 29],
      "iconCodeExtend": [3000, 2900],
      "narrative": [
        "A mix of clouds and sun. High 88F. Winds SE at 5 to 10 mph.",
        "Partly cloudy this evening with more clouds for overnight."
      ],
      "precipChance": [0, 20],
      "precipType": ["rain", "precip"],
      "qpf": [0, 0],
      "qpfIce": [0.0, 0.0],
      "qpfRain": [0.0, 0.0],
      "qpfSnow": [0, 0],
      "qualifierPhrase": [null, "Slight chance of a rain shower."],
      "relativeHumidity": [48, 79],
      "snowRange": ["", ""],
      "temperature": [88, 70],
      "temperatureHeatIndex": [90, 86],
      "temperatureWindChill": [84, 71],
      "thunderCategory": ["No thunder", "No thunder"],
      "thunderIndex": [0, 0],
      "uvDescription": ["Very High", "Low"],
      "uvIndex": [8, 0],
      "windDirection": [136, 159],
      "windDirectionCardinal": ["SE", "SSE"],
      "windPhrase": ["Winds SE at 5 to 10 mph.", "Winds light and variable."],
      "windSpeed": [7, 3],
      "wxPhraseLong": ["Partly Cloudy", "Partly Cloudy"],
      "wxPhraseShort": ["P Cloudy", "P Cloudy"]
    }
  ]
}