OpenWeatherMap Get Weather Overview

2 credits/call
ae_openweathermap_get_weather_overview

Get a human-readable OpenWeatherMap summary for today or tomorrow at a location, with standard, metric, or imperial units.

Weather
2 credits/call

Pricing

2 credits/call
ConditionCharge
Each call2 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
latnumberYesLatitude, decimal (-90; 90)—
lonnumberYesLongitude, decimal (-180; 180)—
datestringNoThe date the user wants to get a weather summary in the YYYY-MM-DD format. Data is available for today and tomorrow. If not specified, the current date will be used by default. Please note that the date is determined by the timezone relevant to the coordinates specified in the API request—
unitsenum (standard | metric | imperial)NoUnits of measurement. Standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.standard

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_openweathermap_get_weather_overview' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "date": "2026-10-09",
    "lat": 39.9057136,
    "lon": 116.3912972,
    "units": "metric"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "date": "2026-10-09",
  "lat": 39.9057136,
  "lon": 116.3912972,
  "tz": "+08:00",
  "units": "metric",
  "weather_overview": "Today's weather is characterized by overcast clouds, giving the sky a blanket of gray. The temperature is currently at a mild 14 degrees Celsius, but it feels slightly cooler at 12 degrees due to a gentle breeze. Humidity levels are relatively low at 32%, "
}

This example shows part of the response. Copied content is valid JSON.