Current Weather API

This API returns current conditions from our network of sub-hourly reporting weather stations, as well as relevant atmospheric meso-analyses (For example, the RTMA). Every API request will return the nearest, and most recent observation.

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

Note: This API endpoint is designed specifically for retrieving current weather conditions only. It is not suitable for archiving data. If you attempt to archive data from this API, it may be incomplete, lack our data enrichment process, and be subject to potential inconsistencies. The data is only quality controlled with basic checks. Therefore, we do not provide any support or warranty for data archived locally using this endpoint. For the highest quality historical weather observations, please use our dedicated Historical Weather API.

Base URL

HTTP: http://api.weatherbit.io/v2.0/current

HTTPS: https://api.weatherbit.io/v2.0/current

Supported Methods: GET

Request Parameters

key=[key] (REQUIRED)

key - Your API Key.

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
es - Spanish
et - Estonian
ja - Japanese
hr - Croation
hu - Hungarian
id - Indonesian
it - Italian
is - Icelandic
iw - Hebrew
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 (Celsius, m/s, mm)
S - Scientific (Kelvin, m/s, mm)
I - Fahrenheit (F, mph, in)

include=minutely,alerts (optional: Include a 1 hour / minutely forecast , and severe weather alert in the response)*

*Counts as an extra request against quota.

API Endpoints

Description	Required Parameters	Example(s)
Get observation by lat/lon (Recommended)	lat,lon	&lat=38.123&lon=-78.543
Get observation by city name	city, state(optional), country (optional)	&city=Raleigh&country=US &city=Raleigh,NC &city=Raleigh,North+Carolina
Get observation by postal code	postal_code, country (optional)	&postal_code=27601&country=US
Get observation by city id's	city_id	&city_id=8953360
Get observation by ICAO or station id [Use with Caution]	station	&station=KRDU
Get multiple observations from a list of city id's	cities	&cities=8953360,8953361,8953362
Get multiple observations by airport ICAO's, or station id's [Use with Caution]	stations	&stations=KRDU,KSEA,LEBB
Get multiple observations by lat/lon(s). Format: "(lat1, lon1),(lat2, lon2), ..."	points	&points=(35.88,-78.79),(47.45,-122.3),(43.3,-2.93)

= Business subscription required, limit 200 per request. Max requests limit of 5 batch requests per second per account. Batch requests count as multiple against daily quotas.

Example Request:

https://api.weatherbit.io/v2.0/current?lat=35.7796&lon=-78.6382&key=API_KEY&include=minutely

Example Response (JSON):


            {  
               "data":[  
                  {  
                     "wind_cdir":"NE",
                     "rh":59,
                     "pod":"d",
                     "lon":-78.63861,
                     "pres":1006.6,
                     "timezone":"America\/New_York",
                     "ob_time":"2017-08-28 16:45",
                     "country_code":"US",
                     "clouds":75,
                     "vis":10,
                     "wind_spd":6.17,
                     "gust": 8,
                     "wind_cdir_full":"northeast",
                     "app_temp":24.25,
                     "state_code":"NC",
                     "ts":1503936000,
                     "h_angle":0,
                     "dewpt":15.65,
                     "weather":{  
                        "icon":"c03d",
                        "code": 803,
                        "description":"Broken clouds"
                     },
                     "uv":2,
                     "aqi":45,
                     "station":"CMVN7",
                     "sources": ["rtma", "CMVN7"],
                     "wind_dir":50,
                     "elev_angle":63,
                     "datetime":"2017-08-28:17",
                     "precip":0,
                     "ghi":444.4,
                     "dni":500,
                     "dhi":120,
                     "solar_rad":350,
                     "city_name":"Raleigh",
                     "sunrise":"10:44",
                     "sunset":"23:47",
                     "temp":24.19,
                     "lat":35.7721,
                     "slp":1022.2
                  }
               ],
               "minutely":[ ... ],
               "count":1
            }

Field Decriptions:

count: Count of returned observations.
data: [

lat: Latitude (Degrees).
lon: Longitude (Degrees).
sunrise: Sunrise time UTC (HH:MM).
sunset: Sunset time UTC (HH:MM).
timezone: Local IANA Timezone.
station: [DEPRECATED] Nearest reporting station ID.
sources: List of data sources used in response.
ob_time: Last observation time (YYYY-MM-DD HH:MM).
datetime: [DEPRECATED] Current cycle hour (YYYY-MM-DD:HH).
ts: Last observation time (Unix timestamp).
city_name: City name.
country_code: Country abbreviation.
state_code: State abbreviation/code.
pres: Pressure (mb).
slp: Sea level pressure (mb).
wind_spd: Wind speed (Default m/s).
gust: Wind gust speed (Default m/s).
wind_dir: Wind direction (degrees).
wind_cdir: Abbreviated wind direction.
wind_cdir_full: Verbal wind direction.
temp: Temperature (default Celsius).
app_temp: Apparent/"Feels Like" temperature (default Celsius).
rh: Relative humidity (%).
dewpt: Dew point (default Celsius).
clouds: 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: Liquid equivalent precipitation rate (default mm/hr).
snow: Snowfall (default mm/hr).
uv: UV Index (0-11+).
aqi: Air Quality Index [US - EPA standard 0 - +500]
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).
elev_angle: Solar elevation angle (degrees).
h_angle: [DEPRECATED] Solar hour angle (degrees).

View more API's

View pricing

Current Weather API

Base URL

Request Parameters

API Endpoints

Example Request:

Example Response (JSON):

Field Decriptions:

Overview

Weather API's

Resources

Support