GET
/
weather

Authorizations

appid
string
query
required

Query Parameters

lat
number
required

Latitude of the desired location

Required range: -90 < x < 90
lon
number
required

Longitude of the desired location

Required range: -180 < x < 180
mode
enum<string>

Response format.

Default is json if you don't use the mode parameter.

Available options:
html,
json,
xml
units
enum<string>

Units of measurement:

  • standard: Kelvin for temperature, meter/sec for wind speed and wind gust
  • metric: Celsius for temperature, meter/sec for wind speed and wind gust
  • imperial: Fahrenheit for temperature, miles/hour for wind speed and wind gust

Default is standard if you don't use the units parameter.

Available options:
standard,
metric,
imperial
lang
string

Output language for weather description (weather.description) and city name (name) fields in the API response.

Available options:

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

Default is English if you don't use the lang parameter.

Response

200 - application/json
base
string

Internal parameter

clouds
object
cod
integer

API response status code

coord
object
dt
integer

Time of data calculation, in Unix time (UTC)

id
integer

City identifier

main
object
name
string

City name

rain
object | null
snow
object | null
sys
object
timezone
integer

Shift in seconds from UTC

visibility
integer

Visibility (meters)

weather
object[]
wind
object