Bulk Historical Weather API (hourly) [Enterprise plans only]

This API returns historical weather data from our network of over 45,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 users that need data exceeding 1 month in length. For bulk daily historical data, see the Bulk Daily Historical Weather API.

The following subscriptions may access this API (See: pricing):

  • Enterprise Plan(s)

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

Base URL

HTTP: http://api.weatherbit.io/v2.0/bulk/history/hourly
HTTPS: https://api.weatherbit.io/v2.0/bulk/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)
units=[units](optional)
lang=[language](optional)
  • en - [DEFAULT] English
  • ar - Arabic
  • az - Azerbaijani
  • be - Belarusian
  • bg - Bulgarian
  • bs - Bosnian
  • ca - Catalan
  • cz - Czech
  • da - Danish
  • de - German
  • fi - Finnish
  • fr - French
  • el - Greek
  • et - Estonian
  • hr - Croation
  • hu - Hungarian
  • id - Indonesian
  • it - Italian
  • is - Icelandic
  • kw - Cornish
  • lt - Lithuanian
  • nb - Norwegian BokmÃ¥l
  • nl - Dutch
  • pl - Polish
  • pt - Portuguese
  • ro - Romanian
  • ru - Russian
  • sk - Slovak
  • sl - Slovenian
  • sr - Serbian
  • sv - Swedish
  • tr - Turkish
  • uk - Ukrainian
  • zh - 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)
callback=[function] (optional: JSON-P callback)

API Endpoints (Bulk)

Description Required Parameters Example(s)
Get history by lat/lon lat, lon, start_date, end_date &lat=38.123&lon=-78.543&start_date=2017-01-01&end_date=2017-01-02
Get history by city name city, state(optional), country (optional), start_date, end_date &city=Raleigh,NC&start_date=2017-01-01&end_date=2017-01-02
Get history by postal code postal_code, country (optional), start_date, end_date &postal_code=27601&country=US&start_date=2017-01-01&end_date=2017-01-02
Get history by IP address ip, start_date, end_date &ip=auto&start_date=2017-01-01&end_date=2017-01-02
Get history by city id city_id, start_date, end_date &city_id=8953360&start_date=2017-01-01&end_date=2017-01-02
Get history by ICAO or station id station, start_date, end_date &station=KRDU&start_date=2017-01-01&end_date=2017-01-02

Example Request:

https://api.weatherbit.io/v2.0/bulk/history/hourly?city=Raleigh,NC&start_date=2016-01-01&end_date=2017-01-01&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":20,
                   "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":"2016-01-01: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).
    • ts: Timestamp (Unix Timestamp).
    • 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).
  • ... ]