Current Weather API

This API returns current conditions from our network of over 45,000 sub-hourly reporting weather stations. 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: Archiving data from this API may lead to data inconsistencies, and is not recommended. For analytical usage we recommend using the hourly historical weather API, or the daily 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
  • 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

Description Required Parameters Example(s)
Get observation by lat/lon 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 airport ICAO, or station id station &station=KSEA
Get multiple observations from a list of city id's (Limit 100 / request) cities &cities=8953360,8953361,8953362
Get multiple observations by airport ICAO's, or station id's (Limit 100 / request) stations &stations=KRDU,KSEA,LEBB
= Advanced/Enterprise subscriptions only.

Example Request:

https://api.weatherbit.io/v2.0/current?city=Raleigh,NC&key=API_KEY

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,
                     "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",
                     "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
                  }
               ],
               "count":1
            }
        

Field Decriptions:

  • count: Count of returned observations.
  • data: [
    • lat: Latitude (Degrees).
    • lon: Longitude (Degrees).
    • sunrise: Sunrise time (HH:MM).
    • sunset: Sunset time (HH:MM).
    • timezone: Local IANA Timezone.
    • station: Source station ID.
    • ob_time: Last observation time (YYYY-MM-DD HH:MM).
    • datetime: 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).
    • wind_dir: Wind direction (degrees).
    • wind_cdir: Abbreviated wind direction.
    • wind_cdir_full: Verbal wind direction.
    • temp: Temperature (default Celcius).
    • app_temp: Apparent/"Feels Like" temperature (default Celcius).
    • rh: Relative humidity (%).
    • dewpt: Dew point (default Celcius).
    • clouds: Cloud coverage (%).
    • pod: Part of the day (d = day / n = night).
    • weather: { }
    • 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: Solar hour angle (degrees).
  • ]