Hourly Weather Forecast API - 240 hours

This API returns an 2-10 day (48-240 hours) forecast in 1 hour intervals for any point on the planet. A 48 hour/hourly forecast is returned as the default, without any parameters. Forecasts update approximately once per hour.

Returns up to 240 hours (10 days/hourly). Ie. hours=240.

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

Base URL

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

Request Parameters

key=[key] (REQUIRED)
  • key - Your API Key.
lang=[language](optional)
  • en - [DEFAULT] English
  • ar - Arabic
  • az - Azerbaijani
  • be - Belarusian
  • bg - Bulgarian
  • bs - Bosnian
  • ca - Catalan
  • cz - Czech
  • da - Danish
  • de - German
  • fi - Finnish
  • fr - French
  • el - Greek
  • es - Spanish
  • et - Estonian
  • ja - Japanese
  • hr - Croation
  • hu - Hungarian
  • id - Indonesian
  • it - Italian
  • is - Icelandic
  • iw - Hebrew
  • kw - Cornish
  • lt - Lithuanian
  • nb - Norwegian BokmÃ¥l
  • nl - Dutch
  • pl - Polish
  • pt - Portuguese
  • ro - Romanian
  • ru - Russian
  • sk - Slovak
  • sl - Slovenian
  • sr - Serbian
  • sv - Swedish
  • tr - Turkish
  • uk - Ukrainian
  • zh - Chinese (Simplified)
  • zh-tw - Chinese (Traditional)
units=[units](optional)
  • M - [DEFAULT] Metric (Celcius, m/s, mm)
  • S - Scientific (Kelvin, m/s, mm)
  • I - Fahrenheit (F, mph, in)
hours=[integer] (optional: return a specific number of forecast hours)
  • 1-240 hours - [DEFAULT] 48 hours

API Endpoints

Description Required Parameters Example(s)
Get forecast by lat/lon (Recommended) lat,lon &lat=38.123&lon=-78.543
Get forecast by city name city, state(optional), country (optional)
  • &city=Raleigh&country=US
  • &city=Raleigh,NC
  • &city=Raleigh,North+Carolina
Get forecast by postal code postal_code, country (optional) &postal_code=27601&country=US
Get forecast by Station station
  • &station=KRDU
Get forecast by city id city_id &city_id=8953360

Example Request:

https://api.weatherbit.io/v2.0/forecast/hourly?lat=47.6061&lon=-122.3328&key=API_KEY&hours=240

Example Response (JSON):


             {
              "city_name": "Seattle",
              "country_code": "US",
              "data": [
                {
                  "app_temp": 15.6,
                  "clouds": 93,
                  "clouds_hi": 0,
                  "clouds_low": 100,
                  "clouds_mid": 0,
                  "datetime": "2025-09-12:12",
                  "dewpt": 13.4,
                  "dhi": 0,
                  "dni": 0,
                  "ghi": 0,
                  "ozone": 284,
                  "pod": "n",
                  "pop": 0,
                  "precip": 0,
                  "pres": 1013,
                  "rh": 87,
                  "slp": 1017,
                  "snow": 0,
                  "snow_depth": 0,
                  "solar_rad": 0,
                  "temp": 15.6,
                  "timestamp_local": "2025-09-12T05:00:00",
                  "timestamp_utc": "2025-09-12T12:00:00",
                  "ts": 1757678400,
                  "uv": 0,
                  "vis": 13.6,
                  "weather": {
                    "code": 804,
                    "description": "Overcast clouds",
                    "icon": "c04n"
                  },
                  "wind_cdir": "S",
                  "wind_cdir_full": "south",
                  "wind_dir": 190,
                  "wind_gust_spd": 2.1,
                  "wind_spd": 0.8
                },
                {
                  "app_temp": 15.5,
                  "clouds": 89,
                  "clouds_hi": 0,
                  "clouds_low": 100,
                  "clouds_mid": 0,
                  "datetime": "2025-09-12:13",
                  "dewpt": 13.3,
                  "dhi": 0,
                  "dni": 0,
                  "ghi": 0,
                  "ozone": 283,
                  "pod": "n",
                  "pop": 0,
                  "precip": 0,
                  "pres": 1013,
                  "rh": 87,
                  "slp": 1017,
                  "snow": 0,
                  "snow_depth": 0,
                  "solar_rad": 0,
                  "temp": 15.5,
                  "timestamp_local": "2025-09-12T06:00:00",
                  "timestamp_utc": "2025-09-12T13:00:00",
                  "ts": 1757682000,
                  "uv": 0,
                  "vis": 13.3,
                  "weather": {
                    "code": 804,
                    "description": "Overcast clouds",
                    "icon": "c04n"
                  },
                  "wind_cdir": "SW",
                  "wind_cdir_full": "southwest",
                  "wind_dir": 230,
                  "wind_gust_spd": 1.7,
                  "wind_spd": 0.8
                }, ... 
              ],
              "lat": 47.6061,
              "lon": -122.3328,
              "state_code": "WA",
              "timezone": "America/Los_Angeles"
            }
        

Field Decriptions:

  • lat: Latitude (Degrees).
  • lon: Longitude (Degrees).
  • timezone: Local IANA Timezone.
  • city_name: City name.
  • country_code: Country abbreviation.
  • state_code: State abbreviation/code.
  • data: [
    • ts: Unix Timestamp at UTC time.
    • timestamp_local: Timestamp at local time.
    • timestamp_utc: Timestamp at UTC time.
    • datetime: [DEPRECATED - use "timestamp_utc"] Forecast Valid hour UTC (YYYY-MM-DD:HH).
    • wind_gust_spd: Wind gust speed (Default m/s).
    • wind_spd: Wind speed (Default m/s).
    • wind_dir: Wind direction (degrees).
    • wind_cdir: Abbreviated wind direction.
    • wind_cdir_full: Verbal wind direction.
    • temp: Temperature (default Celcius).
    • app_temp: Apparent/"Feels Like" temperature (default Celcius).
    • pop: Probability of Precipitation (%).
    • precip: Accumulated liquid equivalent precipitation (default mm).
    • snow: Accumulated snowfall (default mm).
    • snow_depth: Snow Depth (default mm).
    • slp: Sea level pressure (mb).
    • pres: Pressure (mb).
    • dewpt: Dew point (default Celcius).
    • rh: Relative humidity (%).
    • clouds_low: Low-level (~0-3km AGL) cloud coverage (%).
    • clouds_mid: Mid-level (~3-5km AGL) cloud coverage (%).
    • clouds_hi: High-level (>5km AGL) cloud coverage (%).
    • clouds: Cloud coverage (%).
    • weather: { }
    • pod: Part of the day (d = day / n = night).
    • uv: UV Index (0-11+).
    • dhi: Diffuse horizontal solar irradiance (W/m^2) [Clear Sky]
    • dni: Direct normal solar irradiance (W/m^2) [Clear Sky]
    • ghi: Global horizontal solar irradiance (W/m^2) [Clear Sky]
    • solar_rad: Estimated Solar Radiation (W/m^2).
    • vis: Visibility (default KM).
    • ozone: Average Ozone (Dobson units).
  • ... ]