Skip to main content
OpenWeather API logo
  • Category: places & weather
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 21
  • Triggers: 0
  • Slug: OPENWEATHER_API
  • Version: 20261101_00

Tools

Slug: OPENWEATHER_API_DELETE_WEATHER_STATIONTool to delete a registered weather station. Use after identifying a station to remove. Returns confirmation message upon success.

Input Parameters

string
required
The unique ID of the weather station to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET5_DAY_FORECASTGet a 5-day forecast at 3-hour intervals for a location identified by city name, city ID, postal code, or coordinates. Use the city timezone offset when grouping UTC timestamps into local daily summaries.

Input Parameters

string
City name and optional country code, e.g. ‘London,uk’
integer
OpenWeatherMap city ID
number
Latitude in degrees
number
Longitude in degrees
string
Zip code with country code, e.g. ‘94040,us’
string
Language code (ISO 639-1)
string ("json" | "xml" | "html")
Response format
string ("standard" | "metric" | "imperial")
Units of measurement (standard, metric, imperial)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_AIR_POLLUTION_CURRENTTool to fetch current air pollution data for a location. Use when you need real-time air quality details by latitude and longitude.

Input Parameters

number
required
Latitude of the location, between -90 and 90
number
required
Longitude of the location, between -180 and 180

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_AIR_POLLUTION_FORECASTTool to get forecasted air pollution data for a specific location. Use after confirming latitude and longitude. Forecast availability may be limited for remote or oceanic coordinates; verify response timestamps to confirm returned data represents a true forecast rather than a current snapshot.

Input Parameters

number
required
Geographical latitude in decimal degrees (range -90 to 90)
number
required
Geographical longitude in decimal degrees (range -180 to 180)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_AIR_POLLUTION_HISTORYTool to retrieve historical air pollution data. Use when you need past air quality levels for a specific latitude/longitude and time range.

Input Parameters

integer
required
End UNIX timestamp (UTC seconds); must be >= start
number
required
Latitude of the location (range: -90 to 90)
number
required
Longitude of the location (range: -180 to 180)
integer
required
Start UNIX timestamp (UTC seconds); must be <= end

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_CIRCLE_CITY_WEATHERSearch for current weather data in cities around a geographic point, with an optional number of cities to return.

Input Parameters

integer
Number of cities to return within the circle (1–50). Default is 10.
number
required
Latitude of the circle center in degrees (-90 to 90)
number
required
Longitude of the circle center in degrees (-180 to 180)
string
Language of the response (ISO 639-1)
string ("json" | "xml")
Response format: ‘json’ or ‘xml’
string ("standard" | "metric" | "imperial")
Units of measurement: standard, metric, or imperial

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_CURRENT_WEATHERRetrieve current weather for a location identified by city name, city ID, postal code, or coordinates.

Input Parameters

string
City name, state code and country code, e.g., ‘London,uk’
integer
City ID, e.g., 2172797
number
Geographic coordinate latitude, e.g., 35.0
number
Geographic coordinate longitude, e.g., 139.0
string
Zip code and country code, e.g., ‘94040,us’
string
Language for the response (ISO 639-1 code, e.g., ‘en’)
string ("standard" | "metric" | "imperial")
Units of measurement. ‘standard’ (default), ‘metric’, or ‘imperial’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_GEOCODING_BY_ZIPTool to convert zip/post code into geographic coordinates. Use when you need latitude and longitude for a specific postal code.

Input Parameters

