Daily Forecast API (16 day)

Returns daily forecast data for up to 16 days. Forecasts update approximately once per hour.

API Guide

Daily Forecast API (16 day)

Returns daily forecast data for up to 16 days. Forecasts update approximately once per hour.

Includes temperature, precipitation, snowfall, UV, and weather conditions.

  • Up to 16 days of daily forecast data.
  • Supports all core location query methods.
  • Includes wide field coverage for weather products.

Frequently Asked Questions

How frequently do forecasts update?

Forecasts are refreshed once per hour in most locations, which makes them a good fit for operational dashboards, alerting, and other products that benefit from frequent forecast refreshes.

Read help article

What data sources are used for forecasts?

Forecast responses are built from a mix of short-range, regional, and longer-range global models. We dynamically select and bias-correct the best-performing model inputs for the location and time of interest.

Read help article

What spatial resolution should I expect from forecast data?

Forecast resolution generally ranges from about 1 to 13 km depending on region. Coverage is typically highest resolution in North America and Europe, with coarser but still high-resolution coverage elsewhere.

Read help article

When is data valid, and how are accumulated values computed?

Unless a field is documented otherwise, values are valid at the timestamp shown in the response. Accumulated fields such as precipitation and snowfall represent the aggregate for the interval from that timestamp, to the next timestamp. The same applies to averages, max/mins, etc.

Read help article

What does the `solar_rad` field represent?

The solar radiation field is an estimated surface solar flux value that accounts for cloud cover, surface albedo, and atmospheric effects. Alternatively, GHI/DNI/DHI values are clear-sky values which do not account for these.

Read help article

How do I get historical forecast data?

Historical forecasts are provided through a separate custom report system rather than the live forecast endpoints. It is a good option when you need archived forecast runs, larger backfills, or one-off historical forecast deliveries.

Read help article

What is the difference between high/low and max/min temperature?

Max and min temperature are midnight-to-midnight local values that fit analytics and climatology use cases. High and low temperature are daytime and nighttime ranges that are usually better for consumer-facing forecast displays.

Read help article

Request Parameters

Field Optional/Required Type Data Type Description
lat Optional query number Latitude component of location.
lon Optional query number Longitude component of location.
city Optional query string City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR
postal_code Optional query string Postal Code. Example: 28546
country Optional query string Country Code (2 letter) - to be used with postal_code.
station Optional query string Station Call ID.
days Optional query number Number of days to return. Default 16.
units Optional query string Convert to units. Default Metric. Options (I = Imperial, M = Metric, S = Scientific) Options: S, I, M
lang Optional query string Language (Default: English) See language field description Options: ar, az, be, bg, bs, ca, cs, de, fi, fr, el, es, et, hr, hu, id, it, is, kw, nb, nl, pl, pt, ro, ru, sk, sl, sr, sv, tr, uk, zh, zh-tw
key Required query string Your registered API key.

* One of the following location methods is required: lat/lon (recommended), city,ST + country, postal_code + country or station ID .

Example Requests

Geolocation options: lat/lon (recommended), city, postal_code and country or station ID

Enter API key

lat/lon (recommended)

https://api.weatherbit.io/v2.0/forecast/daily?days=16&key=API_KEY&lat=35.7796&lon=-78.6382
curl -s "https://api.weatherbit.io/v2.0/forecast/daily?days=16&key=API_KEY&lat=35.7796&lon=-78.6382"
require 'uri'
require 'net/http'
require 'json'

uri = URI("https://api.weatherbit.io/v2.0/forecast/daily?days=16&key=API_KEY&lat=35.7796&lon=-78.6382")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == "https")
request = Net::HTTP::Get.new(uri)
response = http.request(request)
json = JSON.parse(response.body)
puts JSON.pretty_generate(json)
const https = require("https");

https.get("https://api.weatherbit.io/v2.0/forecast/daily?days=16&key=API_KEY&lat=35.7796&lon=-78.6382", (res) => {
  let raw = "";
  res.on("data", (chunk) => { raw += chunk; });
  res.on("end", () => {
    const json = JSON.parse(raw);
    console.log(JSON.stringify(json, null, 2));
  });
}).on("error", (err) => {
  console.error(err.message);
});
# pip install python-weatherbit
# https://pypi.org/project/pyweatherbit/

