Hourly Historical Weather

This API returns historical weather data from our network of over 120,000 stations reporting hourly weather data. This is hourly historical data, and a request will return data from data sources within ~15 km of the requested point. This API returns hourly data. For daily historical data, see the Daily Historical Weather API.

The following per API request limitations apply (See: pricing):

Trial Plan: 1 day per API request.
^*Plus / Business / Enterprise plans: 10 days of data per API request.
Other plan(s): No access

^*For convenience, up to 1 month of data can be requested per API request. However, requests that exceed 10 days will count as multiple requests against the plan daily quota. Example: 30 days = 3 requests, 14 days = 2 requests.

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

Base URL

HTTP: http://api.weatherbit.io/v2.0/history/hourly

HTTPS: https://api.weatherbit.io/v2.0/history/hourly

Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)

key - Your API Key.

start_date=[YYYY-MM-DD OR YYYY-MM-DD:HH] (REQUIRED)

end_date=[YYYY-MM-DD OR YYYY-MM-DD:HH] (REQUIRED)

tz=[utc OR local](optional)

utc - [DEFAULT] Assumes UTC for start_date, end_date
local - Assumes LOCAL time for start_date, end_date

lang=[language](optional)

en - [DEFAULT] English

units=[units](optional)

M - [DEFAULT] Metric (Celsius, m/s, mm)
S - Scientific (Kelvin, m/s, mm)
I - Fahrenheit (F, mph, in)

API Endpoints

Description	Required Parameters	Example(s)
Get history by lat/lon (Recommended)	lat, lon, start_date, end_date	&lat=38.123&lon=-78.543&start_date=2024-11-17&end_date=2024-11-18
Get history by city name	city, state(optional - US only), country (optional), start_date, end_date	&city=Raleigh,NC&start_date=2024-11-17&end_date=2024-11-18
Get history by postal code	postal_code, country (optional), start_date, end_date	&postal_code=27601&country=US&start_date=2024-11-17&end_date=2024-11-18
Get history by city id	city_id, start_date, end_date	&city_id=8953360&start_date=2024-11-17&end_date=2024-11-18
Get history by ICAO or station id [Use with Caution]	station, start_date, end_date	&station=KRDU&start_date=2024-11-17&end_date=2024-11-18

Example Request:

https://api.weatherbit.io/v2.0/history/hourly?lat=35.775&lon=-78.638&start_date=2024-11-17&end_date=2024-11-18&tz=local&key=API_KEY

Example Response (JSON):


          {  
             "timezone":"America\/New_York",
             "state_code":"NC",
             "lat":35.7721,
             "lon":-78.63861,
             "country_code":"US",
             "station_id":"723060-13722",
             "sources":["723060-13722", "USC00445050", "USW00013732"],
             "data":[  
                {  
                   "rh":32,
                   "wind_spd":6.7,
                   "wind_gust_spd": 9.4,
                   "slp":1020.3,
                   "h_angle":15,
                   "azimuth":25,
                   "dewpt":-7.5,
                   "snow":0,
                   "uv":0,
                   "wind_dir":220,
                   "weather":{  
                      "icon":"c01n",
                      "code":"800",
                      "description":"Clear sky"
                   },
                   "pod":"n",
                   "vis":1.5,
                   "precip":0,
                   "elev_angle":-33,
                   "ts":1483232400,
                   "pres":1004.7,
                   "datetime":"2018-05-01:06",
                   "timestamp_utc":"2015-05-01T06:00:00",
                   "timestamp_local":"2015-05-01T02:00:00",
                   "revision_status":"final",
                   "temp":8.3,
                   "dhi":15,
                   "dni":240.23,
                   "ghi":450.9,
                   "solar_rad":445.85,
                   "clouds":0
                }, ... 
             ],
             "city_name":"Raleigh",
             "city_id":"4487042"
          }

Field Decriptions:

lat: Latitude (Degrees).
lon: Longitude (Degrees).
timezone: Local IANA Timezone.
city_name: City name.
city_id: City ID.
country_code: Country abbreviation.
state_code: State abbreviation/code.
station_id:[DEPRECATED] Nearest station.
sources: List of data sources used in response.
data: [

datetime: Date UTC (YYYY-MM-DD:HH). [Deprecated]
ts: Timestamp (Unix Timestamp).
timestamp_local: Timestamp at Local time.
timestamp_utc: Timestamp at UTC time.
revision_status Data revision status - interim (subject to revisions) or final.
pres: Pressure (mb).
slp: Sea level pressure (mb).
wind_spd: Wind speed (Default m/s).
wind_gust_spd: Wind gust speed (Default m/s).
wind_dir: Wind direction (degrees).
temp: Temperature (default Celsius).
app_temp: Apparent/"Feels Like" temperature (default Celsius).
rh: Relative humidity (%).
dewpt: Dew point (default Celsius).
clouds:[Satellite based] cloud coverage (%).
pod: Part of the day (d = day / n = night).
weather: {
- icon: Weather icon code.
- code: Weather code.
- description: Text weather description.
}
vis: Visibility (default KM).
precip: Accumulated liquid equivalent precipitation (default mm).
snow: Accumulated snowfall (default mm).
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).
uv: UV Index (0-11+).
elev_angle: Solar elevation angle (degrees).
azimuth: Solar azimuth angle (degrees).
h_angle: [DEPRECATED] Solar hour angle (degrees).

... ]

View more API's

View pricing

Hourly Historical Weather

Base URL

Request Parameters

API Endpoints

Example Request:

Example Response (JSON):

Field Decriptions:

Overview

Weather API's

Resources

Support