Historical Weather API (hourly)

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 the nearest reporting station. This API returns hourly data. For daily historical data, see the Daily Historical Weather API.

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

  • Free plan: Max 1 day (24 hours) of data per API call.
  • Starter Plan: No Access.
  • Advanced/Developer plans: Max 7 days (168 hours) of data per API call.

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 (Celcius, m/s, mm)
  • S - Scientific (Kelvin, m/s, mm)
  • I - Fahrenheit (F, mph, in)
callback=[function] (optional: JSON-P callback)

API Endpoints

Description Required Parameters Example(s)
Get history by lat/lon lat, lon, start_date, end_date &lat=38.123&lon=-78.543&start_date=2018-12-11&end_date=2018-12-12
Get history by city name city, state(optional), country (optional), start_date, end_date &city=Raleigh,NC&start_date=2018-12-11&end_date=2018-12-12
Get history by postal code postal_code, country (optional), start_date, end_date &postal_code=27601&country=US&start_date=2018-12-11&end_date=2018-12-12
Get history by city id city_id, start_date, end_date &city_id=8953360&start_date=2018-12-11&end_date=2018-12-12
Get history by ICAO or station id station, start_date, end_date &station=KRDU&start_date=2018-12-11&end_date=2018-12-12
= Premium subscriptions only.

Example Request:

https://api.weatherbit.io/v2.0/history/hourly?city=Raleigh,NC&start_date=2018-12-11&end_date=2018-12-12&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,
                   "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",
                   "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: Nearest station. [Deprecated]
  • sources: List of stations 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.
    • pres: Pressure (mb).
    • slp: Sea level pressure (mb).
    • wind_spd: Wind speed (Default m/s).
    • wind_dir: Wind direction (degrees).
    • temp: Temperature (default Celcius).
    • rh: Relative humidity (%).
    • dewpt: Dew point (default Celcius).
    • 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: Solar hour angle (degrees).
  • ... ]