from weatherbit.api import Api

api = Api("YOUR_API_KEY")
response = api.get_forecast(lat='35.7796', lon='-78.6382', days=5, tp='daily').get()
print(response)
Estimated quota: 1 requeststandard

Example Response HTTP 200

Loading weather demo...
{
  "city_name": "Raleigh",
  "country_code": "US",
  "data": [
    {
      "app_max_temp": 24.1,
      "app_min_temp": 15.7,
      "clouds": 18,
      "clouds_hi": 0,
      "clouds_low": 1,
      "clouds_mid": 14,
      "datetime": "2026-06-02",
      "dewpt": 9.9,
      "high_temp": 25.5,
      "low_temp": 11.8,
      "max_dhi": null,
      "max_temp": 25.5,
      "min_temp": 15.2,
      "moon_phase": 0.91,
      "moon_phase_lunation": 0.59,
      "moonrise_ts": 1780452247,
      "moonset_ts": 1780402831,
      "ozone": 399,
      "pop": 0,
      "precip": 0,
      "pres": 1010,
      "rh": 55,
      "slp": 1022,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780394280,
      "sunset_ts": 1780446380,
      "temp": 20,
      "ts": 1780372860,
      "uv": 11,
      "valid_date": "2026-06-02",
      "vis": 23.8,
      "weather": {
        "code": 801,
        "description": "Few clouds",
        "icon": "c02d"
      },
      "wind_cdir": "NE",
      "wind_cdir_full": "northeast",
      "wind_dir": 51,
      "wind_gust_spd": 6.2,
      "wind_spd": 3.9
    },
    {
      "app_max_temp": 26.9,
      "app_min_temp": 12.5,
      "clouds": 3,
      "clouds_hi": 3,
      "clouds_low": 0,
      "clouds_mid": 0,
      "datetime": "2026-06-03",
      "dewpt": 7.4,
      "high_temp": 29,
      "low_temp": 13.4,
      "max_dhi": null,
      "max_temp": 29,
      "min_temp": 11.8,
      "moon_phase": 0.85,
      "moon_phase_lunation": 0.62,
      "moonrise_ts": 1780541408,
      "moonset_ts": 1780492841,
      "ozone": 389,
      "pop": 0,
      "precip": 0,
      "pres": 1013,
      "rh": 46,
      "slp": 1025,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780480663,
      "sunset_ts": 1780532816,
      "temp": 20.4,
      "ts": 1780459260,
      "uv": 11,
      "valid_date": "2026-06-03",
      "vis": 24,
      "weather": {
        "code": 801,
        "description": "Few clouds",
        "icon": "c02d"
      },
      "wind_cdir": "SSE",
      "wind_cdir_full": "south-southeast",
      "wind_dir": 153,
      "wind_gust_spd": 3.5,
      "wind_spd": 2.2
    },
    {
      "app_max_temp": 29.3,
      "app_min_temp": 14.2,
      "clouds": 3,
      "clouds_hi": 0,
      "clouds_low": 0,
      "clouds_mid": 0,
      "datetime": "2026-06-04",
      "dewpt": 9.9,
      "high_temp": 32.1,
      "low_temp": 16.1,
      "max_dhi": null,
      "max_temp": 32.1,
      "min_temp": 13.4,
      "moon_phase": 0.77,
      "moon_phase_lunation": 0.65,
      "moonrise_ts": 1780630189,
      "moonset_ts": 1780582912,
      "ozone": 358,
      "pop": 0,
      "precip": 0,
      "pres": 1012,
      "rh": 48,
      "slp": 1023,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780567048,
      "sunset_ts": 1780619251,
      "temp": 22.7,
      "ts": 1780545660,
      "uv": 11,
      "valid_date": "2026-06-04",
      "vis": 24,
      "weather": {
        "code": 801,
        "description": "Few clouds",
        "icon": "c02d"
      },
      "wind_cdir": "SE",
      "wind_cdir_full": "southeast",
      "wind_dir": 146,
      "wind_gust_spd": 1.8,
      "wind_spd": 1.1
    },
    {
      "app_max_temp": 32.5,
      "app_min_temp": 16.9,
      "clouds": 8,
      "clouds_hi": 35,
      "clouds_low": 0,
      "clouds_mid": 0,
      "datetime": "2026-06-05",
      "dewpt": 12.1,
      "high_temp": 35.7,
      "low_temp": 19,
      "max_dhi": null,
      "max_temp": 35.7,
      "min_temp": 16.1,
      "moon_phase": 0.68,
      "moon_phase_lunation": 0.69,
      "moonrise_ts": 1780632235,
      "moonset_ts": 1780672990,
      "ozone": 330,
      "pop": 0,
      "precip": 0,
      "pres": 1009,
      "rh": 47,
      "slp": 1021,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780653434,
      "sunset_ts": 1780705685,
      "temp": 25.4,
      "ts": 1780632060,
      "uv": 10,
      "valid_date": "2026-06-05",
      "vis": 24,
      "weather": {
        "code": 801,
        "description": "Few clouds",
        "icon": "c02d"
      },
      "wind_cdir": "SSW",
      "wind_cdir_full": "south-southwest",
      "wind_dir": 207,
      "wind_gust_spd": 2.8,
      "wind_spd": 2.1
    },
    {
      "app_max_temp": 33.4,
      "app_min_temp": 19.7,
      "clouds": 30,
      "clouds_hi": 63,
      "clouds_low": 0,
      "clouds_mid": 10,
      "datetime": "2026-06-06",
      "dewpt": 14.1,
      "high_temp": 36.3,
      "low_temp": 19.9,
      "max_dhi": null,
      "max_temp": 36.3,
      "min_temp": 19,
      "moon_phase": 0.58,
      "moon_phase_lunation": 0.72,
      "moonrise_ts": 1780720421,
      "moonset_ts": 1780763075,
      "ozone": 329,
      "pop": 0,
      "precip": 0,
      "pres": 1006,
      "rh": 48,
      "slp": 1018,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780739822,
      "sunset_ts": 1780792118,
      "temp": 27,
      "ts": 1780718460,
      "uv": 9,
      "valid_date": "2026-06-06",
      "vis": 24,
      "weather": {
        "code": 802,
        "description": "Scattered clouds",
        "icon": "c02d"
      },
      "wind_cdir": "SW",
      "wind_cdir_full": "southwest",
      "wind_dir": 215,
      "wind_gust_spd": 3.7,
      "wind_spd": 3.8
    },
    {
      "app_max_temp": 33.8,
      "app_min_temp": 21.1,
      "clouds": 43,
      "clouds_hi": 96,
      "clouds_low": 9,
      "clouds_mid": 42,
      "datetime": "2026-06-07",
      "dewpt": 15.8,
      "high_temp": 36.5,
      "low_temp": 21.3,
      "max_dhi": null,
      "max_temp": 36.5,
      "min_temp": 19.9,
      "moon_phase": 0.47,
      "moon_phase_lunation": 0.76,
      "moonrise_ts": 1780808429,
      "moonset_ts": 1780853208,
      "ozone": 316,
      "pop": 0,
      "precip": 0,
      "pres": 1004,
      "rh": 54,
      "slp": 1015,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780826211,
      "sunset_ts": 1780878550,
      "temp": 26.6,
      "ts": 1780804860,
      "uv": 8,
      "valid_date": "2026-06-07",
      "vis": 24,
      "weather": {
        "code": 803,
        "description": "Broken clouds",
        "icon": "c03d"
      },
      "wind_cdir": "SW",
      "wind_cdir_full": "southwest",
      "wind_dir": 217,
      "wind_gust_spd": 4.4,
      "wind_spd": 3.8
    },
    {
      "app_max_temp": 29.6,
      "app_min_temp": 19.7,
      "clouds": 75,
      "clouds_hi": 30,
      "clouds_low": 57,
      "clouds_mid": 60,
      "datetime": "2026-06-08",
      "dewpt": 18.8,
      "high_temp": 28,
      "low_temp": 16.5,
      "max_dhi": null,
      "max_temp": 28,
      "min_temp": 19.4,
      "moon_phase": 0.36,
      "moon_phase_lunation": 0.79,
      "moonrise_ts": 1780896344,
      "moonset_ts": 1780943458,
      "ozone": 330,
      "pop": 75,
      "precip": 8.4375,
      "pres": 1005,
      "rh": 76,
      "slp": 1016,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780912602,
      "sunset_ts": 1780964981,
      "temp": 23.5,
      "ts": 1780891260,
      "uv": 11,
      "valid_date": "2026-06-08",
      "vis": 19.9,
      "weather": {
        "code": 501,
        "description": "Moderate rain",
        "icon": "r02d"
      },
      "wind_cdir": "S",
      "wind_cdir_full": "south",
      "wind_dir": 187,
      "wind_gust_spd": 6.4,
      "wind_spd": 3.7
    },
    {
      "app_max_temp": 20.1,
      "app_min_temp": 15,
      "clouds": 99,
      "clouds_hi": 1,
      "clouds_low": 99,
      "clouds_mid": 28,
      "datetime": "2026-06-09",
      "dewpt": 13.3,
      "high_temp": 20.4,
      "low_temp": 16,
      "max_dhi": null,
      "max_temp": 20.4,
      "min_temp": 15,
      "moon_phase": 0.25,
      "moon_phase_lunation": 0.83,
      "moonrise_ts": 1780984249,
      "moonset_ts": 1781033902,
      "ozone": 366,
      "pop": 30,
      "precip": 1.25,
      "pres": 1009,
      "rh": 76,
      "slp": 1021,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1780998995,
      "sunset_ts": 1781051411,
      "temp": 17.7,
      "ts": 1780977660,
      "uv": 11,
      "valid_date": "2026-06-09",
      "vis": 24,
      "weather": {
        "code": 804,
        "description": "Overcast clouds",
        "icon": "c04d"
      },
      "wind_cdir": "NNE",
      "wind_cdir_full": "north-northeast",
      "wind_dir": 30,
      "wind_gust_spd": 8.9,
      "wind_spd": 5.5
    },
    {
      "app_max_temp": 20.1,
      "app_min_temp": 16,
      "clouds": 99,
      "clouds_hi": 50,
      "clouds_low": 97,
      "clouds_mid": 29,
      "datetime": "2026-06-10",
      "dewpt": 14.9,
      "high_temp": 20.1,
      "low_temp": 16.8,
      "max_dhi": null,
      "max_temp": 20.1,
      "min_temp": 16,
      "moon_phase": 0.15,
      "moon_phase_lunation": 0.86,
      "moonrise_ts": 1781072233,
      "moonset_ts": 1781124604,
      "ozone": 362,
      "pop": 45,
      "precip": 2.625,
      "pres": 1004,
      "rh": 86,
      "slp": 1016,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781085390,
      "sunset_ts": 1781137839,
      "temp": 17.2,
      "ts": 1781064060,
      "uv": 11,
      "valid_date": "2026-06-10",
      "vis": 22.8,
      "weather": {
        "code": 201,
        "description": "Thunderstorm with rain",
        "icon": "t02d"
      },
      "wind_cdir": "NW",
      "wind_cdir_full": "northwest",
      "wind_dir": 304,
      "wind_gust_spd": 9.1,
      "wind_spd": 4.2
    },
    {
      "app_max_temp": 26.2,
      "app_min_temp": 17.3,
      "clouds": 73,
      "clouds_hi": 8,
      "clouds_low": 72,
      "clouds_mid": 0,
      "datetime": "2026-06-11",
      "dewpt": 17.7,
      "high_temp": 26,
      "low_temp": 17.8,
      "max_dhi": null,
      "max_temp": 26,
      "min_temp": 17.3,
      "moon_phase": 0.07,
      "moon_phase_lunation": 0.89,
      "moonrise_ts": 1781160404,
      "moonset_ts": 1781215553,
      "ozone": 344,
      "pop": 20,
      "precip": 0.8125,
      "pres": 1000,
      "rh": 83,
      "slp": 1011,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781171787,
      "sunset_ts": 1781224267,
      "temp": 20.8,
      "ts": 1781150460,
      "uv": 11,
      "valid_date": "2026-06-11",
      "vis": 23.7,
      "weather": {
        "code": 804,
        "description": "Overcast clouds",
        "icon": "c04d"
      },
      "wind_cdir": "SSE",
      "wind_cdir_full": "south-southeast",
      "wind_dir": 155,
      "wind_gust_spd": 6.7,
      "wind_spd": 3.8
    },
    {
      "app_max_temp": 28.9,
      "app_min_temp": 17.8,
      "clouds": 4,
      "clouds_hi": 18,
      "clouds_low": 1,
      "clouds_mid": 0,
      "datetime": "2026-06-12",
      "dewpt": 16.1,
      "high_temp": 32.4,
      "low_temp": 26.5,
      "max_dhi": null,
      "max_temp": 32.4,
      "min_temp": 17.8,
      "moon_phase": 0.02,
      "moon_phase_lunation": 0.93,
      "moonrise_ts": 1781248894,
      "moonset_ts": 1781306600,
      "ozone": 332,
      "pop": 0,
      "precip": 0,
      "pres": 1000,
      "rh": 73,
      "slp": 1012,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781258185,
      "sunset_ts": 1781310693,
      "temp": 22.1,
      "ts": 1781236860,
      "uv": 11,
      "valid_date": "2026-06-12",
      "vis": 24,
      "weather": {
        "code": 801,
        "description": "Few clouds",
        "icon": "c02d"
      },
      "wind_cdir": "WNW",
      "wind_cdir_full": "west-northwest",
      "wind_dir": 303,
      "wind_gust_spd": 3.4,
      "wind_spd": 2.4
    },
    {
      "app_max_temp": 28.7,
      "app_min_temp": 23.6,
      "clouds": 80,
      "clouds_hi": 5,
      "clouds_low": 80,
      "clouds_mid": 0,
      "datetime": "2026-06-13",
      "dewpt": 19.3,
      "high_temp": 29.8,
      "low_temp": 24.3,
      "max_dhi": null,
      "max_temp": 29.8,
      "min_temp": 21,
      "moon_phase": 0,
      "moon_phase_lunation": 0.96,
      "moonrise_ts": 1781337867,
      "moonset_ts": 1781397435,
      "ozone": 318,
      "pop": 0,
      "precip": 0,
      "pres": 1007,
      "rh": 70,
      "slp": 1018,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781344585,
      "sunset_ts": 1781397117,
      "temp": 25.2,
      "ts": 1781323260,
      "uv": 11,
      "valid_date": "2026-06-13",
      "vis": 24,
      "weather": {
        "code": 804,
        "description": "Overcast clouds",
        "icon": "c04d"
      },
      "wind_cdir": "ESE",
      "wind_cdir_full": "east-southeast",
      "wind_dir": 108,
      "wind_gust_spd": 8.9,
      "wind_spd": 5.5
    },
    {
      "app_max_temp": 30.5,
      "app_min_temp": 25.5,
      "clouds": 40,
      "clouds_hi": 0,
      "clouds_low": 34,
      "clouds_mid": 40,
      "datetime": "2026-06-14",
      "dewpt": 16.5,
      "high_temp": 33.9,
      "low_temp": 27.7,
      "max_dhi": null,
      "max_temp": 33.9,
      "min_temp": 22.7,
      "moon_phase": 0,
      "moon_phase_lunation": 1,
      "moonrise_ts": 1781427478,
      "moonset_ts": 1781483835,
      "ozone": 321,
      "pop": 25,
      "precip": 0.99674034,
      "pres": 1001,
      "rh": 51,
      "slp": 1013,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781430986,
      "sunset_ts": 1781483540,
      "temp": 28,
      "ts": 1781409660,
      "uv": 11,
      "valid_date": "2026-06-14",
      "vis": 24,
      "weather": {
        "code": 802,
        "description": "Scattered clouds",
        "icon": "c02d"
      },
      "wind_cdir": "SW",
      "wind_cdir_full": "southwest",
      "wind_dir": 231,
      "wind_gust_spd": 5.2,
      "wind_spd": 2.7
    },
    {
      "app_max_temp": 30.5,
      "app_min_temp": 22,
      "clouds": 5,
      "clouds_hi": 19,
      "clouds_low": 0,
      "clouds_mid": 0,
      "datetime": "2026-06-15",
      "dewpt": 16,
      "high_temp": 33.2,
      "low_temp": 27.2,
      "max_dhi": null,
      "max_temp": 33.2,
      "min_temp": 19.9,
      "moon_phase": 0.02,
      "moon_phase_lunation": 0.03,
      "moonrise_ts": 1781517775,
      "moonset_ts": 1781574123,
      "ozone": 313,
      "pop": 90,
      "precip": 21.655882,
      "pres": 1001,
      "rh": 55,
      "slp": 1013,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781517389,
      "sunset_ts": 1781569962,
      "temp": 26.1,
      "ts": 1781496060,
      "uv": 11,
      "valid_date": "2026-06-15",
      "vis": 24,
      "weather": {
        "code": 202,
        "description": "Thunderstorm with heavy rain",
        "icon": "t03d"
      },
      "wind_cdir": "SW",
      "wind_cdir_full": "southwest",
      "wind_dir": 230,
      "wind_gust_spd": 3.2,
      "wind_spd": 1.8
    },
    {
      "app_max_temp": 32.5,
      "app_min_temp": 25.3,
      "clouds": 12,
      "clouds_hi": 49,
      "clouds_low": 9,
      "clouds_mid": 4,
      "datetime": "2026-06-16",
      "dewpt": 17.5,
      "high_temp": 35.2,
      "low_temp": 28.8,
      "max_dhi": null,
      "max_temp": 35.2,
      "min_temp": 22.6,
      "moon_phase": 0.06,
      "moon_phase_lunation": 0.06,
      "moonrise_ts": 1781608590,
      "moonset_ts": 1781663710,
      "ozone": 308,
      "pop": 20,
      "precip": 0.0014724731,
      "pres": 998,
      "rh": 53,
      "slp": 1009,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781603794,
      "sunset_ts": 1781656383,
      "temp": 28.6,
      "ts": 1781582460,
      "uv": 11,
      "valid_date": "2026-06-16",
      "vis": 24,
      "weather": {
        "code": 801,
        "description": "Few clouds",
        "icon": "c02d"
      },
      "wind_cdir": "SW",
      "wind_cdir_full": "southwest",
      "wind_dir": 223,
      "wind_gust_spd": 6.6,
      "wind_spd": 3
    },
    {
      "app_max_temp": 29.7,
      "app_min_temp": 25.2,
      "clouds": 24,
      "clouds_hi": 96,
      "clouds_low": 5,
      "clouds_mid": 0,
      "datetime": "2026-06-17",
      "dewpt": 18.8,
      "high_temp": 31.6,
      "low_temp": 25.8,
      "max_dhi": null,
      "max_temp": 31.6,
      "min_temp": 22.4,
      "moon_phase": 0.13,
      "moon_phase_lunation": 0.1,
      "moonrise_ts": 1781699588,
      "moonset_ts": 1781752654,
      "ozone": 305,
      "pop": 20,
      "precip": 0.08824158,
      "pres": 998,
      "rh": 62,
      "slp": 1009,
      "snow": 0,
      "snow_depth": 0,
      "sunrise_ts": 1781690200,
      "sunset_ts": 1781742802,
      "temp": 26.8,
      "ts": 1781668860,
      "uv": 11,
      "valid_date": "2026-06-17",
      "vis": 24,
      "weather": {
        "code": 802,
        "description": "Scattered clouds",
        "icon": "c02d"
      },
      "wind_cdir": "SSW",
      "wind_cdir_full": "south-southwest",
      "wind_dir": 208,
      "wind_gust_spd": 7,
      "wind_spd": 3.8
    }
  ],
  "lat": 35.7796,
  "lon": -78.6382,
  "state_code": "NC",
  "timezone": "America/New_York"
}

