v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

Environment

Hourly and daily weather forecast (up to 16 days, worldwide)

Sugra Weather forecast for any coordinate or city worldwide: hourly steps and daily aggregates up to 16 days ahead (and up to 92 past days for context), covering temperature, feels-like, humidity, dew point, precipitation with probability, rain, showers, snowfall, snow depth, WMO weather code, pressure, cloud cover by level, visibility, wind with gusts, UV index, daylight, sunshine, solar radiation, and reference evapotranspiration. National high-resolution weather models are blended into a global best match for every location. Units, timezone, and time format are configurable. Resolve any city by name with the optional country filter.

get/api/v2/weather/forecast

Query parameters

latitudenumber nullable

Latitude (-90 to 90).

Example:-6.2

Latitude (-90 to 90).

longitudenumber nullable

Longitude (-180 to 180).

Example:106.82

Longitude (-180 to 180).

latnumber nullable

Latitude alias (same as latitude).

Example:-6.2

Latitude alias (same as latitude).

lonnumber nullable

Longitude alias (same as longitude).

Example:106.82

Longitude alias (same as longitude).

citystring nullable

City name (alternative to lat/lon), resolved globally.

Example:Jakarta

City name (alternative to lat/lon), resolved globally.

countrystring nullable

Country name or ISO-2 code (narrows the city match).

Example:ID

Country name or ISO-2 code (narrows the city match).

forecast_daysinteger

Forecast horizon in days (1-16).

Example:7

Forecast horizon in days (1-16).

past_daysinteger

Also include this many past days (0-92).

temperature_unitstring

Temperature unit: celsius | fahrenheit.

Example:celsius

Temperature unit: celsius | fahrenheit.

wind_speed_unitstring

Wind speed unit: kmh | ms | mph | kn.

Example:ms

Wind speed unit: kmh | ms | mph | kn.

precipitation_unitstring

Precipitation unit: mm | inch.

Example:mm

Precipitation unit: mm | inch.

timezonestring

IANA timezone for timestamps (e.g. 'Asia/Tokyo'), or 'auto' to resolve from the location.

Example:auto

IANA timezone for timestamps (e.g. 'Asia/Tokyo'), or 'auto' to resolve from the location.

timeformatstring

Timestamp format: iso8601 | unixtime.

Example:iso8601

Timestamp format: iso8601 | unixtime.

languagestring

Locale for the human condition text (13 supported).

Example:en

Locale for the human condition text (13 supported).

Response

Hourly and daily forecast with per-variable units and provenance.

Example response

{
  "data": {
    "timezone": "Asia/Jakarta",
    "timezone_abbreviation": "WIB",
    "resolved_location": {
      "name": "Jakarta",
      "country": "Indonesia",
      "country_code": "ID",
      "admin1": "Jakarta",
      "timezone": "Asia/Jakarta"
    },
    "hourly": [
      {
        "condition_icon": "cloud-sun"
      }
    ],
    "daily": [
      {
        "condition_icon": "cloud-rain"
      }
    ],
    "provenance": {
      "source": "openmeteo",
      "product": "Sugra Weather forecast",
      "models": "best_match",
      "licence": "CC-BY-4.0",
      "attribution": "Weather data by Open-Meteo.com"
    }
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}