OpenWeatherMap integration

Overview

OpenWeatherMap provides weather data for any location worldwide. This tool retrieves current weather conditions or 5-day/3-hour forecasts via the OpenWeatherMap API v2.5 (https://api.openweathermap.org/data/2.5). It supports four location selection methods: city name (e.g., “berlin,de”), city ID (from the OpenWeatherMap bulk data), geographic coordinates (latitude/longitude), or zip/postal code (e.g., “10115,de”). Results can be returned in metric (Celsius, m/s), imperial (Fahrenheit, mph), or scientific (Kelvin, m/s) units. An optional language parameter controls the output language for weather descriptions. Authentication is via an API key.

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires OpenWeatherMap API credentials. See the Credentials Guide for setup instructions.

Operations

Operation	Value	Description
Current Weather	currentWeather	Returns the current weather data
5 Day Forecast	5DayForecast	Returns the weather data for the next 5 days (3-hour intervals)

Parameters

Both operations take the same parameters — the operation only selects which OpenWeatherMap endpoint is queried. Which location field you fill in is decided by Location Selection, not by the operation.

Parameter	Type	Required	Default	Description
Format	options	No	metric	The unit format for the returned data.
				Options: imperial (Fahrenheit | miles/hour), metric (Celsius | meter/sec), standard (Kelvin | meter/sec — shown as “Scientific”)
Location Selection	options	No	cityName	How to define the location for which to return the weather.
				Options: cityName, cityId, coordinates, zipCode
City	string	Yes	—	The name of the city to return the weather of. Optionally include country code (e.g., “london,uk”). Supports expressions. (shown when Location Selection is cityName)
City ID	number	Yes	160001123	The ID of the city to return the weather of. City ID list can be downloaded from http://bulk.openweathermap.org/sample/. (shown when Location Selection is cityId)
Latitude	string	Yes	—	The latitude of the location to return the weather of. Supports expressions. (shown when Location Selection is coordinates)
Longitude	string	Yes	—	The longitude of the location to return the weather of. Supports expressions. (shown when Location Selection is coordinates)
Zip Code	string	Yes	—	The zip/postal code to return the weather of. Optionally include country code (e.g., “10115,de”). Supports expressions. (shown when Location Selection is zipCode)
Language	string	No	—	The two-letter language code to get your output in (e.g., en, de, fr, es, it, pt, ru, ja, zh_cn).
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

The OpenWeatherMap API response is merged onto the input item JSON — the incoming fields pass through unchanged, and binary data is forwarded. Weather values (temperature, humidity, wind, and so on) are reported in the units selected by Format.

How many output items you get depends on the operation:

Operation	Output
currentWeather	One output item per input item — the current-conditions response merged onto the item.
5DayForecast	Fans out: one output item per forecast entry in the response’s list (3-hour steps over 5 days). Each entry carries a city property holding the response’s city block, so the location details are available on every item.

Because a forecast turns one input item into many, index-based pairing with the upstream node no longer holds downstream — put any field you need to match on onto the input item and it will still be present on every forecast entry.

Example Configuration

Current weather by city name, in Celsius:

{
  "type": "open_weather_map",
  "parameters": {
    "operation": "currentWeather",
    "locationSelection": "cityName",
    "cityName": "London,UK",
    "format": "metric",
    "language": "en"
  }
}

5-day forecast by coordinates coming from the incoming item, in Fahrenheit:

{
  "type": "open_weather_map",
  "parameters": {
    "operation": "5DayForecast",
    "locationSelection": "coordinates",
    "latitude": "{{ $json.lat }}",
    "longitude": "{{ $json.lon }}",
    "format": "imperial"
  }
}

Current weather by city ID, with German descriptions and Kelvin units:

{
  "type": "open_weather_map",
  "parameters": {
    "operation": "currentWeather",
    "locationSelection": "cityId",
    "cityId": 2643743,
    "format": "standard",
    "language": "de"
  }
}

Weather by postal code, throttled for a large batch of items:

{
  "type": "open_weather_map",
  "parameters": {
    "operation": "currentWeather",
    "locationSelection": "zipCode",
    "zipCode": "{{ $json.postcode }},de",
    "format": "metric",
    "language": "de",
    "maxConcurrency": 5
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

This tool retrieves current weather or 5-day forecasts from the OpenWeatherMap service for a specified location. It is ideal when you need weather information by city name, coordinates, city ID, or zip code, offering a direct alternative to other general information tools. The tool produces either the current weather data or a 5-day forecast with 3-hour intervals.

Important Notes

• Always ensure the location parameter matches the locationSelection value
• When using coordinates, both latitude and longitude must be provided as strings
• City names can include country codes for better accuracy (e.g., “Paris,FR”)
• Language codes should be standard two-letter ISO codes
• City IDs are numeric values, not strings