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
Request Parameters
key
- Your API Key.
utc
- [DEFAULT] Assumes UTC for start_date, end_datelocal
- 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-11-08&end_date=2024-11-09 |
Get history by city name | city, state(optional - US only), country (optional), start_date, end_date | &city=Raleigh,NC&start_date=2024-11-08&end_date=2024-11-09 |
Get history by postal code | postal_code, country (optional), start_date, end_date | &postal_code=27601&country=US&start_date=2024-11-08&end_date=2024-11-09 |
Get history by city id | city_id, start_date, end_date | &city_id=8953360&start_date=2024-11-08&end_date=2024-11-09 |
Get history by ICAO or station id [Use with Caution] | station, start_date, end_date | &station=KRDU&start_date=2024-11-08&end_date=2024-11-09 |
Example Request:
https://api.weatherbit.io/v2.0/history/hourly?lat=35.775&lon=-78.638&start_date=2024-11-08&end_date=2024-11-09&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).... ]