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?city=Raleigh,NC&key=API_KEY&hours=48
Example Response (JSON):
{
"data":[
{
"timestamp_local": "2018-04-02T00:00:00",
"timestamp_utc": "2018-04-03T04:00:00",
"ts":1503954000,
"datetime":"2017-04-03:04",
"wind_gust_spd":16.7,
"wind_spd":6.4,
"wind_dir":45,
"wind_cdir":"NE",
"wind_cdir_full":"northeast",
"temp":25,
"app_temp":23,
"pop":0,
"precip":0,
"snow":0,
"snow_depth":0,
"slp":1017,
"pres":1003.5,
"dewpt":17.8,
"rh":64.3,
"weather":{
"icon":"c04d",
"code":"804",
"description":"Overcast clouds"
},
"pod":"d",
"clouds_low":25,
"clouds_mid":100,
"clouds_hi":50,
"clouds":100,
"vis":10,
"dhi":178,
"dni":3,
"ghi":200,
"solar_rad":75.8,
"uv":2,
"ozone":384.5
}, ...
],
"city_name":"Raleigh",
"lon":"-78.63861",
"timezone":"America\/New_York",
"lat":"35.7721",
"country_code":"US",
"state_code":"NC"
}
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] 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).... ]