Current weather data

JSON format API response fields

• coord
  • coord.lon Longitude of the location
  • coord.lat Latitude of the location
• weather (more info Weather condition codes)
  • weather.id Weather condition id
  • weather.main Group of weather parameters (Rain, Snow, Clouds etc.)
  • weather.description Weather condition within the group. You can get the output in your language. Learn more
  • weather.icon Weather icon id
• base Internal parameter
• main
  • main.temp Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit
  • main.feels_like Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit
  • main.pressure Atmospheric pressure on the sea level, hPa
  • main.humidity Humidity, %
  • main.temp_min Minimum temperature at the moment. This is minimal currently observed temperature (within large megalopolises and urban areas). Please find more info here.Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit
  • main.temp_max Maximum temperature at the moment. This is maximal currently observed temperature (within large megalopolises and urban areas). Please find more info here.Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit
  • main.sea_level Atmospheric pressure on the sea level, hPa
  • main.grnd_level Atmospheric pressure on the ground level, hPa
• visibility Visibility, meter. The maximum value of the visibility is 10 km
• wind
  • wind.speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour
  • wind.deg Wind direction, degrees (meteorological)
  • wind.gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour
• clouds
  • clouds.all Cloudiness, %
• rain
  • 1h(where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
• snow
  • 1h(where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
• dt Time of data calculation, unix, UTC
• sys
  • sys.type Internal parameter
  • sys.id Internal parameter
  • sys.message Internal parameter
  • sys.country Country code (GB, JP etc.)
  • sys.sunrise Sunrise time, unix, UTC
  • sys.sunset Sunset time, unix, UTC
• timezone Shift in seconds from UTC
• id City ID. Please note that built-in geocoder functionality has been deprecated. Learn more here
• name City name. Please note that built-in geocoder functionality has been deprecated. Learn more here
• cod Internal parameter

XML format API response fields

• city
  • city.id City ID. Please note that built-in geocoder functionality has been deprecated. Learn more here
  • city.name City name. Please note that built-in geocoder functionality has been deprecated. Learn more here
  • city.coord
    • city.coord.lon Geo location, longitude
    • city.coord.lat Geo location, latitude
  • city.country Country code (GB, JP etc.). Please note that built-in geocoder functionality has been deprecated. Learn more here
  • timezoneShift in seconds from UTC
  • city.sun
    • city.sun.rise Sunrise time
    • city.sun.set Sunset time
• temperature
  • temperature.value Temperature
  • temperature.min Minimum temperature at the moment of calculation. This is minimal currently observed temperature (within large megalopolises and urban areas), use this parameter optionally. Please find more info here
  • temperature.max Maximum temperature at the moment of calculation. This is maximal currently observed temperature (within large megalopolises and urban areas), use this parameter optionally. Please find more info here
  • temperature.unit Unit of measurements. Possible value is Celsius, Kelvin, Fahrenheit
• feels_like
  • feels_like.value Temperature. This temperature parameter accounts for the human perception of weather
  • feels_like.unit Unit of measurements. Possible value is Celsius, Kelvin, Fahrenheit. Unit Default: Kelvin
• humidity
  • humidity.value Humidity value
  • humidity.unit Humidity units, %
• pressure
  • pressure.value Pressure value
  • pressure.unit Pressure units, hPa
• wind
  • wind.speed
    • wind.speed.value Wind speed
    • wind.speed.unit Wind speed units, m/s
    • wind.speed.name Type of the wind
  • wind.direction
    • wind.direction.value Wind direction, degrees (meteorological)
    • wind.direction.code Code of the wind direction. Possible value is WSW, N, S etc.
    • wind.direction.name Full name of the wind direction
• clouds
  • clouds.value Cloudiness
  • clouds.name Name of the cloudiness
• visibility
  • visibility.value Visibility, meter. The maximum value of the visibility is 10km
• precipitation
  • precipitation.value Precipitation, mm
  • precipitation.mode Possible values are 'no", name of weather phenomena as 'rain', 'snow'
• weather
  • weather.number Weather condition id
  • weather.value Weather condition name
  • weather.icon Weather icon id
• lastupdate
  • lastupdate.value Last time when data was updated

Built-in API request by city name

You can call by city name or city name, state code and country code. Please note that searching by states available only for the USA locations.

API call

Examples of API calls:

                         
     {
     "coord": {
       "lon": -0.13,
       "lat": 51.51
     },
     "weather": [
       {
         "id": 300,
         "main": "Drizzle",
         "description": "light intensity drizzle",
         "icon": "09d"
       }
     ],
     "base": "stations",
     "main": {
       "temp": 280.32,
       "pressure": 1012,
       "humidity": 81,
       "temp_min": 279.15,
       "temp_max": 281.15
     },
     "visibility": 10000,
     "wind": {
       "speed": 4.1,
       "deg": 80
     },
     "clouds": {
       "all": 90
     },
     "dt": 1485789600,
     "sys": {
       "type": 1,
       "id": 5091,
       "message": 0.0103,
       "country": "GB",
       "sunrise": 1485762037,
       "sunset": 1485794875
     },
     "id": 2643743,
     "name": "London",
     "cod": 200
     }
                         
                       

                         
     {
     "coord": {
       "lon": -0.13,
       "lat": 51.51
     },
     "weather": [
       {
         "id": 300,
         "main": "Drizzle",
         "description": "light intensity drizzle",
         "icon": "09d"
       }
     ],
     "base": "stations",
     "main": {
       "temp": 280.32,
       "pressure": 1012,
       "humidity": 81,
       "temp_min": 279.15,
       "temp_max": 281.15
     },
     "visibility": 10000,
     "wind": {
       "speed": 4.1,
       "deg": 80
     },
     "clouds": {
       "all": 90
     },
     "dt": 1485789600,
     "sys": {
       "type": 1,
       "id": 5091,
       "message": 0.0103,
       "country": "GB",
       "sunrise": 1485762037,
       "sunset": 1485794875
     },
     "id": 2643743,
     "name": "London",
     "cod": 200
     }
                         
                       

Built-in API request by city ID

You can make an API call by city ID. List of city ID 'city.list.json.gz' can be downloaded here.

We recommend to call API by city ID to get unambiguous result for your city.

API call

Examples of API calls

                         
     {
     "coord": {
       "lon": 145.77,
       "lat": -16.92
     },
     "weather": [
       {
         "id": 802,
         "main": "Clouds",
         "description": "scattered clouds",
         "icon": "03n"
       }
     ],
     "base": "stations",
     "main": {
       "temp": 300.15,
       "pressure": 1007,
       "humidity": 74,
       "temp_min": 300.15,
       "temp_max": 300.15
     },
     "visibility": 10000,
     "wind": {
       "speed": 3.6,
       "deg": 160
     },
     "clouds": {
       "all": 40
     },
     "dt": 1485790200,
     "sys": {
       "type": 1,
       "id": 8166,
       "message": 0.2064,
       "country": "AU",
       "sunrise": 1485720272,
       "sunset": 1485766550
     },
     "id": 2172797,
     "name": "Cairns",
     "cod": 200
     }
                         
                       

Built-in API request by ZIP code

Please note if country is not specified then the search works for USA as a default.

API call

Examples of API calls

                             
     {
     "coord": {"lon": -122.08,"lat": 37.39},
     "weather": [
       {
         "id": 800,
         "main": "Clear",
         "description": "clear sky",
         "icon": "01d"
       }
     ],
     "base": "stations",
     "main": {
       "temp": 282.55,
       "feels_like": 281.86,
       "temp_min": 280.37,
       "temp_max": 284.26,
       "pressure": 1023,
       "humidity": 100
     },
     "visibility": 10000,
     "wind": {
       "speed": 1.5,
       "deg": 350
     },
     "clouds": {
       "all": 1
     },
     "dt": 1560350645,
     "sys": {
       "type": 1,
       "id": 5122,
       "message": 0.0139,
       "country": "US",
       "sunrise": 1560343627,
       "sunset": 1560396563
     },
     "timezone": -25200,
     "id": 420006353,
     "name": "Mountain View",
     "cod": 200
     }