One Call API 3.0

How to make an API call

API call

Example of API call

If you you want to exclude some parts of the weather data from the API response please add exclude parameter to the API call like in the example below:

If you do not need to exclude any of the weather data from the API response please use API call like in the example below:

Example of API response

                
{
   "lat":33.44,
   "lon":-94.04,
   "timezone":"America/Chicago",
   "timezone_offset":-18000,
   "current":{
      "dt":1684929490,
      "sunrise":1684926645,
      "sunset":1684977332,
      "temp":292.55,
      "feels_like":292.87,
      "pressure":1014,
      "humidity":89,
      "dew_point":290.69,
      "uvi":0.16,
      "clouds":53,
      "visibility":10000,
      "wind_speed":3.13,
      "wind_deg":93,
      "wind_gust":6.71,
      "weather":[
         {
            "id":803,
            "main":"Clouds",
            "description":"broken clouds",
            "icon":"04d"
         }
      ]
   },
   "minutely":[
      {
         "dt":1684929540,
         "precipitation":0
      },
      ...
   ],
   "hourly":[
      {
         "dt":1684926000,
         "temp":292.01,
         "feels_like":292.33,
         "pressure":1014,
         "humidity":91,
         "dew_point":290.51,
         "uvi":0,
         "clouds":54,
         "visibility":10000,
         "wind_speed":2.58,
         "wind_deg":86,
         "wind_gust":5.88,
         "weather":[
            {
               "id":803,
               "main":"Clouds",
               "description":"broken clouds",
               "icon":"04n"
            }
         ],
         "pop":0.15
      },
      ...
   ],
   "daily":[
      {
         "dt":1684951200,
         "sunrise":1684926645,
         "sunset":1684977332,
         "moonrise":1684941060,
         "moonset":1684905480,
         "moon_phase":0.16,
         "summary":"Expect a day of partly cloudy with rain",
         "temp":{
            "day":299.03,
            "min":290.69,
            "max":300.35,
            "night":291.45,
            "eve":297.51,
            "morn":292.55
         },
         "feels_like":{
            "day":299.21,
            "night":291.37,
            "eve":297.86,
            "morn":292.87
         },
         "pressure":1016,
         "humidity":59,
         "dew_point":290.48,
         "wind_speed":3.98,
         "wind_deg":76,
         "wind_gust":8.92,
         "weather":[
            {
               "id":500,
               "main":"Rain",
               "description":"light rain",
               "icon":"10d"
            }
         ],
         "clouds":92,
         "pop":0.47,
         "rain":0.15,
         "uvi":9.23
      },
      ...
   ],
    "alerts": [
    {
      "sender_name": "NWS Philadelphia - Mount Holly (New Jersey, Delaware, Southeastern Pennsylvania)",
      "event": "Small Craft Advisory",
      "start": 1684952747,
      "end": 1684988747,
      "description": "...SMALL CRAFT ADVISORY REMAINS IN EFFECT FROM 5 PM THIS\nAFTERNOON TO 3 AM EST FRIDAY...\n* WHAT...North winds 15 to 20 kt with gusts up to 25 kt and seas\n3 to 5 ft expected.\n* WHERE...Coastal waters from Little Egg Inlet to Great Egg\nInlet NJ out 20 nm, Coastal waters from Great Egg Inlet to\nCape May NJ out 20 nm and Coastal waters from Manasquan Inlet\nto Little Egg Inlet NJ out 20 nm.\n* WHEN...From 5 PM this afternoon to 3 AM EST Friday.\n* IMPACTS...Conditions will be hazardous to small craft.",
      "tags": [

      ]
    },
    ...
  ]
                
              

Fields in API response

• lat Latitude of the location, decimal (−90; 90)
• lon Longitude of the location, decimal (-180; 180)
• timezone Timezone name for the requested location
• timezone_offset Shift in seconds from UTC
• current Current weather data API response
  • current.dt Current time, Unix, UTC
  • current.sunrise Sunrise time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the response
  • current.sunset Sunset time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the response
  • current.temp Temperature. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units used
  • current.feels_like Temperature. This temperature parameter accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.
  • current.pressure Atmospheric pressure on the sea level, hPa
  • current.humidity Humidity, %
  • current.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.
  • current.clouds Cloudiness, %
  • current.uvi Current UV index
  • current.visibility Average visibility, metres. The maximum value of the visibility is 10km
  • current.wind_speed Wind speed. Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units used
  • current.wind_gust (where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units used
  • current.wind_deg Wind direction, degrees (meteorological)
  • current.rain
    • current.rain.1h (where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
  • current.snow
    • current.snow.1h (where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
  • current.weather
    • current.weather.id Weather condition id
    • current.weather.main Group of weather parameters (Rain, Snow, Clouds etc.)
    • current.weather.description Weather condition within the group (full list of weather conditions). Get the output in your language
    • current.weather.icon Weather icon id. How to get icons
• minutely Minute forecast weather data API response
  • minutely.dt Time of the forecasted data, unix, UTC
  • minutely.precipitation Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
• hourly Hourly forecast weather data API response
  • hourly.dt Time of the forecasted data, Unix, UTC
  • hourly.temp Temperature. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units used
  • hourly.feels_like Temperature. This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.
  • hourly.pressure Atmospheric pressure on the sea level, hPa
  • hourly.humidity Humidity, %
  • hourly.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.
  • hourly.uvi UV index
  • hourly.clouds Cloudiness, %
  • hourly.visibility Average visibility, metres. The maximum value of the visibility is 10km
  • hourly.wind_speed Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour.How to change units used
  • hourly.wind_gust (where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units used
  • hourly.wind_deg Wind direction, degrees (meteorological)
  • hourly.pop Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%
  • hourly.rain
    • hourly.rain.1h (where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
  • hourly.snow
    • hourly.snow.1h (where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
  • hourly.weather
    • hourly.weather.id Weather condition id
    • hourly.weather.main Group of weather parameters (Rain, Snow, Clouds etc.)
    • hourly.weather.description Weather condition within the group (full list of weather conditions). Get the output in your language
    • hourly.weather.icon Weather icon id. How to get icons
• daily Daily forecast weather data API response
  • daily.dt Time of the forecasted data, Unix, UTC
  • daily.sunrise Sunrise time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the response
  • daily.sunset Sunset time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the response
  • daily.moonrise The time of when the moon rises for this day, Unix, UTC
  • daily.moonset The time of when the moon sets for this day, Unix, UTC
  • daily.moon_phase Moon phase. 0 and 1 are 'new moon', 0.25 is 'first quarter moon', 0.5 is 'full moon' and 0.75 is 'last quarter moon'. The periods in between are called 'waxing crescent', 'waxing gibbous', 'waning gibbous', and 'waning crescent', respectively. Moon phase calculation algorithm: if the moon phase values between the start of the day and the end of the day have a round value (0, 0.25, 0.5, 0.75, 1.0), then this round value is taken, otherwise the average of moon phases for the start of the day and the end of the day is taken.
  • summaryHuman-readable description of the weather conditions for the day
  • daily.temp Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units used
    • daily.temp.morn Morning temperature.
    • daily.temp.day Day temperature.
    • daily.temp.eve Evening temperature.
    • daily.temp.night Night temperature.
    • daily.temp.min Min daily temperature.
    • daily.temp.max Max daily temperature.
  • daily.feels_like This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units used
    • daily.feels_like.morn Morning temperature.
    • daily.feels_like.day Day temperature.
    • daily.feels_like.eve Evening temperature.
    • daily.feels_like.night Night temperature.
  • daily.pressure Atmospheric pressure on the sea level, hPa
  • daily.humidity Humidity, %
  • daily.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.
  • daily.wind_speed Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units used
  • daily.wind_gust (where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units used
  • daily.wind_deg Wind direction, degrees (meteorological)
  • daily.clouds Cloudiness, %
  • daily.uvi The maximum value of UV index for the day
  • daily.pop Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%
  • daily.rain (where available) Precipitation volume, mm. Please note that only mm as units of measurement are available for this parameter
  • daily.snow (where available) Snow volume, mm. Please note that only mm as units of measurement are available for this parameter
  • daily.weather
    • daily.weather.id Weather condition id
    • daily.weather.main Group of weather parameters (Rain, Snow, Clouds etc.)
    • daily.weather.description Weather condition within the group (full list of weather conditions). Get the output in your language
    • daily.weather.icon Weather icon id. How to get icons
• alerts National weather alerts data from major national weather warning systems
  • alerts.sender_name Name of the alert source. Please read here the full list of alert sources
  • alerts.event Alert event name
  • alerts.start Date and time of the start of the alert, Unix, UTC
  • alerts.end Date and time of the end of the alert, Unix, UTC
  • alerts.description Description of the alert
  • alerts.tags Type of severe weather

How to make an API call

API call

Example of API call

Example of API response

                   
  {
  "lat": 52.2297,
  "lon": 21.0122,
  "timezone": "Europe/Warsaw",
  "timezone_offset": 3600,
  "data": [
    {
      "dt": 1645888976,
      "sunrise": 1645853361,
      "sunset": 1645891727,
      "temp": 279.13,
      "feels_like": 276.44,
      "pressure": 1029,
      "humidity": 64,
      "dew_point": 272.88,
      "uvi": 0.06,
      "clouds": 0,
      "visibility": 10000,
      "wind_speed": 3.6,
      "wind_deg": 340,
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01d"
        }
      ]
    }
  ]
}
                   
                 

Fields in API response

• lat Latitude of the location, decimal (−90; 90)
• lon Longitude of the location, decimal (-180; 180)
• timezone Timezone name for the requested location
• timezone_offset Shift in seconds from UTC
• data
  • data.dt Requested time, Unix, UTC
  • data.sunrise Sunrise time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the response
  • data.sunset Sunset time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the response
  • data.temp Temperature. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units used
  • data.feels_like Temperature. This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.
  • data.pressure Atmospheric pressure on the sea level, hPa
  • data.humidity Humidity, %
  • data.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.
  • data.clouds Cloudiness, %
  • data.uvi UV index. Please pay attention that historical UV index data available only for 5 days back. If you would like to get historical UVI index data starting from 20th September 2020 please contact us
  • data.visibility Average visibility, metres. The maximum value of the visibility is 10 km
  • data.wind_speed Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units used
  • data.wind_gust (where available) Wind gust. Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units used
  • data.wind_deg Wind direction, degrees (meteorological)
  • data.weather
    • data.weather.id Weather condition id
    • data.weather.main Group of weather parameters (Rain, Snow etc.)
    • data.weather.description Weather condition within the group (full list of weather conditions). Get the output in your language
    • data.weather.icon Weather icon id. How to get icons
  • data.rain (where available)
    • 1h Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
  • data.snow(where available)
    • 1h Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter

How to make an API call

API call

Example of API call

Example of API response

                   
  {
   "lat":33,
   "lon":35,
   "tz":"+02:00",
   "date":"2020-03-04",
   "units":"standard",
   "cloud_cover":{
      "afternoon":0
   },
   "humidity":{
      "afternoon":33
   },
   "precipitation":{
      "total":0
   },
   "temperature":{
      "min":286.48,
      "max":299.24,
      "afternoon":296.15,
      "night":289.56,
      "evening":295.93,
      "morning":287.59
   },
   "pressure":{
      "afternoon":1015
   },
   "wind":{
      "max":{
         "speed":8.7,
         "direction":120
      }
   }
}                
                 

Fields in API response

• lat Latitude of the location, decimal (−90; 90)
• lon Longitude of the location, decimal (-180; 180)
• tz Timezone in the ±XX:XX format
• dateDate specified in the API request in the `YYYY-MM-DD` format (from 1979-01-02 up to the 1,5 years ahead forecast)
• units Units of measurement specified in the request. Learn more
• cloud_cover Cloud related information
  • afternoon Cloud cover in percent at 12:00 for the date specified in the request
• humidity Humidity related information
  • afternoon Relative humidity in percent at 12:00 for the date specified in the request
• precipitation Precipitation related information
  • total Total amount of liquid water equivalent of precipitation for the date specified in the request
• pressure Atmospheric pressure related information
  • afternoon Atmospheric pressure at 12:00 for the date specified in the request
• temperature Temperature related information
  • min Minimum temperature for the date specified in the request
  • max Maximum temperature for the date specified in the request
  • afternoon Temperature at 12:00 for the date specified in the request
  • night Temperature at 00:00 for the date specified in the request
  • evening Temperature at 18:00 for the date specified in the request
  • morning Temperature at 06:00 for the date specified in the request
• wind Wind speed related information
  • max Maximum wind speed related information
    • speed Maximum wind speed for the date specified in the request
    • direction Wind cardinal direction relevant to the maximum wind speed, degrees (meteorological)

List of weather condition codes

List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere etc.)

Units of measurement

standard, metric and imperial units are available.

API call

Examples of API calls

Standard (default)

Metric

Imperial

Multilingual support

You can use lang parameter to get the output in your language.

The contents of the description field will be translated.

API call

Example of API call

We support the following languages. To select one, you can use the corresponding language code:

• af Afrikaans
• al Albanian
• ar Arabic
• az Azerbaijani
• bg Bulgarian
• ca Catalan
• cz Czech
• da Danish
• de German
• el Greek
• en English
• eu Basque
• fa Persian (Farsi)
• fi Finnish
• fr French
• gl Galician
• he Hebrew
• hi Hindi
• hr Croatian
• hu Hungarian
• id Indonesian
• it Italian
• ja Japanese
• kr Korean
• la Latvian
• lt Lithuanian
• mk Macedonian
• no Norwegian
• nl Dutch
• pl Polish
• pt Portuguese
• pt_br Português Brasil
• ro Romanian
• ru Russian
• sv, se Swedish
• sk Slovak
• sl Slovenian
• sp, es Spanish
• sr Serbian
• th Thai
• tr Turkish
• ua, uk Ukrainian
• vi Vietnamese
• zh_cn Chinese Simplified
• zh_tw Chinese Traditional
• zu Zulu

List of national weather alerts sources

Please note that some agencies from the list may cease to provide us the weather alert information.
In case you don’t receive alerts from any agency, please contact us.
We constantly work on our product’s improvement and keep expanding the list of partner agencies.

Call back function for JavaScript code

To use JavaScript code you can transfer callback functionName to JSONP callback.

API call example

                           
test({
  "lat": 40.12,
  "lon": -96.66,
  "timezone": "America/Chicago",
  "timezone_offset": -18000,
  "current": {
    "dt": 1595243443,
    "sunrise": 1595243663,
    "sunset": 1595296278,
    "temp": 293.28,
    "feels_like": 293.82,
    "pressure": 1016,
    "humidity": 100,
    "dew_point": 293.28,
    "uvi": 10.64,
    "clouds": 90,
    "visibility": 10000,
    "wind_speed": 4.6,
    "wind_deg": 310,
    "weather": [
      {
        "id": 501,
        "main": "Rain",
        "description": "moderate rain",
        "icon": "10n"
      },
      {
        "id": 201,
        "main": "Thunderstorm",
        "description": "thunderstorm with rain",
        "icon": "11n"
      }
    ],
    "rain": {
      "1h": 2.93
    }
  },
  "minutely": [
    {
      "dt": 1595243460,
      "precipitation": 2.928
    },
    ...
  },
    "hourly": [
    {
      "dt": 1595242800,
      "temp": 293.28,
      "feels_like": 293.82,
      "pressure": 1016,
      "humidity": 100,
      "dew_point": 293.28,
      "clouds": 90,
      "visibility": 10000,
      "wind_speed": 4.6,
      "wind_deg": 123,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10n"
        }
      ],
      "pop": 0.99,
      "rain": {
        "1h": 2.46
      }
    },
    ...
  }
"daily": [
    {
      "dt": 1595268000,
      "sunrise": 1595243663,
      "sunset": 1595296278,
      "temp": {
        "day": 298.82,
        "min": 293.25,
        "max": 301.9,
        "night": 293.25,
        "eve": 299.72,
        "morn": 293.48
      },
      "feels_like": {
        "day": 300.06,
        "night": 292.46,
        "eve": 300.87,
        "morn": 293.75
      },
      "pressure": 1014,
      "humidity": 82,
      "dew_point": 295.52,
      "wind_speed": 5.22,
      "wind_deg": 146,
      "weather": [
        {
          "id": 502,
          "main": "Rain",
          "description": "heavy intensity rain",
          "icon": "10d"
        }
      ],
      "clouds": 97,
      "pop": 1,
      "rain": 12.57,
      "uvi": 10.64
    },
    ...
    },
"alerts": [
    {
      "sender_name": "NWS Tulsa (Eastern Oklahoma)",
      "event": "Heat Advisory",
      "start": 1597341600,
      "end": 1597366800,
      "description": "...HEAT ADVISORY REMAINS IN EFFECT FROM 1 PM THIS AFTERNOON TO\n8 PM CDT THIS EVENING...\n* WHAT...Heat index values of 105 to 109 degrees expected.\n* WHERE...Creek, Okfuskee, Okmulgee, McIntosh, Pittsburg,\nLatimer, Pushmataha, and Choctaw Counties.\n* WHEN...From 1 PM to 8 PM CDT Thursday.\n* IMPACTS...The combination of hot temperatures and high\nhumidity will combine to create a dangerous situation in which\nheat illnesses are possible."
    },
    ...
  ]
  })