Weather

Call current weather data for one location

get

https://api.openweathermap.org/data/2.5http://beta.api.openweathermap.org/data/2.5http://some-other.api.openweathermap.org/data/2.5

weather

Access current weather data for any location on Earth including over 200,000 cities! Current weather is frequently updated based on global models and data from more than 40,000 weather stations.

Authorizations

app_id

appidstringRequired

API key to authorize requests.

Query parameters

qstringOptional

City name. Example: London. You can call by city name, or by city name and country code. The API responds with a list of results that match a searching word. For the query value, type the city name and optionally the country code divided by a comma; use ISO 3166 country codes.

idstringOptional

City ID. Example: 2172797. You can call by city ID. The API responds with the exact result. The List of city IDs can be downloaded here. You can include multiple cities in this parameter — just separate them by commas. The limit of locations is 20. Note: A single ID counts as a one API call. So, if you have 3 city IDs, it’s treated as 3 API calls.

latstringOptional

Latitude. Example: 35. The latitude coordinate of the location of your interest. Must use with lon.

lonstringOptional

Longitude. Example: 139. Longitude coordinate of the location of your interest. Must use with lat.

zipstringOptional

Zip code. Search by zip code. Example: 95050,us. Please note that if the country is not specified, the search uses USA as a default.

unitsstring · enumOptional

Units. Example: imperial. Possible values: standard, metric, and imperial. When you do not use the units parameter, the format is standard by default.

Default: imperialPossible values:

langstring · enumOptional

Language. Example: en. You can use lang parameter to get the output in your language. We support the following languages that you can use with the corresponded lang values: Arabic - ar, Bulgarian - bg, Catalan - ca, Czech - cz, German - de, Greek - el, English - en, Persian (Farsi) - fa, Finnish - fi, French - fr, Galician - gl, Croatian - hr, Hungarian - hu, Italian - it, Japanese - ja, Korean - kr, Latvian - la, Lithuanian - lt, Macedonian - mk, Dutch - nl, Polish - pl, Portuguese - pt, Romanian - ro, Russian - ru, Swedish - se, Slovak - sk, Slovenian - sl, Spanish - es, Turkish - tr, Ukrainian - ua, Vietnamese - vi, Chinese Simplified - zh_cn, Chinese Traditional - zh_tw.

Default: enPossible values:

modestring · enumOptional

Mode. Example: html. Determines the format of the response. Possible values are xml and html. If the mode parameter is empty, the format is json by default.

Default: jsonPossible values:

Responses

200

Successful response

application/json

basestringOptional

Internal parameter

Example: cmc stations

visibilityintegerOptional

Visibility, meter

Example: 16093

dtinteger · int32Optional

Time of data calculation, unix, UTC

Example: 1435658272

idinteger · int32Optional

City ID

Example: 2172797

namestringOptionalExample: Cairns

codinteger · int32Optional

Internal parameter

Example: 200

404

Not found response

text/plain

get

weather

HTTPcURLJavaScriptPython

GET /data/2.5weather HTTP/1.1
Host: api.openweathermap.org/
Accept: */*

{
  "coord": {
    "lon": 145.77,
    "lat": -16.92
  },
  "weather": [
    {
      "id": 803,
      "main": "Clouds",
      "description": "broken clouds",
      "icon": "04n"
    }
  ],
  "base": "cmc stations",
  "main": {
    "temp": 293.25,
    "pressure": 1019,
    "humidity": 83,
    "temp_min": 289.82,
    "temp_max": 295.37,
    "sea_level": 984,
    "grnd_level": 990
  },
  "visibility": 16093,
  "wind": {
    "speed": 5.1,
    "deg": 150
  },
  "clouds": {
    "all": 75
  },
  "rain": {
    "3h": 3
  },
  "snow": {
    "3h": 6
  },
  "dt": 1435658272,
  "sys": {
    "type": 1,
    "id": 8166,
    "message": 0.0166,
    "country": "AU",
    "sunrise": 1435610796,
    "sunset": 1435650870
  },
  "id": 2172797,
  "name": "Cairns",
  "cod": 200
}