Degree Day Forecast API

With this API, you can retrieve cooling or heating degree day forecasts out to 8 days in daily or hourly intervals. Additionally, you can retrieve forecasts for other valuable information like total sun hours, precipitation, snowfall, and more!

Be sure to check out our blog to read about the methodology for calculating degree days.

This API is available to the following plans (See: pricing):

  • Energy API / Advanced plan(s)

All parameters should be supplied to the Weather API as query string parameters.

Base URL

HTTP: http://api.weatherbit.io/v2.0/forecast/energy
HTTPS: https://api.weatherbit.io/v2.0/forecast/energy
Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.
units=[units](optional)
  • M - [DEFAULT] Metric (Celcius, m/s, mm)
  • S - Scientific (Kelvin, m/s, mm)
  • I - Fahrenheit (F, mph, in)
tp=[time_period] (optional - Time period of each timestamp, default = daily)
  • hourly - Hourly time steps
  • daily - [DEFAULT] Daily time steps
threshold=[degrees]
callback=[function] (optional: JSON-P callback)

API Endpoints

Description Required Parameters Example(s)
Get data by lat/lon lat, lon &lat=38.123&lon=-78.543
Get data by city name city, state(optional), country (optional) &city=Raleigh,NC
Get data by postal code postal_code, country (optional) &postal_code=27601&country=US
Get data by city id city_id &city_id=8953360
Get data by ICAO or station id station &station=KRDU

Example Request:

https://api.weatherbit.io/v2.0/forecast/energy?lat=38.0&lon=-78.0&threshold=63&units=I&key=API_KEY

Example Response (JSON):


        {  
           "threshold_units":"F",
           "timezone":"America\/New_York",
           "threshold_value":"63",
           "state_code":"VA",
           "country_code":"US",
           "city_name":"Louisa",
           "city_id":4770766,
           "data":[  
              {  
                 "date":"2019-03-04",
                 "timestamp_utc":"2019-03-04T17:00:00",
                 "timestamp_local":"2019-03-04T12:00:00",
                 "temp":45.9,
                 "temp_wetbulb":44.3,
                 "hdd":13,
                 "cdd":0,
                 "wind_spd":4.7,
                 "max_wind_spd":8.1,
                 "wind_dir":166,
                 "wind_spd_100m":7.9,
                 "max_wind_spd_100m":10,
                 "wind_dir_100m":185,
                 "dewpt":33.4,
                 "snow":0,
                 "rh":86,
                 "dhi":194.8,
                 "precip":0,
                 "t_dni":1245,
                 "t_dhi":400,
                 "t_ghi":3000,
                 "sun_hours":4.7,
                 "clouds":6
              }, ... 
           ]

        }

        

Field Decriptions:

  • threshold_units: Degree Day threshold units (F/C/K).
  • threshold_value: Degree Day threshold value in degrees.
  • lat: Latitude (Degrees).
  • lon: Longitude (Degrees).
  • timezone: Local IANA Timezone.
  • city_name: City name.
  • city_id: City ID.
  • station_id: Source station ID.
  • country_code: Country abbreviation.
  • state_code: State abbreviation/code.
  • data: [
    • date: Date (YYYY-MM-DD).
    • timestamp_local: Timestamp at local time.
    • timestamp_utc: Timestamp at UTC time.
    • wind_spd: Average 10m wind speed over period (Default m/s).
    • wind_dir: Average 10m wind direction over period (degrees).
    • max_wind_spd: Maximum 10m wind gust over period (Default m/s).
    • wind_spd_100m: Average 100m wind speed over period (Default m/s).
    • wind_dir_100m: Average 100m wind direction over period (degrees).
    • max_wind_spd_100m: Maximum 100m wind speed over period (Default m/s).
    • cdd: Total number of cooling degree days relative to threshold temperature.
    • hdd: Total number of heating degree days relative to threshold temperature.
    • temp: Average temperature over period (default Celcius).
    • temp_wetbulb: Average wet bulb temperature over period (default Celcius).
    • rh: Average relative humidity over period (%).
    • dewpt: Average dew point over period (default Celcius).
    • clouds: Average cloud coverage over period (%).
    • precip: Accumulated liquid equivalent precipitation over period (default mm).
    • snow: Accumulated snowfall over period (default mm).
    • t_dni: Total direct normal irradiance (W/M^2) [Clear Sky]
    • t_ghi: Total global horizontal irradiance (W/M^2) [Clear Sky]
    • t_dhi: Total diffuse horizontal irradiance (W/M^2) [Clear Sky]
    • t_solar_rad: Total solar radiation (W/M^2)
    • sun_hours: Total peak sun hours over period.
  • ]