HTTP Statuses

Code Description Example
200 A forecast object. -
204 No Data Found -
400 Client Error 
{
  "error": "Some relevant message"
}
403 Unauthorized/No Access for current plan level 
{
  "error": "Some relevant message"
}
429 Daily or Velocity limit exceeded See rate limit guidance. 
{
  "error": "Rate limit exceeded.",
  "status_code": 429,
  "status_message": "Rate limit exceeded. Try again later."
}
500 Internal Server Error 
{
  "error": "Server Error"
}

Return Fields

Field Data Type Description
city_name string Nearest city name
state_code string State Abbreviation
country_code string Country Abbreviation
lat number Latitude
lon number Longitude
timezone string Local IANA time zone
data array<Forecast>
data[].valid_date string Valid Date
data[].ts number Unix Timestamp
data[].datetime string [DEPRECATED] Deprecated - use 'valid_date'
data[].snow number Accumulated snowfall since last forecast point - default (mm)
data[].snow_depth ['number', 'null'] Snow Depth - default (mm)
data[].precip number Accumulated liquid equivalent precipitation since last forecast point - default (mm)
data[].temp number Temperature (Average) - default (C)
data[].dewpt number Dewpoint (Average) - default (C)
data[].max_temp number Maximum Temperature - Calculated from Midnight to Midnight local time (default Celsius)
data[].min_temp number Minimum Temperature - Calculated from Midnight to Midnight local time (default Celsius)
data[].high_temp number High Temperature or Day-time High - Calculated from 7 AM to 7 PM local time (default Celsius)
data[].low_temp number Low Temperature or Night-time Low - Calculated from 7 PM to 7 AM local time (default Celsius)
data[].app_max_temp number Apparent Maximum daily Temperature (Same as Feels-Like or Heat Index + Wind Chill) - default (C)
data[].app_min_temp number Apparent Minimum daily Temperature (Same as Feels-Like or Heat Index + Wind Chill) - default (C)
data[].rh integer Relative Humidity as a percentage (%)
data[].clouds integer Cloud cover as a percentage (%)
data[].clouds_low integer Low-level (~0-3km AGL) cloud coverage (%)
data[].clouds_mid integer Mid-level (~3-5km AGL) cloud coverage (%)
data[].clouds_hi integer High-level (>5km AGL) cloud coverage (%)
data[].weather object
data[].weather.icon string Icon code for forecast image display
data[].weather.code integer Weather Condition code
data[].weather.description string Weather Condition description
data[].slp number Mean Sea level pressure (mb)
data[].pres number Pressure (mb)
data[].uv number UV Index (0-11+)
data[].ozone number Total column ozone (Dobson units)
data[].max_dhi ['number', 'null'] [DEPRECATED] Max direct component of solar insolation (W/m^2)
data[].vis number Average Visibility default (KM)
data[].pop number Chance of Precipitation as a percentage (%)
data[].moon_phase ['number', 'null'] Moon phase illumination fraction (0-1)
data[].moon_phase_lunation ['number', 'null'] Moon lunation fraction (0 = New moon, 0.50 = Full Moon, 0.75 = Last quarter moon)
data[].sunrise_ts ['integer', 'null'] Sunrise unix timestamp
data[].sunset_ts ['integer', 'null'] Sunset unix timestamp
data[].moonrise_ts ['integer', 'null'] Moonrise unix timestamp
data[].moonset_ts ['integer', 'null'] Moonset unix timestamp
data[].pod string Part of the day (d = day, n = night)
data[].wind_spd number 10m wind Speed (default m/s)
data[].wind_dir integer 10m wind direction - Degrees clockwise from 0 = North
data[].wind_cdir string Cardinal wind direction
data[].wind_cdir_full string Cardinal wind direction (text)
data[].wind_gust_spd number Wind Gust Speed (default m/s)
Get API Key View Pricing Swagger JSON

Overview

Weather API's

Resources

Support