Get current weather and multi-day forecasts. Supports any city, country or GPS coordinates. Returns temperature, humidity, wind, UV index, precipitation and a 7-day forecast.
Input Parameters
Parameter
Type
Description
locationrequired
string
City name, "City, Country", or "lat,lon". Examples: "Buenos Aires", "Tokyo", "48.8566,2.3522".
daysoptional
integer
Number of forecast days. 1 returns current conditions only. Default: 1, max: 7.
unitsoptional
string
Temperature units: "metric" (°C), "imperial" (°F), or "standard" (K). Default: "metric".
include_hourlyoptional
boolean
Include hourly breakdown for each forecast day. Default: false.
Output Fields
Field
Type
Description
location
object
Resolved location with name, country, lat, and lon.
current
object
Current conditions: temperature, feels_like, humidity, description, wind_speed, uv_index, visibility_km.
forecast
array
Daily forecast entries (when days > 1), each with date, temp_min, temp_max, description, and rain_mm.