string
required
Zip/post code and country code divided by comma. Use ISO 3166 country codes (e.g., ‘10001,US’ or ‘E14,GB’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_GEOCODING_DIRECTTool to convert a location name into geographic coordinates. Use when you need latitude and longitude for a given location after confirming the precise name.

Input Parameters

string
required
Location query as ‘city,country_code’, or ‘city,state_code,country_code’ for US locations. Use ISO 3166 country codes (e.g., ‘London,GB’ or ‘Springfield,IL,US’) and verify the returned country/region before using coordinates downstream.
integer
Number of results to return (1 to 5). Defaults to 5. Use 1 only for unambiguous locations; for ambiguous queries review all returned results to select the correct match.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_GEOCODING_REVERSETool to convert geographic coordinates into a location name. Use when you need city, state, and country info from latitude and longitude.

Input Parameters

number
required
Latitude of the location in decimal degrees
number
required
Longitude of the location in decimal degrees
integer
Number of results to return (1 to 5)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_STATION_MEASUREMENTSTool to retrieve aggregated measurements from a weather station with minute, hour, or day granularity. Use when you need historical weather data from a specific registered station.

Input Parameters

integer
required
End of time interval (Unix timestamp in seconds)
integer
required
Start of time interval (Unix timestamp in seconds)
string ("m" | "h" | "d")
required
Aggregation type: m (minute), h (hour), or d (day)
integer
required
Maximum number of measurement records to return
string
required
Internal station ID from OpenWeather

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_UV_INDEXTool to retrieve current UV index for a location. Use when you need up-to-the-minute UV index by latitude and longitude.

Input Parameters

number
required
Latitude of the location, between -90 and 90
number
required
Longitude of the location, between -180 and 180

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_UV_INDEX_FORECASTTool to retrieve UV index forecast for a specific location. Use when you need upcoming UV index values after confirming latitude and longitude. Returns up to 8 days of data. Data may be sparse or absent for ocean and remote locations; an empty response means no data available, not safe UV conditions.

Input Parameters

integer
Number of days to return (1-8); defaults to 8 if not specified
number
required
Latitude of the location, between -90 and 90
number
required
Longitude of the location, between -180 and 180

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_UV_INDEX_HISTORYTool to retrieve historical UV index data for a specified location and time range. Use when you need to analyze past UV exposure trends after confirming coordinates and time period.

Input Parameters

integer
required
End UNIX timestamp (UTC seconds); must be >= start
number
required
Latitude of the location (range: -90 to 90)
number
required
Longitude of the location (range: -180 to 180)
integer
required
Start UNIX timestamp (UTC seconds); must be <= end

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_WEATHER_MAP_TILETool to fetch Weather Maps 2.0 tile images. Use when you need dynamic weather layers at specific zoom and coordinates with advanced styling options.

Input Parameters

integer
required
Tile X coordinate (non-negative integer).
integer
required
Tile Y coordinate (non-negative integer).
integer
required
Zoom level of the tile (non-negative integer).
string
Color for empty-data fill areas (hex or named).
string
Color schema of the tiles, e.g., ‘original’, ‘black’.
string ("clouds" | "clouds_new" | "precipitation" | "precipitation_new" | "pressure" | "pressure_new" | "wind" | "wind_new" | "temp" | "temp_new")
required
Weather layer name. Options: clouds, clouds_new, precipitation, precipitation_new, pressure, pressure_new, wind, wind_new, temp, temp_new.
integer ("1" | "2")
Tile scale factor: 1 or 2 for retina.
string
Image format; only ‘png’ is supported.
number
Tile opacity value between 0.0 and 1.0.
string
Custom palette definition (comma-separated or JSON).
boolean
Fill tiles outside data coverage if true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_WEATHER_STATIONTool to get information about a specific weather station by its ID. Use when you need details about a particular station.

Input Parameters

string
required
Internal station ID to retrieve information for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_WEATHER_STATIONSTool to list all weather stations added to your account. Use after setting up your OpenWeather API key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_GET_WEATHER_TRIGGERSTool to retrieve weather triggers for specific conditions. Use after defining trigger criteria.

Input Parameters

array
required
List of weather trigger definitions

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_POST_ADD_WEATHER_STATIONTool to add a new weather station to your account. Use when you need to register a station before sending custom data.

Input Parameters

string
required
Station name
number
required
Station altitude in meters above sea level
number
required
Station latitude, range -90 to 90 degrees
number
required
Station longitude, range -180 to 180 degrees
string
required
External station ID (your own reference)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_POST_SUBMIT_STATION_MEASUREMENTSTool to submit weather measurements from a registered station. Use when you need to send temperature, wind, pressure, humidity, or precipitation data for a station.

Input Parameters

array
required
Array of measurement objects to submit

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: OPENWEATHER_API_UPDATE_WEATHER_STATIONUpdate an existing weather station’s details, including its name, location, external ID, or altitude. Latitude and longitude are required for every update.

Input Parameters

string
Human-readable name for the station
number
Altitude of the station above sea level in meters
number
required
Latitude of the station in degrees, between -90 and 90
number
required
Longitude of the station in degrees, between -180 and 180
string
required
Unique identifier of the weather station to update
string
Custom user-provided external identifier for the station

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not