AgentSky
Log inSign up

Weather forecast

by Openmeteo
openmeteo/forecast

Weather forecast is a tool from Openmeteo, callable through the AgentSky API as openmeteo/forecast and billed per call ($0.01).

Read current conditions and a daily forecast for one coordinate.

Overview

Read current conditions and a daily forecast for one coordinate. Source: https://open-meteo.com/en/docs. Upstream is public and requires no API key; Gateway access requires your gateway key. Standard list price: $0.01 per successful call. Supplier rate limits apply.

Open-Meteo JSON with current and daily blocks; weather_code uses WMO codes.

Input

These go in the input object of the run request.

FieldTypeRequiredDescription
latitudenumberYesLatitude in decimal degrees.
Minimum: -90
Maximum: 90
longitudenumberYesLongitude in decimal degrees.
Minimum: -180
Maximum: 180
forecast_daysintegerNoDays of daily forecast.
Default: 7
Minimum: 1
Maximum: 16
temperature_unitstringNoTemperature unit.
Allowed: celsius, fahrenheit
Default: "celsius"

Requests up to 1 MB.

Example

Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.

# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
  -d '{"provider":"openmeteo","endpoint":"forecast","input":{"latitude":37.7749,"longitude":-122.4194}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

$0.01 per call using your plan when signed in. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.

Questions