Current Weather Data API

Get current weather data

curl --request GET \
  --url 'https://api.openweathermap.org/data/2.5/weather?appid='

const options = {method: 'GET'};

fetch('https://api.openweathermap.org/data/2.5/weather?appid=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.openweathermap.org/data/2.5/weather?appid=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openweathermap.org/data/2.5/weather?appid="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.openweathermap.org/data/2.5/weather?appid=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "coord": {
    "lon": 2.3488,
    "lat": 48.8534
  },
  "weather": [
    {
      "id": 803,
      "main": "Clouds",
      "description": "broken clouds",
      "icon": "04d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 289.28,
    "feels_like": 288.7,
    "temp_min": 288.21,
    "temp_max": 291.69,
    "pressure": 1022,
    "humidity": 67
  },
  "visibility": 10000,
  "wind": {
    "speed": 2.57,
    "deg": 40
  },
  "clouds": {
    "all": 75
  },
  "dt": 1717406455,
  "sys": {
    "type": 2,
    "id": 2041230,
    "country": "FR",
    "sunrise": 1717386622,
    "sunset": 1717444055
  },
  "timezone": 7200,
  "id": 2988507,
  "name": "Paris",
  "cod": 200
}

{
  "cod": 400,
  "message": "Nothing to geocode"
}

{
  "cod": 401,
  "message": "Invalid API key. Please see https://openweathermap.org/faq#error401 for more info."
}

{
  "cod": 123,
  "message": "<string>"
}

GET

weather

Get current weather data

curl --request GET \
  --url 'https://api.openweathermap.org/data/2.5/weather?appid='

const options = {method: 'GET'};

fetch('https://api.openweathermap.org/data/2.5/weather?appid=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.openweathermap.org/data/2.5/weather?appid=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openweathermap.org/data/2.5/weather?appid="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.openweathermap.org/data/2.5/weather?appid=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "coord": {
    "lon": 2.3488,
    "lat": 48.8534
  },
  "weather": [
    {
      "id": 803,
      "main": "Clouds",
      "description": "broken clouds",
      "icon": "04d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 289.28,
    "feels_like": 288.7,
    "temp_min": 288.21,
    "temp_max": 291.69,
    "pressure": 1022,
    "humidity": 67
  },
  "visibility": 10000,
  "wind": {
    "speed": 2.57,
    "deg": 40
  },
  "clouds": {
    "all": 75
  },
  "dt": 1717406455,
  "sys": {
    "type": 2,
    "id": 2041230,
    "country": "FR",
    "sunrise": 1717386622,
    "sunset": 1717444055
  },
  "timezone": 7200,
  "id": 2988507,
  "name": "Paris",
  "cod": 200
}

{
  "cod": 400,
  "message": "Nothing to geocode"
}

{
  "cod": 401,
  "message": "Invalid API key. Please see https://openweathermap.org/faq#error401 for more info."
}

{
  "cod": 123,
  "message": "<string>"
}

Use this endpoint to fetch current weather conditions for a given location.

Authorizations

appid

string

query

required

Query Parameters

appid

string

required

API key for authentication

lat

number<float>

required

Latitude of the desired location

Required range: -90 <= x <= 90

lon

number<float>

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, meters per second for wind speed and wind gust
metric: Celsius for temperature, meters per second for wind speed and wind gust
imperial: Fahrenheit for temperature, miles per 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:

sq: Albanian
af: Afrikaans
ar: Arabic
az: Azerbaijani
eu: Basque
be: Belarusian
bg: Bulgarian
ca: Catalan
zh_cn: Chinese Simplified
zh_tw: Chinese Traditional
hr: Croatian
cz: 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
sp, es: Spanish
sv, se: Swedish
th: Thai
tr: Turkish
ua, uk: Ukrainian
vi: Vietnamese
zu: Zulu

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

Response

Successful response - Current weather data

coord

object

Show child attributes

weather

object[]

Show child attributes

base

string

Internal parameter

main

object

Show child attributes

visibility

integer

Visibility (meters)

wind

object

Show child attributes

clouds

object

Show child attributes

rain

object | null

Show child attributes

snow

object | null

Show child attributes

integer

Time of data calculation, in Unix time (UTC)

sys

object

Show child attributes

timezone

integer

Shift in seconds from UTC

integer

City identifier

name

string

City name

cod

integer

API response status code

Welcome

Get Started

Essentials

API Reference

Current Weather Data API

Authorizations

Query Parameters

Response