Environment

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

Changed on

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 plain city name, narrowed by the separate country parameter if given; an unresolvable location is 422, never 404.

get/api/v2/weather/forecast

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v2/weather/forecast
  • Auth: API key in header x-api-key

Query parameters

latitudenumber nullable

Latitude (-90 to 90).

Example:-6.2
longitudenumber nullable

Longitude (-180 to 180).

Example:106.82
latnumber nullable

Latitude alias (same as latitude).

Example:-6.2
lonnumber nullable

Longitude alias (same as longitude).

Example:106.82
citystring nullable

Plain city name (alternative to lat/lon), resolved globally. The country goes in the separate country parameter, never combined into this field. An unresolvable location is 422, never 404.

Example:Jakarta
countrystring nullable

Country name or ISO-2 code (narrows the city match). Always a separate parameter from city.

Example:ID
forecast_daysinteger

Forecast horizon in days (1-16).

Example:7
past_daysinteger

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

temperature_unitstring

Temperature unit: celsius | fahrenheit.

Example:celsius
wind_speed_unitstring

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

Example:ms
precipitation_unitstring

Precipitation unit: mm | inch.

Example:mm
timezonestring

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

Example:auto
timeformatstring

Timestamp format: iso8601 | unixtime.

Example:iso8601
languagestring

Locale for the human condition text (13 supported).

Example:en

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes