v1

latestSwagger 2.02026-07-132137180.4 KB

Daily Historical Weather Data

Returns Historical Observations - Given a lat/lon.

Returns Historical Observations - Given a lat, and lon. See https://www.weatherbit.io/api for API specific rate limits.

get/history/daily

Query parameters

latnumber double

Latitude component of location.

lonnumber double

Longitude component of location.

citystring string

City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR

postal_codestring string

Postal Code. Example: 28546

countrystring string

Country Code (2 letter) - to be used with postal_code.

stationstring string

Station Call ID.

start_datestring string required

Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).

end_datestring string required

End Date (YYYY-MM-DD or YYYY-MM-DD:HH).

units'S' | 'I' | 'M' string

Convert to units. Default Metric. Options (I = Imperial, M = Metric, S = Scientific)

lang'ar' | 'az' | 'be' | 'bg' | 'bs' | 'ca' | 'cs' | 'de' | 'fi' | 'fr' | 'el' | 'es' | 'et' | 'hr' | 'hu' | 'id' | 'it' | 'is' | 'kw' | 'nb' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'tr' | 'uk' | 'zh' | 'zh-tw' string

Language (Default: English) See <a target='blank' href='/api/requests'>language field description</a>

keystring string required

Your registered API key.

Response

An Historical Day Data Object.

city_namestring

Nearest city name

state_codestring

State abbreviation

country_codestring

Country abbreviation

timezonestring

Local IANA time zone

latnumber

Latitude

lonnumber

Longitude

city_idstring

Nearest city ID

sourcesstring[]

List of data sources used in response

station_idstring

[DEPRECATED] Deprecated - use 'sources'

Example response

{
  "city_name": "Seattle",
  "state_code": "WA",
  "country_code": "US",
  "timezone": "America/New_York",
  "lat": 47.61,
  "lon": -122.33,
  "city_id": "4487042",
  "sources": [
    "12345-89083"
  ],
  "station_id": "12345-999999",
  "data": [
    {
      "datetime": "2015-01-03",
      "ts": 1501970516,
      "revision_status": "final",
      "revision_version": "1.1",
      "slp": 1020.1,
      "pres": 885.1,
      "rh": 85,
      "dewpt": -1.5,
      "temp": 1,
      "max_temp": 1.5,
      "max_temp_ts": 1501970816,
      "min_temp": 11.7,
      "min_temp_ts": 1501970516,
      "wind_spd": 14.98,
      "wind_dir": 325,
      "wind_gust_spd": 40.98,
      "max_wind_spd": 19.98,
      "max_wind_dir": 325,
      "max_wind_spd_ts": 1501970516,
      "clouds": 76,
      "ghi": 125,
      "t_ghi": 4500,
      "dni": 125,
      "t_dni": 4500,
      "dhi": 125,
      "max_ghi": 1018,
      "max_dni": 931,
      "max_dhi": 124,
      "t_dhi": 4500,
      "solar_rad": 100,
      "t_solar_rad": 2400,
      "max_uv": 6,
      "precip": 3,
      "precip_gpm": 3,
      "snow": 30,
      "snow_depth": 60
    }
  ]
}