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.
2 credits/call
Pricing
2 credits/call
| Condition | Charge |
|---|---|
| Each call | 2 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
lat | number | Yes | Latitude, decimal (-90; 90) | — |
lon | number | Yes | Longitude, decimal (-180; 180) | — |
date | string | No | The 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 | — |
units | enum (standard | metric | imperial) | No | Units 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-KeyRequest 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
{
"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.


