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.
tz=[utc OR local](optional)
  • utc - [DEFAULT] Assumes UTC for start_date, end_date
  • local - Assumes LOCAL time for start_date, end_date
  • en - [DEFAULT] English
  • 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-07-21&end_date=2024-07-22
Get history by city name city, state(optional), country (optional), start_date, end_date &city=Raleigh,NC&start_date=2024-07-21&end_date=2024-07-22
Get history by postal code postal_code, country (optional), start_date, end_date &postal_code=27601&country=US&start_date=2024-07-21&end_date=2024-07-22
Get history by city id city_id, start_date, end_date &city_id=8953360&start_date=2024-07-21&end_date=2024-07-22
Get history by ICAO or station id [Use with Caution] station, start_date, end_date &station=KRDU&start_date=2024-07-21&end_date=2024-07-22

Example Request:


Example Response (JSON):

             "sources":["723060-13722", "USC00445050", "USW00013732"],
                   "wind_gust_spd": 9.4,
                      "description":"Clear sky"
                }, ... 


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).
  • ... ]