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] Englishar- Arabicaz- Azerbaijanibe- Belarusianbg- Bulgarianbs- Bosnianca- Catalancz- Czechda- Danishde- Germanfi- Finnishfr- Frenchel- Greekes- Spanishet- Estonianja- Japanesehr- Croationhu- Hungarianid- Indonesianit- Italianis- Icelandiciw- Hebrewkw- Cornishlt- Lithuaniannb- Norwegian Bokmålnl- Dutchpl- Polishpt- Portuguesero- Romanianru- Russiansk- Slovaksl- Sloveniansr- Serbiansv- Swedishtr- Turkishuk- Ukrainianzh- 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) |
|
| Get forecast by postal code | postal_code, country (optional) | &postal_code=27601&country=US |
| Get forecast by Station | station |
|
| 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: {icon:Weather icon code.code:Weather code.description:Text weather description.
} 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).... ]