Logo

API Documentation

Logo

Foreca Weather API

Foreca Weather API standard Stratus package includes access to point forecasts, weather maps and Air quality API.

API features (Warning API, Marine API, Pollen) depends on your package and some options (Climate Data, Ski API, Weather History, Notifications and Agriculture) can be added to the certain packages for an additional fee. If you are interested in API features, please contact our sales team for more information.

Learn more about Foreca’s different weather solutions at corporate.foreca.com.

Attribution

Customer shall display in its weather service the Foreca logo. In case displaying the logo is not possible due to technical reasons, the text ”Foreca” shall be displayed in customer’s weather service in connection with the content referring to the source of information. Customer agrees to cease use of the logo and name ”Foreca” in case requested by Foreca, and also to follow Foreca’s reasonable instructions in using the logo, trade name or other trademarks of Foreca.

https://corporate.foreca.com/en/logo

Third Party Attributions

Customer’s application must show attribution as given in API response. For example, the Capabilities endpoint in Weather Map API responds with layer info telling the required attribution text.

Currently the following organisations must be attributed if their data is used:

Radar data: Aemet, BOM, DMI, DWD, EC, FMI, InMet, JMA, KMI, KNMI, MET Eireann, MeteoSchweiz, MF, Met Office, MET Norway, NWS, Protezione Civile, SMHI, SMN, ZAMG

Satellite data: EUMETSAT, JMA, NOAA

Pollen data: Copernicus Atmosphere Monitoring Service

Climate data: Copernicus Climate Change Service, ESA Sea Surface Temperature Climate Change Initiative

Ski data: Skiresort Service International

Hurricane data: National Oceanic and Atmospheric Administration (NOAA), Japan Meteorological Agency (JMA), Bureau of Meteorology (BOM), RSMC La Réunion (Météo-France), MetService New Zealand, Fiji Meteorological Service, Joint Typhoon Warning Center

Authorization

Fetch tokens for API access. Tokens can be self-expiring or non-expiring.


My API account

You can monitor your API usage and manage access tokens throught My API account. From my API account you can also see amount of your API hits and which API products and features are activated. You get access details for your API account within your sign up email.


Request/query limits

Your subscription determines which features are available for your account. Queries-per-second (QPS) is limited based on the specific package you choose. The rate is a hard limit and will result in an error if exceeded. The monthly request limit, on the other hand, is a soft limit and will not trigger an error. It’s important to note that these limits are tied to the account, not the tokens. All queries contribute to the same limit. In other words, even if you make requests to different API endpoints, they are aggregated and counted together.

For the free trial, we also monitor a per day request rate. A free trial account can make 1000 requests to the Point Forecast API and 1000 requests to the Map API per day. These daily limits apply exclusively to free trial accounts and do not affect paid subscription.

Each API request to a specific end-point is counted as one query. Map API usage is measured by the number of tiles served —each tile counts as one request.

Token

Create an expiring or non-expiring token (API key).

  • user

    Application key username

  • password

    Application key password

  • expire_hours (optional)

    Expiry time in hours (default 1, maximum 168). If given expiry time is -1, a non-expiring token is created.

    • POST
    /authorize/token
    {
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9mbnc2LmZvcmVjYS5jb21cL2F1dGhvcml6ZVwvdG9rZW4iLCJpYXQiOjE1MjYzMDAzODAsImV4cCI6MTUyNjMwMzk4MCwibmJmIjoxNTI2MzAwMzgwLCJqdGkiOiJxSXl3WVlQNjc1NkczejBEIiwic3ViIjoibFFHa1Y4Z2pIeGUyZU1ibndUUUs4NktqVTY3RXJlS2htenY1IiwicHJ2IjoiYWY3YTAzOThkZGNiNWE3YTUzN2Q3YzdkMjU2NWEyZjgxZGM4ZTQxNCJ9.V8xg6L9yrY9__VH-jdrL_CqXisEpgcfdUa0NoxlGz0k",
  "expires_in": 3600,
  "token_type": "bearer"
}

    Keys

    Fetch a list of API keys (non-expiring tokens).

  • user

    Application key username

  • password

    Application key password

    • POST
    /authorize/key
    [
  {
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9mbnc2LmZvcmVjYS5jb21cL2F1dGhvcml6ZVwvdG9rZW4iLCJpYXQiOjE1MjYzMDAzODAsImV4cCI6MTUyNjMwMzk4MCwibmJmIjoxNTI2MzAwMzgwLCJqdGkiOiJxSXl3WVlQNjc1NkczejBEIiwic3ViIjoibFFHa1Y4Z2pIeGUyZU1ibndUUUs4NktqVTY3RXJlS2htenY1IiwicHJ2IjoiYWY3YTAzOThkZGNiNWE3YTUzN2Q3YzdkMjU2NWEyZjgxZGM4ZTQxNCJ9.V8xg6L9yrY9__VH-jdrL_CqXisEpgcfdUa0NoxlGz0k",
    "key": "23j98rfsnldkvf3w49hg"
  }
]

    Delete Key

    Delete non-expiring token using its key.

  • user

    Application key username

  • password

    Application key password

    • DELETE
    /authorize/key/:key
    Forecasts
    Global weather point forecasts. Temperature and relative humidity parameters are calculated at 2m height, all wind parameters at 10m . Height of the parameters is above ground. Ground is assumed to be at the average elevation of the surrounding area.
    Sometimes, data may be missing, in which case the API will return null for that value. This can occur if our data providers experience issues with data delivery. Therefore, null values should be treated as missing data.

    The Forecast endpoints (daily,hourly, 3hourly, 15minutely, minutely) support multi-location requests for up to 50 locations. Use a semicolon-separated list of coordinates or location IDs to retrieve multiple location forecasts. Due to the size of the data for all parameters and long forecasts, the response time can be slow. Therefore, limit the forecast length using periods in the request to achieve faster response times. Each individual location is counted as a query for billing purposes.



    Foreca’s custom weather symbol sets are available for download in SVG and png formats, exclusively for our API clients throught  My API page. 
    Location search
    Locations and associated identifiers matching a search query. Can be used as alternatives to coordinates.
  • query 
    Search query
  • lang (optional)
    Language (ISO 639-1 codes). Options: de, en, es, fr, it, pl, ru, fi, sv, nl, ko, pt, th, tr, zh, zh_TW (Chinese in Taiwan), zh_CN (Chinese in China). (default en)
  • country (optional)
    Limit search to a given country (ISO 3166-1 alpha-2 codes)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/location/search/:query
    {
  "locations": [
    {
      "id": 102643743,
      "name": "London",
      "country": "United Kingdom",
      "timezone": "Europe/London",
      "language": "en",
      "adminArea": "England",
      "adminArea2": "Greater London",
      "adminArea3": null,
      "lon": -0.1257,
      "lat": 51.5085
    },
    {
      "id": 106058560,
      "name": "London",
      "country": "Canada",
      "timezone": "America/Toronto",
      "language": "en",
      "adminArea": "Ontario",
      "adminArea2": null,
      "adminArea3": null,
      "lon": -81.233,
      "lat": 42.9834
    },
    {
      "id": 103458449,
      "name": "Londrina",
      "country": "Brazil",
      "timezone": "America/Sao_Paulo",
      "language": "en",
      "adminArea": "Paraná",
      "adminArea2": "Londrina",
      "adminArea3": null,
      "lon": -51.1628,
      "lat": -23.3103
    }
  ]
}
  • id • number
    Identifier to be used with weather queries
  • name • string
    Location name eg. London
  • country • string
    Location country name eg. United Kingdom
  • state • string
    U.S. state abbreviation (if applicable)
  • timezone • string
    Location timezone eg. Europe/London
  • language • string
    Language of location name result
  • adminArea • string
    Administrative region name (high level, e.g. state)
  • adminArea2 • string
    Administrative region name (medium level, e.g. county)
  • adminArea3 • string
    Administrative region name (low level, e.g. municipality)
  • lon • number
    Location longitude
  • lat • number
    Location latitude
    • Location info
    Location metadata.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • lang (optional)
    Language (ISO 639-1 codes). Options: de, en, es, fr, it, pl, ru, fi, sv, nl, ko, pt, th, tr, zh, zh_TW (Chinese in Taiwan), zh_CN (Chinese in China). (default en)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/location/:location
    {
  "id": 100184745,
  "name": "Nairobi",
  "country": "Kenia",
  "timezone": "Africa/Nairobi",
  "language": "fi",
  "adminArea": "Nairobi",
  "adminArea2": null,
  "adminArea3": null,
  "lon": 36.8167,
  "lat": -1.2833
}
  • id • number
    Identifier to be used with weather queries
  • name • string
    Location name eg. London
  • country • string
    Location country name eg. United Kingdom
  • state • string
    U.S. state abbreviation (if applicable)
  • language • string
    Language of location name result
  • adminArea • string
    Administrative region name (high level, e.g. state)
  • adminArea2 • string
    Administrative region name (medium level, e.g. county)
  • adminArea3 • string
    Administrative region name (low level, e.g. municipality)
  • lon • number
    Location longitude
  • lat • number
    Location latitude
    • Observations
    Observations from a nearby representative weather station.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • stations (optional)
    Amount of stations (default 3, maximum 6)
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
  • windunit (optional)
    Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)
  • rounding (optional)
    Rounding of some variables to nearest integer: 0 or 1 (default 1 for no decimals)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/observation/latest/:location
    {
  "observations": [
    {
      "distance": "2 km SW",
      "elevation": 286,
      "feelsLikeTemp": -3,
      "latitude": 50.12,
      "longitude": 14.54,
      "pressure": 1000,
      "relHumidity": 92,
      "snowDepth": null,
      "station": "Kbely Air Base",
      "symbol": "d400",
      "temperature": 0,
      "time": "2025-11-24T14:00:00+01:00",
      "visibility": 7000,
      "windDir": 70,
      "windDirString": "E",
      "windGust": null,
      "windSpeed": 3
    },
    {
      "distance": "2 km SW",
      "elevation": 287,
      "feelsLikeTemp": -4,
      "latitude": 50.12,
      "longitude": 14.54,
      "pressure": 1002.9,
      "relHumidity": 90,
      "snowDepth": 2,
      "station": "Praha Kbely",
      "symbol": "d400",
      "temperature": -1,
      "time": "2025-11-24T13:00:00+01:00",
      "visibility": 8000,
      "windDir": 60,
      "windDirString": "NE",
      "windGust": 3,
      "windSpeed": 3
    }
  ]
}
  • station • string
    Name of the observation station
  • latitude • number
    Latitude of the station
  • longitude • number
    Longitude of the station
  • elevation • number
    Elevation (m) of the station from the sea level
  • distance • string
    Distance from the location to the station eg. 13 km E
  • time • string
    ISO 8601 date and time for the observation parameters
  • temperature • number
    Temperature (°C or requested unit)
  • feelsLikeTemp • number
    Feels like temperature (°C or requested unit)
  • symbol • string
    Weather symbol code
  • windDirString • string
    Wind direction (N, NE, E, SE, S, SW, W, NW)
  • windDir • number
    Wind direction in degrees
  • windSpeed • number
    Wind speed (m/s or requested unit)
  • windGust • number
    Wind gust speed (m/s or requested unit)
  • pressure • number
    Atmospheric pressure normalized to sea level (hPa)
  • relHumidity • number
    Relative humidity (%)
  • visibility • number
    visibility in meters, e.g. "10000" for 10 km
    • Current
    Current weather estimate.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • alt (optional)
    Altitude in meters
  • tempunit (optional)
    Temperature unit
  • windunit (optional)
    Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • lang (optional)
     Language (ISO 639-1 codes). Options: ar, bg, bn, ca, cs, da, de, el, en, en_gb = en, en_us = en, es, et, fa, fi, fr, gu, he, hi, hr, hu, id, is, it, ja, kn, ko, lt, lv, ml, nb, nl, no, pa, pl, pt = pt_pt, pt_br, pt_pt, ro, ru, sk, sq, sr, sv, ta, te, th, tr, uk, vi, zh (Simplified Chinese), zh_hk (Traditional Chinese). (default en)
  • rounding (optional)
    Rounding of some variables to nearest integer: 0 or 1 (default 1 for no decimals)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/current/:location
    {
  "current": {
    "time": "2021-12-20T09:28+02:00",
    "symbol": "n000",
    "symbolPhrase": "clear",
    "temperature": -11.76,
    "feelsLikeTemp": -18.97,
    "relHumidity": 69,
    "dewPoint": -15.81,
    "windSpeed": 4.25,
    "windDir": 16,
    "windDirString": "N",
    "windGust": 11.66,
    "precipProb": 1,
    "precipRate": 0,
    "cloudiness": 3,
    "thunderProb": 0,
    "uvIndex": 0,
    "pressure": 1020.95,
    "visibility": 19934
  }
}
  • time • string
    ISO 8601 date and time
  • symbol • string
    Weather symbol code
  • symbolPhrase • string
    Description of weather symbol
  • temperature • number
    Temperature (°C or requested unit)
  • feelsLikeTemp • number
    Feels like temperature (°C or requested unit)
  • relHumidity • number
    Relative humidity (%)
  • dewPoint • number
    Dew point (°C or requested unit)
  • windSpeed • number
    Wind speed (m/s or requested unit)
  • windDirString • string
    Wind direction (N, NE, E, SE, S, SW, W, NW)
  • windGust • number
    Wind gust (m/s or requested unit)
  • precipProb • number
    Probability of precipitation (%)
  • precipRate • number
    Intensity of precipitation rate (mm/h)
  • cloudiness • number
    Cloudiness (%)
  • thunderProb • number
    Probability of thunder nearby (%)
  • uvIndex • number
    UV index
  • pressure • number
    Atmospheric pressure normalized to sea level (hPa)
  • visibility • number
    Visibility (m)
    • Nowcast (short)
    High resolution one hour precipitation forecast in one minute time steps, taking advantage of weather radar where available (Europe and continental USA).
    In Europe and continental USA, the short nowcast is based on a true nowcast that uses radar extrapolation to move observed rain. The data is very fresh, usually less than 15 minutes old. If it’s true nowcast response resolution parameter shows: "resolution": 1.
    In other parts of the world, we use medium-range forecast so the forecast is not a true minutecast. The time step is 1 hour, so anything less than that has to be interpolated from the hourly time steps. The data may be several hours old, so the forecast isn’t as skilled in predicting near-term precipitation. If it’s not true nowcast response resolution parameter shows: "resolution": 60
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (up to 60, default 60)
  • tz (optional)
    Time zone in response (IANA time zone database names)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/forecast/minutely/:location
    {
  "forecast": [
    {
      "time": "2022-06-22T07:43+03:00",
      "precipRate": 0.93
    },
    {
      "time": "2022-06-22T07:44+03:00",
      "precipRate": 0.98
    },
    {
      "time": "2022-06-22T07:45+03:00",
      "precipRate": 1.04
    }
  ],
  "resolution": 1
}
  • time • string
    ISO 8601 date and time
  • precipRate • number
    Intensity of precipitation rate (mm/h)
  • resolution • number
    Time resolution of the precipitation rate, in minutes (1 for ares covered by radar, 60 elsewhere).
    • Nowcast (long)
    3-hour forecast in 15-minute time steps. The values represent the conditions at the associated timestamp unless otherwise specified.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 8, maximum 12)
  • alt (optional)
    Altitude in meters
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
  • windunit (optional)
    Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • dataset (optional)
    Variable set: "standard" or "full" (default "standard")
  • lang (optional)
     Language (ISO 639-1 codes). Options: ar, bg, bn, ca, cs, da, de, el, en, en_gb = en, en_us = en, es, et, fa, fi, fr, gu, he, hi, hr, hu, id, is, it, ja, kn, ko, lt, lv, ml, nb, nl, no, pa, pl, pt = pt_pt, pt_br, pt_pt, ro, ru, sk, sq, sr, sv, ta, te, th, tr, uk, vi, zh (Simplified Chinese), zh_hk (Traditional Chinese). (default en)
  • rounding (optional)
    Rounding of some variables to nearest integer: 0 or 1 (default 1 for no decimals)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/forecast/15minutely/:location
    {
  "forecast": [
    {
      "time": "2021-12-20T10:30+01:00",
      "symbol": "d421",
      "symbolPhrase": "wet snow showers",
      "temperature": 0.5,
      "feelsLikeTemp": -4.55,
      "relHumidity": 97,
      "dewPoint": 0.02,
      "windDir": 220,
      "windSpeed": 5.47,
      "windGust": 11.06,
      "windDirString": "SW",
      "precipProb": 82,
      "snowRate": 0.03,
      "precipRate": 0.05,
      "cloudiness": 100,
      "thunderProb": 0,
      "uvIndex": 0,
      "pressure": 998.169,
      "precipType": "mixed"
    },
    {
      "time": "2021-12-20T10:45+01:00",
      "symbol": "d421",
      "symbolPhrase": "wet snow showers",
      "temperature": 0.57,
      "feelsLikeTemp": -4.44,
      "relHumidity": 97,
      "dewPoint": 0.11,
      "windDir": 220,
      "windSpeed": 5.43,
      "windGust": 10.94,
      "windDirString": "SW",
      "precipProb": 81,
      "snowRate": 0.03,
      "precipRate": 0.05,
      "cloudiness": 100,
      "thunderProb": 0,
      "uvIndex": 0,
      "pressure": 998.266,
      "precipType": "mixed"
    }
  ]
}
  • time • string
    ISO 8601 date and time
  • symbol • string
    Weather symbol code
  • symbolPhrase • string
    Weather description
  • temperature • number
    Temperature (°C)
  • feelsLikeTemp • number
    Feels like temperature (°C)
  • relHumidity • number
    Relative humidity (%) (dataset=full)
  • windDir • number
    Wind direction in degrees
  • windGust • number
    Wind gust speed (m/s or requested unit)
  • windSpeed • number
    Wind speed (m/s or requested unit)
  • windDirString • string
    Wind direction (N, NE, E, SE, S, SW, W, NW)
  • precipProb • number
    Probability of precipitation (%)
  • precipRate • number
    Intensity of precipitation rate (mm/h)
  • cloudiness • number
    Cloudiness (%)
  • thunderProb • number
    Thunder probability (%)
  • uvIndex • number
    Ultraviolet index
  • pressure • number
    Atmospheric pressure extrapolated to sea level (%)
  • precipType • string
    Precipitation type (always one of: rain, mixed, snow)
  • snowRate • number
    Intensity of snow rate (cm/h, taking density into account)
    • Hourly
    Hourly forecasts, up to 7 days. The values represent the conditions at the associated timestamp unless otherwise specified.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 24, maximum 168)
  • alt (optional)
    Altitude in meters
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
  • windunit (optional)
    Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • dataset (optional)
    Variable set: "standard" or "full" (default "standard")
  • history (optional)
    History: whether to include past 24 hours (1 or 0, default 0)
  • lang (optional)
    Language (ISO 639-1 codes). Options: ar, bg, bn, ca, cs, da, de, el, en, en_gb = en, en_us = en, es, et, fa, fi, fr, gu, he, hi, hr, hu, id, is, it, ja, kn, ko, lt, lv, ml, nb, nl, no, pa, pl, pt = pt_pt, pt_br, pt_pt, ro, ru, sk, sq, sr, sv, ta, te, th, tr, uk, vi, zh (Simplified Chinese), zh_hk (Traditional Chinese). (default en)
  • rounding (optional)
    Rounding of some variables to nearest integer: 0 or 1 (default 1 for no decimals)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/forecast/hourly/:location
    {
  "forecast": [
    {
      "time": "2021-12-20T13:00+04:00",
      "symbol": "d400",
      "symbolPhrase": "overcast",
      "temperature": -0.78,
      "feelsLikeTemp": -6,
      "windSpeed": 4.68,
      "windGust": 10.43,
      "relHumidity": 73,
      "dewPoint": -3.59,
      "windDir": 250,
      "windDirString": "W",
      "precipProb": 44,
      "precipAccum": 0.01,
      "snowAccum": 0.01,
      "cloudiness": 99,
      "thunderProb": 0,
      "uvIndex": 0,
      "pressure": 994.789,
      "visibility": 26554,
      "precipType": "snow",
      "solarRadiation": 140
    },
    {
      "time": "2021-12-20T14:00+04:00",
      "symbol": "d400",
      "symbolPhrase": "overcast",
      "temperature": -1.12,
      "feelsLikeTemp": -6,
      "windSpeed": 4.98,
      "windGust": 10.33,
      "relHumidity": 73,
      "dewPoint": -4.13,
      "windDir": 255,
      "windDirString": "W",
      "precipProb": 40,
      "precipAccum": 0,
      "snowAccum": 0,
      "cloudiness": 100,
      "thunderProb": 0,
      "uvIndex": 0,
      "pressure": 995.463,
      "visibility": 36159,
      "precipType": "snow",
      "solarRadiation": 135
    }
  ]
}
  • time • string
    ISO 8601 date and time
  • symbol • string
    Weather symbol code
  • symbolPhrase • string
    Description of weather (dataset=full)
  • temperature • number
    Temperature (°C or requested unit)
  • feelsLikeTemp • number
    Feels like temperature (°C or requested unit)
  • relHumidity • number
    Relative humidity (%) (dataset=full)
  • dewPoint • number
    Dew point (°C or requested unit) (dataset=full)
  • windSpeed • number
    Wind speed (m/s or requested unit)
  • windGust • number
    Wind gust speed (m/s or requested unit)
  • windDir • number
    Wind direction in degrees
  • windDirString • string
    Wind direction (N, NE, E, SE, S, SW, W, NW)
  • precipProb • number
    Probability of precipitation in the 1 hour period ending at the timestamp (%)
  • precipAccum • number
    Accumulated 1 hour precipitation up until the timestamp (as liquid water, mm).
  • cloudiness • number
    Cloudiness (%) (dataset=full)
  • thunderProb • number
    Thunder probability (%) (dataset=full)
  • uvIndex • number
    Ultraviolet index (dataset=full)
  • pressure • string
    Pressure (hPa) (dataset=full)
  • visibility • number
    Visibility (m) (dataset=full)
  • precipType • string
    Precipitation type (always one of: rain, mixed, snow)
  • snowAccum • number
    Thickness of snow accumulated over 1 hour ending at the timestamp (cm)
  • solarRadiation • number
    Ground level solar radiation intensity on a level surface, W/m²
    • Three-hourly
    Forecast at 3 hour intervals, up to 14 days. The values represent the conditions at the associated timestamp unless otherwise specified. Precipitation sums are for three-hour periods.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 16, maximum 112)
  • alt (optional)
    Altitude in meters
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
  • windunit (optional)
    Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • dataset (optional)
    Variable set: "standard" or "full" (default "standard")
  • history (optional)
    History: whether to include past 24 hours (1 or 0, default 0)
  • lang (optional)
    Language (ISO 639-1 codes). Options: ar, bg, bn, ca, cs, da, de, el, en, en_gb = en, en_us = en, es, et, fa, fi, fr, gu, he, hi, hr, hu, id, is, it, ja, kn, ko, lt, lv, ml, nb, nl, no, pa, pl, pt = pt_pt, pt_br, pt_pt, ro, ru, sk, sq, sr, sv, ta, te, th, tr, uk, vi, zh (Simplified Chinese), zh_hk (Traditional Chinese). (default en)
  • rounding (optional)
    Rounding of some variables to nearest integer: 0 or 1 (default 1 for no decimals)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/forecast/3hourly/:location
    {
  "forecast": [
    {
      "time": "2021-12-20T10:00+01:00",
      "symbol": "n400",
      "symbolPhrase": "overcast",
      "temperature": -4.1,
      "feelsLikeTemp": -9.13,
      "windSpeed": 4.2,
      "windGust": 8.66,
      "relHumidity": 78,
      "dewPoint": -7.38,
      "windDir": 273,
      "windDirString": "W",
      "precipProb": 7,
      "precipAccum": 0.01,
      "snowAccum": 0.03,
      "cloudiness": 100,
      "thunderProb": 0,
      "uvIndex": 0,
      "pressure": 1014.42,
      "visibility": 49379,
      "precipType": "snow",
      "solarRadiation": 85
    },
    {
      "time": "2021-12-20T13:00+01:00",
      "symbol": "n400",
      "symbolPhrase": "overcast",
      "temperature": -8.16,
      "feelsLikeTemp": -16.09,
      "windSpeed": 6.25,
      "windGust": 12.13,
      "relHumidity": 68,
      "dewPoint": -12.86,
      "windDir": 300,
      "windDirString": "NW",
      "precipProb": 8,
      "precipAccum": 0,
      "snowAccum": 0,
      "cloudiness": 100,
      "thunderProb": 0,
      "uvIndex": 0,
      "pressure": 1017.4,
      "visibility": 49854,
      "precipType": "snow",
      "solarRadiation": 135
    }
  ]
}
  • time • string
    ISO 8601 date and time
  • symbol • string
    Weather symbol code
  • symbolPhrase • string
    Description of weather (dataset=full)
  • temperature • number
    Temperature (°C or requested unit)
  • feelsLikeTemp • number
    Feels like temperature (°C or requested unit)
  • relHumidity • number
    Relative humidity (%) (dataset=full)
  • dewPoint • number
    Dew point (°C or requested unit) (dataset=full)
  • windSpeed • number
    Wind speed (m/s or requested unit)
  • windGust • number
    Wind gust speed (m/s or requested unit)
  • windDir • number
    Wind direction in degrees
  • windDirString • string
    Wind direction (N, NE, E, SE, S, SW, W, NW)
  • precipProb • number
    Probability of precipitation in the 3 hour period ending at the timestamp (%)
  • precipAccum • number
    Accumulated 3 hour precipitation up until the timestamp (as liquid water, mm).
  • cloudiness • number
    Cloudiness (%) (dataset=full)
  • thunderProb • number
    Thunder probability (%) (dataset=full)
  • uvIndex • number
    Ultraviolet index (dataset=full)
  • pressure • string
    Pressure (hPa) (dataset=full)
  • visibility • number
    Visibility (m) (dataset=full)
  • precipType • string
    Precipitation type (always one of: rain, mixed, snow)
  • snowAccum • number
    Thickness of snow accumulated over 3 hours ending at the timestamp (cm)
  • solarRadiation • number
    Ground level solar radiation intensity on a level surface, W/m²
    • Daily
    Daily forecasts, up to 14 days.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 7, maximum 14)
  • alt (optional)
    Altitude in meters
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
  • windunit (optional)
    Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)
  • dataset (optional)
    Variable set: "standard" or "full" (default "standard")
  • lang (optional)
    Language (ISO 639-1 codes). Options: ar, bg, bn, ca, cs, da, de, el, en, en_gb = en, en_us = en, es, et, fa, fi, fr, gu, he, hi, hr, hu, id, is, it, ja, kn, ko, lt, lv, ml, nb, nl, no, pa, pl, pt = pt_pt, pt_br, pt_pt, ro, ru, sk, sq, sr, sv, ta, te, th, tr, uk, vi, zh (Simplified Chinese), zh_hk (Traditional Chinese). (default en)
  • rounding (optional)
    Rounding of some variables to nearest integer: 0 or 1 (default 1 for no decimals)
  • offset_hours (optional)
    Include past data up to -48 hours
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/forecast/daily/:location
    {
  "forecast": [
    {
      "date": "2021-12-20",
      "symbol": "d421",
      "symbolPhrase": "wet snow showers",
      "maxTemp": 1.19,
      "minTemp": -3.86,
      "maxFeelsLikeTemp": -2.8,
      "minFeelsLikeTemp": -7.07,
      "maxRelHumidity": 98,
      "minRelHumidity": 73,
      "maxDewPoint": 0.05,
      "minDewPoint": -4.57,
      "precipAccum": 4.05,
      "snowAccum": 3.22,
      "maxWindSpeed": 6.77,
      "windDir": 225,
      "maxWindGust": 14.84,
      "precipProb": 98,
      "cloudiness": 100,
      "sunrise": "05:55:32",
      "sunset": "13:58:53",
      "sunriseEpoch": 1639976132,
      "sunsetEpoch": 1640005133,
      "moonrise": "14:40:32",
      "moonset": "07:12:56",
      "moonPhase": 192,
      "uvIndex": 0,
      "minVisibility": 3395,
      "pressure": 998.956,
      "confidence": "y",
      "solarRadiationSum": 442
    },
    {
      "date": "2021-12-21",
      "symbol": "d400",
      "symbolPhrase": "overcast",
      "maxTemp": -2.95,
      "minTemp": -10.4,
      "maxFeelsLikeTemp": -5.53,
      "minFeelsLikeTemp": -15.57,
      "maxRelHumidity": 99,
      "minRelHumidity": 53,
      "maxDewPoint": -4.4,
      "minDewPoint": -14.18,
      "precipAccum": 0.16,
      "snowAccum": 1.48,
      "maxWindSpeed": 4.49,
      "windDir": 292,
      "maxWindGust": 9.34,
      "precipProb": 65,
      "cloudiness": 96,
      "sunrise": "05:56:06",
      "sunset": "13:59:19",
      "sunriseEpoch": 1640062566,
      "sunsetEpoch": 1640091559,
      "moonrise": "15:40:18",
      "moonset": "07:58:16",
      "moonPhase": 203,
      "uvIndex": 0,
      "minVisibility": 14805,
      "pressure": 1006.78,
      "confidence": "g",
      "solarRadiationSum": 430
    }
  ]
}
  • date • string
    ISO 8601 date
  • symbol • string
    Weather symbol code representing daytime conditions (7am to 6pm local time)
  • symbolPhrase • string
    Description of weather during the day (dataset=full)
  • maxTemp • number
    24h maximum temperature (°C)
  • minTemp • number
    24h minimum temperature (°C)
  • maxFeelsLikeTemp • number
    24h maximum feels-like temperature (°C) (dataset=full)
  • minFeelsLikeTemp • number
    24h minimum feels-like temperature (°C) (dataset=full)
  • maxRelHumidity • number
    24h maximum relative humidity (°C) (dataset=full)
  • minRelHumidity • number
    24h minimum relative humidity (°C) (dataset=full)
  • maxDewPoint • number
    maximum dew point (°C) (dataset=full)
  • minDewPoint • number
    minimum dew point (°C) (dataset=full)
  • precipAccum • number
    Accumulated precipitation (as liquid water, mm)
  • maxWindSpeed • number
    Maximum wind speed (m/s or requested unit)
  • windDir • number
    Wind direction at maximum wind speed (degrees)
  • maxWindGust • number
    Maximum wind gust speed (m/s or requested unit) (dataset=full)
  • precipProb • number
    Precipitation probability during the day (%) (dataset=full)
  • cloudiness • number
    Daytime cloudiness average (%) (dataset=full)
  • sunrise • string
    Sunrise time of day in local time (dataset=full)
  • sunset • string
    Sunset time of day in local time (dataset=full)
  • sunriseEpoch • number
    Sunrise time in Unix time (dataset=full)
  • sunsetEpoch • number
    Sunset time in Unix time (dataset=full)
  • moonrise • string
    Moonrise time of day in local time (dataset=full)
  • moonset • string
    Moonset time of day in local time (dataset=full)
  • moonPhase • number
    Phase of moon at midday (degrees) (dataset=full)
  • uvIndex • number
    Maximum ultraviolet index (dataset=full)
  • minVisibility • number
    Minimum visibility (m) (dataset=full)
  • pressure • number
    Daytime average sea level pressure (hPa) (dataset=full)
  • snowAccum • number
    Accumulated snow (thickness of precipiated snow, cm)
  • confidence • string
    Confidence in forecast: g (green, good), y (yellow, normal), o (orange, low)
  • solarRadiationSum • number
    Ground level solar radiation on a level surface, sum over the entire day (Wh/m²)
    • Maps
    Weather Map API provides global weather forecast, radar and satellite data as map tiles compatible with commonly used map services such as Open Street Maps or Google Maps. All required and optional parameters are given as path and query parameters respectively. To obtain images one must first request an access token using valid credentials. The access token can then be used to fetch capabilities-response, which contains information on how to fetch images. Image size is 256x256 pixels.
    To significantly reduce the amount of data your browser requests and speed up map loading, we recommend caching map tiles. This means your browser will temporarily store recently viewed map sections. The duration of this storage depends on how often the map data updates. For example, frequently changing data like radar updates are cached for shorter periods than less frequent updates like temperature. By caching, you'll experience faster map performance and lower data usage.

    Capabilities
    Capabilities endpoint is used to fetch layer metadata. This metadata is used to perform image queries. Capabilities-response provides layer information such as description, temporal and spatial extents as well as available color schemes. Images are layers renderable to image formats such as png or svg. The current data property in time element is the index to the most recent available time. Image products may have additional color schemes which can be optionally specified. Several layers have transparency in the color scheme by default, enabling them to be overlaid directly onto a map. Alternatively, we also offer non-transparent color schemes when only the details of the map – like country borders, roads and city names – are to be placed on top of the weather layer. If an alternative color scheme is available, you can find it in the capabilities endpoint.
  • token 
    Access token as provided by authorization endpoint
    • In capabilities-response, the times element contains the following properties:
    • current: index of timestep of current time, regardless of timestep being observation or forecast
    • updated: time of data and available timesteps last updated. Use this as an optional query parameter when requesting rapidly updating layers to prevent fetching tiles from outdated analyses.
    • analysis: time of analysis (for radars, the most recent observation)

    Available standard map layers
    Europe 15 min precipitation radar and forecast with precipitation type
    rain.png
    TIME RESOLUTION:
    • Observation: 15min with 1 day history 
    • Radar forecast: 15min up to 2h 30min
    • Rain forecast: 3h up to 3d
    UPDATE: 15 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Albania*, Andorra, Austria, Belgium, Bosnia & Herzegovina, Bulgaria, Croatia, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Kosovo, Latvia, Liechtenstein, Lithuania*, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Norway, Poland, Portugal, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, The UK (*partial coverage)
    Europe 5 minute Weather Radar Composite with precipitation type
    rain.png
    TIME RESOLUTION:
    • Observation: 5min with 3 hour history 
    • Radar forecast: 5min up to 1h 30min
    UPDATE: 5 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Europe (see above)
    Europe 5 minute Weather Radar Composite with precipitation type and lightning
    precipitation.png
    TIME RESOLUTION:
    • Observation: 5min with 3 hour history 
    • Radar forecast: 5min up to 1h 30min
    UPDATE: 5 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Europe (see above)
    North America radar and precipitation forecast with precipitation type
    rain.png
    TIME RESOLUTION:
    • Observation: 5min with 1 day history 
    • Radar forecast: 5min up to 3h
    • Rain forecast 3h up to 3d
    UPDATE: 5 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Continental USA, Alaska, Hawaii, Puerto Rico, Canada (partial coverage)
    North America radar  + lightning with radar forecast and precipitation type
    radar_light.png
    TIME RESOLUTION:
    • Observation: 5min with 1 day history 
    • Radar forecast: 5min up to 3h
    UPDATE: 5 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Continental USA, Alaska, Hawaii, Puerto Rico, Canada (partial coverage)
    Eastern Asia radar and precipitation forecast with precipitation type
    rain.png
    TIME RESOLUTION:
    • Observation: 10min with 1 day history
    • Radar forecast: 10min up to 1h 30min
    • Rain forecast 3h up to 3d
    TIME RESOLUTION:
    UPDATE: 10 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Japan, Taiwan, South Korea
    Southeast Asia radar and forecast with precipitation type
    seasia.png
    TIME RESOLUTION:
    • Observation: 10min with 1 day history
    • Radar forecast: 10min up to 1h 30min
    • Rain forecast 3h up to 3d
    TIME RESOLUTION:
    UPDATE: 10 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Thailand, Philippines, Malaysia, Vietnam, Singapore, Brunei, (parts of Laos, Cambodia)
    Australia 5 minute radar and forecast
    australia5.png
    TIME RESOLUTION:
    • Observation: 5min with 2h 45min history
    • Radar forecast: 5min up to 1h 30min
    TIME RESOLUTION:
    UPDATE: 5 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain
    REGIONS: Australia
    Australia radar and precipitation forecast with precipitation type
    rain.png
    TIME RESOLUTION:
    • Observation: 15min with 1 day history 
    • Radar forecast: 15min up to 2h 30min
    • Rain forecast: 3h up to 3d
    UPDATE: 10 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Australia
    Global precipitation forecast with precipitation type
    precipitation.png
    TIME RESOLUTION: 15min (up to 16h), 3h (up to 3d)
    HISTORY: 6h
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: global
    Satellite
    satellite.png
    TIME RESOLUTION: 1h
    HISTORY: 6h
    UPDATE: 1h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Satellite + cloudiness forecast
    satellite.png
    TIME RESOLUTION:
    • Observation: 1h with 6h history (updates every 1h)
    • Cloudiness forecast: 1h up to 2 days (updates every 6h)
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Temperature
    temperature.png
    TIME RESOLUTION: 1h (up to 1d 12h), 3h (up to 5d 12h)
    HISTORY: 0h
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Legend in celcius (fahrenheit optional)
    Cloud cover
    cloud.png
    TIME RESOLUTION: 1h (up to 1d 12h), 3h (3d 12h)
    HISTORY: 0h
    UPDATE: 6h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Wind symbol with speed and direction
    wind.png
    TIME RESOLUTION: 1h (up to 1d 12h), 3h (3d 12h)
    FILETYPE: SVG (Exception for this layer)
    HISTORY: 0h
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    QUERY PARAMETER: Wind speed unit as an optional query parameter, see Tile endpoint for details.
    Wind layer
    wind-layer.png
    TIME RESOLUTION: 1h (up to 1d 12h), 3h (3d 12h)
    HISTORY: 1d
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Legend in m/s (mph optional)
    UV-index
    uv.png
    TIME RESOLUTION: 1d up to 5d
    HISTORY: 1d
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Sea temperature
    sea-temperature.png
    TIME RESOLUTION: 1h (up to 1d 12h), 3h (3d 12h)
    HISTORY: 1d
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global, NOTE! Land areas are also covered. It is easiest to add a map layer on top of the sea temperature layer.
    Legend in celcius (fahrenheit optional)
    Mean sea level pressure (contour)
    pressure_lines.png
    TIME RESOLUTION: 3h up to 4d
    HISTORY: 1d
    UPDATE: 12h
    MINZOOM: 4, MAXZOOM: 14
    REGIONS: global
    Mean sea level pressure (colored)
    pressure_colored.png
    TIME RESOLUTION: 3h up to 4d
    HISTORY: 1d
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Air quality index
    airquality.png
    TIME RESOLUTION: 1h (up to 12h) 3h (up to 4d)
    HISTORY: 12h
    UPDATE: 1h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Approximate snow depth
    snow.png
    TIME RESOLUTION: 3h (up to 5d 12h) 6h (up to 10d)
    HISTORY: 1d
    UPDATE: 12h
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: global
    Legend in cm (inches optional)
    Ragweed pollen for Europe
    pollen.png
    TIME RESOLUTION: 1h (up to 36h) 3h (up to 48h)
    HISTORY: 12h
    UPDATE:24h
    MINZOOM: 2, MAXZOOM: 21
    REGION: Europe
    Alder pollen for Europe
    pollen.png
    TIME RESOLUTION: 1h (up to 36h) 3h (up to 48h)
    HISTORY: 12h
    UPDATE:24h
    MINZOOM: 2, MAXZOOM: 21
    REGION: Europe
    Birch pollen for Europe
    pollen.png
    TIME RESOLUTION: 1h (up to 36h) 3h (up to 48h)
    HISTORY: 12h
    UPDATE:24h
    MINZOOM: 2, MAXZOOM: 21
    REGION: Europe
    Olive pollen for Europe
    pollen.png
    TIME RESOLUTION: 1h (up to 36h) 3h (up to 48h)
    HISTORY: 12h
    UPDATE:24h
    MINZOOM: 2, MAXZOOM: 21
    REGION: Europe
    Grass pollen for Europe
    pollen.png
    TIME RESOLUTION: 1h (up to 36h) 3h (up to 48h)
    HISTORY: 12h
    UPDATE:24h
    MINZOOM: 2, MAXZOOM: 21
    REGION: Europe
    Mugworth pollen for Europe
    pollen.png
    TIME RESOLUTION: 1h (up to 36h) 3h (up to 48h)
    HISTORY: 12h
    UPDATE:24h
    MINZOOM: 2, MAXZOOM: 21
    REGION: Europe
    Europe 1 hour Radar Precipitation Accumulation
    tile_136_20250826110000_4_9_4.png
    TIME RESOLUTION:
    • Observation: 1 hour accumulation
    UPDATE: 1 hour
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: Europe
    Europe 24 hour Radar Precipitation Accumulation
    tile_137_20250826110000_4_9_4.png
    TIME RESOLUTION:
    • Observation: 24 hour accumulation
    UPDATE: 1 hour
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: Europe
    North America 1 hour Radar Precipitation Accumulation
    tile_138_20250823230000_5_8_13.png
    TIME RESOLUTION:
    • Observation: 1 hour accumulation
    UPDATE: 1 hour
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: Continental USA, Alaska, Hawaii, Puerto Rico, Canada (partial coverage)
    North America 24 hour Radar Precipitation Accumulation
    tile_139_20250824000000_5_8_13.png
    TIME RESOLUTION:
    • Observation: 24 hour accumulation
    UPDATE: 1 hour
    MINZOOM: 2, MAXZOOM: 21
    REGIONS: Continental USA, Alaska, Hawaii, Puerto Rico, Canada (partial coverage)
    Zoom levels correspond to google map zoom levels.
    Global region latitudes: minLat: -73, maxLat: 73, minLon: -180, maxLon: 180
    To test and explore various map layers and see how requests are made, please visit the following link:
    Test map layers
    To see and explore various map layers in action on Foreca.com website, please visit the following link:
    Foreca Weather Maps

    Available national radars
    Thailand Weather Radar Composite
    radar.png
    TIME RESOLUTION:
    • Observation: 5min with 3 hour history 
    • Radar forecast: 5min up to 1h 30min
    UPDATE: 15 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain
    REGIONS: Thailand
    Turkey Weather Radar Composite
    radar.png
    TIME RESOLUTION:
    • Observation: 5min with 1 day history 
    • Radar forecast: 5min up to 3h
    • Rain forecast 3h up to 3d
    UPDATE: 12 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain
    REGIONS: Turkey
    Brazil Weather Radar Composite
    radar.png
    TIME RESOLUTION:
    • Observation: 10min with 1 day history
    • Radar forecast: 10min up to 1h 30min
    • Rain forecast 3h up to 3d
    UPDATE: 20 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain
    REGIONS: Brazil
    East Malaysia Weather Radar Composite
    radar.png
    TIME RESOLUTION:
    • Observation: 15min with 1 day history 
    • Radar forecast: 15min up to 2h 30min
    • Rain forecast: 3h up to 3d
    UPDATE: 10 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain
    REGIONS: East Malaysia
    Peninsular Malaysia Weather Radar Composite
    radar.png
    TIME RESOLUTION:
    • Observation: 10min with 1 day history
    • Radar forecast: 10min up to 1h 30min
    • Rain forecast 3h up to 3d
    UPDATE: 10 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain
    REGIONS: Peninsular Malaysia
    Canary Weather Radar Composite
    rain.png
    TIME RESOLUTION:
    • Observation: 10min with 1 day history
    • Radar forecast: 10min up to 1h 30min
    • Rain forecast 3h up to 3d
    UPDATE: 10 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain, sleet, snow
    REGIONS: Canary Islands
    Mexico Weather Radar Composite
    mx.png
    TIME RESOLUTION:
    • Observation: 10min with 1 day history
    • Radar forecast: 10min up to 1h 30min
    • Rain forecast 3h up to 3d
    UPDATE: 10 minutes
    MINZOOM: 2, MAXZOOM: 21
    TYPES: rain
    REGIONS: Mexico
    Zoom levels correspond to google map zoom levels.
    Global region latitudes: minLat: -73, maxLat: 73, minLon: -180, maxLon: 180
    To test and explore various map layers and see how requests are made, please visit the following link:
    Test map layers
    To see and explore various map layers in action on Foreca.com website, please visit the following link:
    Foreca Weather Maps
    GET
    /api/v1/capabilities
    {
  "images": [
    {
      "id": 2,
      "attribution": null,
      "title": "Temperature",
      "description": "Global surface temperature",
      "formats": [
        "image/png"
      ],
      "colorschemes": [
        "default",
        "tempdata-mapped-noalpha"
      ],
      "times": {
        "updated": "2022-01-27T00:00:00Z",
        "available": [
          "2022-01-27T06:00:00Z",
          "2022-01-27T07:00:00Z",
          "2022-01-27T08:00:00Z",
          "2022-01-27T09:00:00Z",
          "2022-01-27T10:00:00Z",
          "2022-01-27T11:00:00Z",
          "2022-01-27T12:00:00Z",
          "2022-01-27T13:00:00Z"
        ],
        "current": 33
      },
      "analysis": "20240222000000",
      "extent": {
        "minLat": -90,
        "maxLat": 90,
        "minLon": -180,
        "maxLon": 180,
        "minZoom": 2,
        "maxZoom": 14
      }
    },
    {
      "id": 5,
      "attribution": "EUMETNET",
      "title": "Europe precipitation radar and forecast",
      "description": "Radar + radar forecast + cell simulated precipitation with precipitation type (EU)",
      "formats": [
        "image/png"
      ],
      "colorschemes": [
        "default"
      ],
      "times": {
        "updated": "2022-01-27T13:45:00Z",
        "available": [
          "2022-01-13T04:45:00Z",
          "2022-01-13T05:00:00Z",
          "2022-01-13T05:15:00Z",
          "2022-01-13T05:30:00Z",
          "2022-01-13T05:45:00Z",
          "2022-01-13T06:00:00Z",
          "2022-01-13T06:15:00Z",
          "2022-01-13T06:30:00Z",
          "2022-01-13T06:45:00Z",
          "2022-01-13T07:00:00Z"
        ],
        "current": 104
      },
      "analysis": "20240222113000",
      "extent": {
        "minLat": -40.89080609,
        "maxLat": 79.171,
        "minLon": -89.91202346,
        "maxLon": 89.91202346,
        "minZoom": 3,
        "maxZoom": 11
      }
    }
  ]
}
    Tile
    Tile endpoint is used to obtain weather map tiles (size 256x256) for the given layer and color scheme.
  • id 
    Layer id
  • x 
    X index of the requested tile
  • y 
    Y index of the requested tile
  • z 
    Zoom level of the requested tile
  • time 
    UTC timestamp value for the data to retrieve in ISO 8601 format. Must appear in the available times list
  • token 
    Access token as provided by authorization endpoint
  • colorscheme (optional)
    Layer color scheme. Must appear in the color scheme list returned by capabilities endpoint
  • updated (optional)
    Include the updated timestamp as an optional query parameter when requesting rapidly updating layers to prevent fetching tiles from outdated analyses.
  • windunit (optional)
    Wind speed unit on the wind symbol map layer. Supported values: ms (m/s, the default), knots, kmh (km/hour), or mph (miles/hour).
    • GET
    /api/v1/image/tile/:z/:x/:y/:time/:id
    tile_example.png
    Legend
    Legend endpoint is used to obtain legend image for a color scheme
  • colorscheme 
    Color scheme id. Must appear in the color scheme list returned by capabilities endpoint
  • id 
    Layer id
  • token 
    Access token as provided by authorization endpoint
    • GET
    /api/v1/legend/:colorscheme/:id
    legend_example.png
    Air Quality
    Air quality forecasts: an air quality index (AQI) that summarizes air pollution taking into account multiple components (carbon monoxide, nitrogen dioxide, ozone, sulfur dioxide and particulate matter). The forecast is based on observations and numerical modeling, resulting in AQI values calculated based on the United States EPA standard.
    Hourly
    Hourly air quality forecasts.
  • location 
    "Longitude, latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 24, maximum 84)
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • lang (optional)
    Language (ISO 639-1 codes). Options: ar, bg, cs, da, de, el, en, et, es, fa, fi, fr, hi, hr, hu, id, is, it, ja, ko, lt, lv, nl, no, pl, pt, ro, ru, sk, sr, sv, ta, th, tr, uk, vi, zh (Simplified Chinese), zh_hk (Traditional Chinese). (default en)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/air-quality/forecast/hourly/:location
    {
  "forecast": [
    {
      "time": "2022-02-03T10:00Z",
      "pollutant": "Particulate matter <2.5um",
      "pollutantPhrase": "Particulate matter <2.5 µm",
      "AQI": 102,
      "AQI_CO": 8,
      "AQI_NO2": 6,
      "AQI_O3": 24,
      "AQI_SO2": 4,
      "AQI_PM10": 64,
      "AQI_PM2P5": 102
    },
    {
      "time": "2022-02-03T11:00Z",
      "pollutant": "Particulate matter <2.5um",
      "pollutantPhrase": "Particulate matter <2.5 µm",
      "AQI": 101,
      "AQI_CO": 7,
      "AQI_NO2": 7,
      "AQI_O3": 25,
      "AQI_SO2": 6,
      "AQI_PM10": 63,
      "AQI_PM2P5": 101
    }
  ]
}
  • time • string
    ISO 8601 date and time
  • pollutant • string
    Most significant pollution type ("Carbon monoxide", "Nitrogen dioxide", "Ozone", "Particulate matter <10um", "Particulate matter <2.5um", "Sulphur dioxide")
  • pollutantPhrase • string
    Description of most significant pollution type in given language (e.g. "Carbon monoxide", "Nitrogen dioxide", "Ozone", "Particulate matter <10 μm", "Particulate matter <2.5 μm" or "Sulphur dioxide")
  • AQI • number
    General AQI: lower is better
  • AQI_CO • number
    AQI based on carbon monoxide
  • AQI_NO2 • number
    AQI based on nitrogen dioxide
  • AQI_O3 • number
    AQI based on ozone
  • AQI_SO2 • number
    AQI based on sulfur dioxide
  • AQI_PM10 • number
    AQI based on particulate matter (PM10)
  • AQI_PM2P5 • number
    AQI based on particulate matter (PM2.5)
    • Daily
    Daily air quality forecasts.
  • location 
    "Longitude, latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 3, maximum 3)
  • lang (optional)
    Language (ISO 639-1 codes). Options: ar, bg, cs, da, de, el, en, et, es, fa, fi, fr, hi, hr, hu, id, is, it, ja, ko, lt, lv, nl, no, pl, pt, ro, ru, sk, sr, sv, ta, th, tr, uk, vi, zh (Simplified Chinese), zh_hk (Traditional Chinese). (default en)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/air-quality/forecast/daily/:location
    {
  "forecast": [
    {
      "date": "2022-02-03",
      "AQI": 111,
      "pollutant": "Particulate matter <2.5um",
      "pollutantPhrase": "Particulate matter <2.5 µm",
      "AQI_CO": 7,
      "AQI_NO2": 48,
      "AQI_GO3": 71,
      "AQI_SO2": 59,
      "AQI_PM2P5": 111,
      "AQI_PM10": 66
    },
    {
      "date": "2022-02-04",
      "AQI": 129,
      "pollutant": "Ozone",
      "pollutantPhrase": "Ozone",
      "AQI_CO": 23,
      "AQI_NO2": 35,
      "AQI_GO3": 129,
      "AQI_SO2": 49,
      "AQI_PM2P5": 106,
      "AQI_PM10": 65
    }
  ]
}
  • date • string
    ISO 8601 date
  • AQI • number
    General AQI: lower is better
  • pollutant • string
    Most significant pollution type ("Carbon monoxide", "Nitrogen dioxide", "Ozone", "Particulate matter <10um", "Particulate matter <2.5um", "Sulphur dioxide")
  • pollutantPhrase • string
    Description of most significant pollution type in given language (e.g. "Carbon monoxide", "Nitrogen dioxide", "Ozone", "Particulate matter <10 μm", "Particulate matter <2.5 μm" or "Sulphur dioxide")
  • AQI_CO • number
    AQI based on carbon monoxide
  • AQI_NO2 • number
    AQI based on nitrogen dioxide
  • AQI_O3 • number
    AQI based on ozone
  • AQI_SO2 • number
    AQI based on sulfur dioxide
  • AQI_PM10 • number
    AQI based on particulate matter (PM10)
  • AQI_PM2P5 • number
    AQI based on particulate matter (PM2.5)
    • Pollen
    Feature
    Pollen forecasts are made using numerical modeling and observational data. The pollen concentrations are described with pollen grains per cubic meter of air (grains/m3).  Pollen forecasts for the following species are available in the Pollen API: alder, birch, grass, mugwort, olive and ragweed. The pollen forecasts are currently available only for Europe.
    Pollen rating
    How people react to various amounts of pollen varies enormously. It may depend on the species of pollen, the location, or other individual factors. This pollen rating system provides some indication of the pollen concentration, but the classification is general in nature and subject to significant individual variation. The pollen rating has five different levels, and each level is described by an index ranging from 0 to 4.
    pollen-rating.png
    0 = no pollen (or very little)
    NOTE! not equal to 0 grains/m3, No pollen is reported when the amount of pollen is less than 0.2 grains/m3 for all pollen types.
    1 = low
    Low pollen is indicated when the amount of pollen is less than 10 grains/m3 for all pollen types.
    2 = moderate
    Moderate pollen varies for the pollen type. For alder, birch and olive, moderate pollen is indicated for pollen concentrations below 100 grains/m3.  For grass and ragweed, moderate pollen is indicated for pollen concentrations below 30 grains/m3 and for mugwort pollen, moderate levels are indicated for concentrations below 50 grains/m3.
    3 = high
    High pollen varies for the pollen type. For alder, birch and olive, high pollen is indicated for pollen concentrations below or equal to 500 grains/m3. For grass, ragweed and mugwort, high pollen is indicated for pollen concentrations below or equal to 100 grains/m3.
    4 = very high
    When the pollen concentration is above 500 grains/m3 for alder, birch and olive, very high pollen is indicated. For grass, ragweed and mugwort, very high pollen is indicated for pollen concentrations above 100 grains/m3.
    Hourly
    Hourly pollen forecasts.
  • location 
    "Longitude, latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 24, maximum 84)
  • tz (optional)
    Time zone in response (IANA time zone database names)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/pollen/forecast/hourly/:location
    {
  "forecast": [
    {
      "time": "2023-03-28T14:00+02:00",
      "alder": 1,
      "birch": 0,
      "grass": 1,
      "mugwort": 0,
      "olive": 0,
      "ragweed": 0,
      "alder_m3": 0.3,
      "birch_m3": 0.1,
      "grass_m3": 0.325,
      "mugwort_m3": 0,
      "olive_m3": 0,
      "ragweed_m3": 0
    }
  ]
}
  • date • string
    ISO 8601 date and time
  • pollen species • number
    Numbers 0-4. Zero indicating no pollen, four indicating very high pollen concentrations
  • pollen species m3 • number
    The hourly pollen concentration in grains/m3
    • Daily
    Daily pollen forecasts.
  • location 
    "Longitude, latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 3, maximum 3)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/pollen/forecast/daily/:location
    {
  "forecast": [
    {
      "date": "2023-03-29",
      "alder": 1,
      "birch": 1,
      "grass": 1,
      "mugwort": 0,
      "olive": 0,
      "ragweed": 0,
      "alder_m3": 0.2,
      "birch_m3": 0.65,
      "grass_m3": 0.45,
      "mugwort_m3": 0,
      "olive_m3": 0,
      "ragweed_m3": 0
    }
  ]
}
  • date • string
    ISO 8601 date
  • pollen species • number
    Numbers 0-4. Zero indicating no pollen, four indicating very high pollen concentrations
  • pollen species m3 • number
    The daily pollen concentration in grains/m3. The value is the maximum pollen concentration for that day.
    • Climate
    Feature
    Weather statistics.
    Monthly climate
    Averages and other summary weather statistics, by month. The values are based on a 30-year period 1991-2020.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/climate/monthly/:location
    {
  "climate": [
    {
      "month": "01",
      "dayMaxTemp": -0.76,
      "dayMinTemp": -5.68,
      "dayAvgTemp": -3.2,
      "precipSum": 55.17,
      "dailyPrecip": 1.78,
      "rainDays": 19.09,
      "frostDays": 26.42,
      "seaSurfaceTemp": 0.85
    },
    {
      "month": "02",
      "dayMaxTemp": -1.09,
      "dayMinTemp": -6.64,
      "dayAvgTemp": -3.86,
      "precipSum": 38.34,
      "dailyPrecip": 1.37,
      "rainDays": 14.62,
      "frostDays": 24.6,
      "seaSurfaceTemp": -0.69
    },
    {
      "month": "03",
      "dayMaxTemp": 2.62,
      "dayMinTemp": -4.01,
      "dayAvgTemp": -0.69,
      "precipSum": 37.21,
      "dailyPrecip": 1.2,
      "rainDays": 13.68,
      "frostDays": 24.75,
      "seaSurfaceTemp": -1.05
    }
  ]
}
  • month • string
    Month of year
  • dayMaxTemp • number
    Daily maximum temperature
  • dayMinTemp • number
    Daily minimum temperature
  • dayAvgTemp • number
    Daily average temperature
  • precipSum • number
    Precipitation sum (mm)
  • dailyPrecip • number
    Precipitation accumulation during a day (mm)
  • rainDays • number
    Number of rain days in month (≥0.1 mm of precipitation)
  • frostDays • number
    Number of frost days in month
  • seaSurfaceTemp • number or null
    Average sea surface temperature, null outside seas or coastal areas
    • Daily climate
    Temperature statistics of a given day in a location. The values are 15-day central moving averages of 30-year averages of daily values during 1991-2020.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • monthday 
    "month-day" as two two-digit numbers, separated by a dash, e.g., 05-27 for May 27
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/climate/daily/:location
    {
  "climate": [
    {
      "month": "01",
      "day": "12",
      "avgMinTemp": -4.53,
      "avgTemp": -2.77,
      "avgMaxTemp": -0.87
    }
  ]
}
  • month • string
    Month of year
  • day • string
    Day of the month
  • avgMinTemp • number
    Average minimum temperature of the day
  • avgTemp • number
    Average temperature of the day
  • avgMaxTemp • number
    Average maximum temperature of the day
    • History
    Feature
    Weather History API provides observational weather information from the past by showing measured weather parameters in a certain location at a specific date. The API delivers all the measured weather parameters as both daily summary values and hourly values. The queries can be made based on a given day and coordinate point. The API will respond with observational data from the nearest relevant weather station or from weather forecast model data (augmented observation). Augmented observations are provided when the closest weather station with sufficient observations is too far away to give representative information. History data is available from January 2009.
    Read more about weather history
    You will receive details about how to use the history API, as well as the endpoint, within your sign-up email.
    Point history
  • lon 
    Longitude
  • lat 
    Latitude
  • date 
    Date in YYYYMMDD format
  • days (optional)
    Feature: number of days returend, starting at "date" (default 1, maximum 14)
  • tempunit (optional)
    Temperature unit (F, C; default C)
  • windunit (optional)
    Wind unit (MS, KTS, KMH, MPH, BFT; default MS)
  • precunit (optional)
    Precipitation unit (MM, IN)
  • lang (optional)
    Language (ISO 639-1 codes). Options: de, en, es, fr, it, pl, ru, fi, sv, nl, ko, pt, th, tr, zh, zh_TW (Chinese in Taiwan), zh_CN (Chinese in China). (default en)
    • Click the schema button to see a complete list of available parameters.
    GET
    {
  "station": {
    "name": "Tholen Wp",
    "lon": 4.2,
    "lat": 51.48
  },
  "hourly": {
    "date": {
      "pretty": "00:00 on January 23, 2016",
      "year": "2016",
      "month": "01",
      "day": "23",
      "hour": "00",
      "min": "00",
      "tz": "Europe/Amsterdam"
    },
    "utcdate": {
      "iso8601": "2016-01-22T23:00",
      "year": "2016",
      "month": "01",
      "day": "22",
      "hour": "23",
      "min": "00",
      "tz": "UTC"
    },
    "observations": [
      {
        "dt": {
          "pretty": "00:00 on January 23, 2016",
          "year": "2016",
          "month": "01",
          "day": "23",
          "hour": "00",
          "min": "00",
          "tz": "Europe/Amsterdam"
        },
        "dtu": {
          "iso8601": "2016-01-22T23:00",
          "year": "2016",
          "month": "01",
          "day": "22",
          "hour": "23",
          "min": "00",
          "tz": "UTC"
        },
        "t": "5.7",
        "d": "5.6",
        "rh": "99",
        "ws": "4",
        "gust": "4",
        "wd": "230",
        "wn": "southwest",
        "v": "400",
        "p": "1022.2",
        "tf": "3",
        "pr1": "",
        "sT": "Haze",
        "s": "600",
        "fog": "1",
        "rain": "0",
        "snow": "0",
        "hail": "0",
        "thunder": "0",
        "tornado": "0"
      }
    ]
  },
  "dailysummary": {
    "dt": {
      "pretty": "00:00 on January 23, 2016",
      "year": "2016",
      "month": "01",
      "day": "23",
      "hour": "00",
      "min": "00",
      "tz": "Europe/Amsterdam"
    },
    "fog": "1",
    "rain": "0",
    "snow": "0",
    "snowfall": "",
    "snowfallmonthtodate": "",
    "snowfallsincejul1": "",
    "snowdepth": "",
    "hail": "0",
    "thunder": "0",
    "tornado": "0",
    "ta": "6.2",
    "da": "5.6",
    "pa": "1029.7",
    "wsa": "3.5",
    "wna": "north",
    "wda": "219",
    "va": "4857",
    "rha": "96",
    "tx": "8",
    "tn": "4",
    "rhx": "100",
    "rhn": "87",
    "dx": "7",
    "dn": "4",
    "px": "1033.5",
    "pn": "1022.2",
    "wsx": "5",
    "wsn": "2",
    "vx": "10600",
    "vn": "390",
    "pr24": "",
    "prtype": "noprec"
  }
}
  • t • string
    Temperature
  • d • string
    Dew point
  • rh • string
    Relative humidity (%)
  • ws • string
    Wind speed
  • gust • string
    Wind gust speed
  • wd • string
    Wind direction in degrees
  • wn • string
    Wind direction (N, NE, E, SE, S, SW, W, NW)
  • v • string
    visibility in meters, e.g. "10000" for 10 km
  • p • string
    Atmospheric pressure normalized to sea level (hPa)
  • tf • string
    Feels like temperature
  • pr1 • string
    1 hour accumulated precipitation
  • sT • string
    symbol text
  • s • string
    Weather symbol code
  • fog • string
    Whether there was fog
  • rain • string
    Whether there was rain
  • snow • string
    Whether there was snow
  • hail • string
    Whether there was hail
  • thunder • string
    Whether there was thunder
  • tornado • string
    Whether there were tornadoes
  • snowfall • string
    Accumulated snowfall (cm)
  • snowfallmonthtodate • string
    Accumulated snowfall month-to-date
  • snowfallsincejul1 • string
    Accumulated snowfall since last july 1st
  • snowdepth • string
    Snow depth (cm)
  • ta • string
    Average temperature
  • da • string
    Average dew point
  • pa • string
    Average pressure (hPa)
  • wsa • string
    Average wind speed
  • wna • string
    Average wind direction name
  • wda • string
    Average wind direction (degrees)
  • va • string
    Average visibility (meters)
  • rha • string
    Average relative humidity (%)
  • tx • string
    Maximum temperature
  • tn • string
    Minimum temperature
  • rhx • string
    Maximum relative humidity (%)
  • rhn • string
    Minimum relative humidity (%)
  • dx • string
    Maximum dew point
  • dn • string
    Minimum dew point
  • px • string
    Maximum pressure (hPa)
  • pn • string
    Minimum pressure (hPa)
  • wsx • string
    Maximum wind speed
  • wsn • string
    Minimum wind speed
  • vx • string
    Maximum visibility (meters)
  • vn • string
    Minimum visibility (meters)
  • pr24 • string
    Accumulated precipitation from 24h
  • prtype • string
    Most occurred precipitation type (rain, hail, snow, mixed) or noprec if no precipitation during the time
    • Warnings
    Feature
    Governmental severe weather warnings are currently delivered from: Argentina, Australia, Austria, Belarus, Belgium, Bosnia and Herzegovina, Brazil, Bulgaria, Canada, Chile, Colombia, Costa Rica, Croatia, Cyprus, Czech Republic, Denmark, Ecuador, Egypt, Estonia, Finland, France, Germany, Greece, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Republic of Ireland, Israel, Italy, Japan, South Korea, Latvia, Lithuania, Luxembourg, North Macedonia, Malaysia, Malta, Mexico, Moldova, Montenegro, Netherlands, New Zealand, Norway, Peru, Philippines, Poland, Portugal, Romania, Russia, Saudi Arabia, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, South Africa, Taiwan, Thailand, Ukraine, United Kingdom and United States.
    Read more about weather warnings
    Point warnings
  • location 
    "Longitude, latitude" or location identifier (id) from the location endpoint
  • future (optional)
    Whether to return warnings starting more than 24 hours from now (boolean: default 0)
  • dataset (optional)
    Variable set: "standard" or "full" (default "standard")
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/warning/:location
    {
  "warnings": [
    {
      "type": "FO",
      "significance": "Y",
      "attribution": null,
      "validFrom": "2021-01-08T10:17:00Z",
      "validUntil": "2021-01-08T17:00:00Z",
      "description": [
        {
          "lang": "en",
          "text": "Dense Fog Advisory issued January 08 at 4:17AM CST until January 08 at 11:00AM CST by NWS Minneapolis&10;&10;Anoka; Benton; Blue Earth; Brown; Carver; Chippewa; Chisago; Douglas; Hennepin; Isanti; Kanabec; Kandiyohi; Lac Qui Parle; Le Sueur; Martin; McLeod; Meeker; Mille Lacs; Morrison; Nicollet; Pope; Ramsey; Redwood; Renville; Scott; Sherburne; Sibley; Stearns; Stevens; Swift; Todd; Watonwan; Wright; Yellow Medicine&10;&10;...DENSE FOG ADVISORY REMAINS IN EFFECT UNTIL 11 AM CST THIS&10;MORNING...&10;* WHAT...Visibility one quarter mile or less in dense fog.&10;* WHERE...Portions of central, east central, south central,&10;southwest and west central Minnesota.&10;* WHEN...Until 11 AM CST Friday.&10;* IMPACTS...Hazardous driving conditions due to low visibility.&10;* ADDITIONAL DETAILS...Slick spots on roads, overpasses, and&10;sidewalks are also possible as the fog freezes on exposed&10;surfaces.&10;&10;If driving, slow down, use your headlights, and leave plenty of&10;distance ahead of you."
        }
      ],
      "attributionUrl": null,
      "link": "https://alerts.weather.gov/cap/wwacapget.php?x=MN126188507444.DenseFogAdvisory.126188517F10MN.MPXNPWMPX.6f0fa4bac3937d8409b5648ff85e9eea",
      "sent": "2021-01-08T10:17:00Z",
      "name": "Fog",
      "significanceDescription": "Potentially dangerous"
    }
  ]
}
  • type • string
    Warning ID
  • significance • string
    One of: Y (yellow, moderate), O (orange, severe), R (red, extreme), P (purple, emergency), NP (not applicable, very minor)
  • attribution • string
    Attribution: organization abbreviations
  • attributionUrl • string
    Attribution URL
  • validFrom • string
    ISO 8601 date and time
  • validUntil • string
    ISO 8601 date and time
  • lang • string
    Language of warning description (ISO 639-1 codes)
  • text • string
    Description of the particular warning in the associated language
  • significanceDescription • string
    Description of significance level
  • link • string
    Link to warning description provided by source (if applicable)
  • sent • string
    ISO 8601 date and time of warning sent
  • title • string
    Event title (dataset=full)
  • langArea • string
    Language area (dataset=full)
    • Warning type names
    Metadata for all warning types.
    Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/warning/types
    {
  "AQ": {
    "name": "Air quality"
  },
  "AS": {
    "name": "Volcanic ashfall"
  },
  "AV": {
    "name": "Avalanche"
  },
  "CD": {
    "name": "Civil danger"
  },
  "CE": {
    "name": "Coastal event"
  }
}
  • name • string
    Name of warning type
    • Marine
    Feature
    Marine forecasts of waves and sea temperatures.
    Hourly
    Hourly marine forecasts.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 24, maximum 168)
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • history (optional)
    History: whether to include past 24 hours (1 or 0, default 0)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/marine/forecast/hourly/:location
    {
  "forecast": [
    {
      "peak1DSpectraPeriod": 9.8,
      "seaTemp": 27,
      "sigSwellHeight": 1.13,
      "sigWaveHeight": 1.19,
      "swellDir": 178,
      "swellPeriod": 8.1,
      "swimTemp": 27,
      "time": "2025-11-04T17:00Z",
      "waveDir": 177,
      "wavePeriod": 7.5,
      "windWaveDir": 168,
      "windWavePeriod": 2.9,
      "windWaveSigHeight": 0.39
    },
    {
      "peak1DSpectraPeriod'": 10,
      "seaTemp": 27,
      "sigSwellHeight": 1.13,
      "sigWaveHeight": 1.19,
      "swellDir": 178,
      "swellPeriod": 8.1,
      "swimTemp": 27,
      "time": "2025-11-04T18:00Z",
      "waveDir": 177,
      "wavePeriod": 7.6,
      "windWaveDir": 171,
      "windWavePeriod": 2.9,
      "windWaveSigHeight": 0.39
    },
    {
      "peak1DSpectraPeriod": 10.1,
      "seaTemp": 27,
      "sigSwellHeight": 1.13,
      "sigWaveHeight": 1.19,
      "swellDir": 178,
      "swellPeriod": 8.1,
      "swimTemp": 27,
      "time": "2025-11-04T19:00Z",
      "waveDir": 177,
      "wavePeriod": 7.6,
      "windWaveDir": 172,
      "windWavePeriod": 2.8,
      "windWaveSigHeight": 0.38
    }
  ]
}
  • time • string
    ISO 8601 date and time
  • peak1DSpectraPeriod • number
    Peak wave period, of 1D spectra, in seconds, ≥ 0
  • seaTemp • number
    Sea temperature
  • sigSwellHeight • number
    Significant swell wave height, in metres, ≥ 0
  • sigWaveHeight • number
    Significant wave height, in metres
  • swellDir • number
    The direction where total swell is coming from, in degrees, 0...360° (0°: from north, 180°: from south)
  • swellPeriod • number
    Mean period of total swell, in seconds
  • swimTemp • number
    Sea temperature in swimming locations
  • waveDir • number
    The mean direction where waves are coming from, in degrees
  • wavePeriod • number
    Mean wave period, in seconds
  • windWaveDir • number
    The mean direction where wind waves are coming from, in degrees
  • windWavePeriod • number
    Period of wind waves, in seconds
  • windWaveSigHeight • number
    Significant height of wind waves, in metres
    • Daily
    Daily marine forecasts.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 7, maximum 14)
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/marine/forecast/daily/:location
    {
  "forecast": [
    {
      "date": "2025-11-04",
      "maxPeak1DSpectraPeriod": 10.3,
      "maxSeaTemp": 27,
      "maxSigWaveHeight": 1.23,
      "maxSwellHeight": 1.17,
      "maxSwellPeriod": 8.3,
      "maxSwimTemp": 27,
      "maxWavePeriod": 7.7,
      "maxWindWavePeriod": 3.5,
      "maxWindWaveSigHeight": 0.6
    },
    {
      "date": "2025-11-05",
      "maxPeak1DSpectraPeriod": 11.3,
      "maxSeaTemp": 28,
      "maxSigWaveHeight": 1.2,
      "maxSwellHeight": 1.18,
      "maxSwellPeriod": 8.2,
      "maxSwimTemp": 27,
      "maxWavePeriod": 8,
      "maxWindWavePeriod": 2.8,
      "maxWindWaveSigHeight": 0.36
    },
    {
      "date": "2025-11-06",
      "maxPeak1DSpectraPeriod": 10.4,
      "maxSeaTemp": 27,
      "maxSigWaveHeight": 1.5,
      "maxSwellHeight": 1.32,
      "maxSwellPeriod": 8.2,
      "maxSwimTemp": 27,
      "maxWavePeriod": 7.7,
      "maxWindWavePeriod": 4.6,
      "maxWindWaveSigHeight": 0.92
    }
  ]
}
  • date • string
    ISO 8601 date
  • maxPeak1DSpectraPeriod • number
    Maximum peak wave period, of 1D spectra, in seconds, ≥ 0
  • maxSeaTemp • number
    Maximum sea temperature
  • maxSigWaveHeight • number
    Maximum significant wave height, in metres, ≥ 0
  • maxSwellHeight • number
    Maximum swell wave height, in metres
  • maxSwellPeriod • number
    Maximum period of total swell, in seconds
  • maxSwimTemp • number
    Maximum sea temperature in swimming locations
  • maxWavePeriod • number
    Maximum wave period, in seconds
  • maxWindWavePeriod • number
    Maximum period of wind waves, in seconds
  • maxWindWaveSigHeight • number
    Maximum significant height of wind waves, in metres
    • Ski
    Feature
    Ski resort weather conditions and site information.
    Current
    Ski resort conditions.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • sites (optional)
    Number of ski sites (default 1, maximum 5)
  • radius (optional)
    Maximum distance to ski site (default 500 km)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/ski/current/:location
    {
  "locations": [
    {
      "name": "Lake Louise",
      "countryCode": "ca",
      "countryName": "Canada",
      "state": "Alberta",
      "city": "Lake Louise, AB",
      "postalCode": "T0L 1E0",
      "street": "Banff National Park",
      "houseNumber": null,
      "address": "Banff National Park, Lake Louise, AB, T0L 1E0",
      "longitude": -116.159228,
      "latitude": 51.439332,
      "openFrom": "08:30",
      "openUntil": "16:00",
      "isOpen": true,
      "altitudeBase": 1646,
      "altitudePeak": 2637,
      "primarySurfaceCondition": "Gripping snow",
      "liftsOpen": 2,
      "lifts": 7,
      "hasSkiing": true,
      "kmNordic": null,
      "kmPistes": 139,
      "kmOpen": 7,
      "hasValleyRun": true,
      "valleyRunOpen": "true",
      "hasTobogganRuns": false,
      "kmTobogganRuns": null,
      "lastSnowDate": "2020-11-01",
      "lastSnowAmount": null,
      "nightSkiing": false,
      "snowDepthPeak": 52,
      "snowDepthBase": 43,
      "hasFunPark": true,
      "funParkOpen": true,
      "updated": "2020-11-05T00:00:00Z"
    },
    {
      "name": "Sunshine Village",
      "countryCode": "ca",
      "countryName": "Canada",
      "state": "Alberta",
      "city": "Banff",
      "postalCode": "T0L 0C0",
      "street": "Banff-Nationalpark",
      "houseNumber": null,
      "address": "Banff-Nationalpark, Banff, T0L 0C0",
      "longitude": -115.761005,
      "latitude": 51.113248,
      "openFrom": "08:30",
      "openUntil": "16:00",
      "isOpen": false,
      "altitudeBase": 1660,
      "altitudePeak": 2730,
      "primarySurfaceCondition": null,
      "liftsOpen": 0,
      "lifts": 10,
      "hasSkiing": false,
      "kmNordic": null,
      "kmPistes": 109,
      "kmOpen": 0,
      "hasValleyRun": true,
      "valleyRunOpen": "false",
      "hasTobogganRuns": true,
      "kmTobogganRuns": null,
      "lastSnowDate": null,
      "lastSnowAmount": null,
      "nightSkiing": false,
      "snowDepthPeak": null,
      "snowDepthBase": null,
      "hasFunPark": true,
      "funParkOpen": false,
      "updated": "2020-11-05T00:00:00Z"
    }
  ]
}
  • name • string
    Site name
  • countryCode • string
    Country code (ISO 3166-1 alpha-2)
  • countryName • string
    Country name
  • state • string
    State (if applicable)
  • city • string
    City
  • postalCode • string
    Postal code
  • street • string
    Street
  • houseNumber • string
    House number
  • address • string
    Address
  • longitude • string
    longitude
  • latitude • string
    latitude
  • openFrom • string
    Opening time (HH:MM)
  • openUntil • string
    Open until time of day (HH:MM)
  • isOpen • boolean
    Open status
  • altitudeBase • number
    Altitude at base
  • altitudePeak • string
    Altitude at peak
  • primarySurfaceCondition • string
    Surface condition description
  • liftsOpen • number
    Number of lifts open
  • lifts • number
    Total number of lifts
  • hasSkiing • boolean
    Skiing available
  • kmNordic • number
    Nordic skiing length (km)
  • kmPistes • number
    Pistes length (km)
  • kmOpen • number
    Total open (km)
  • hasValleyRun • boolean
    Valley run available
  • valleyRunOpen • string
    Valley run status ("true", "false", "conditional")
  • hasTobogganRuns • boolean
    Toboggan runs available
  • kmTobogganRuns • number
    Length of toboggan runs
  • lastSnowDate • string
    Date of last new snow
  • lastSnowAmount • string
    Amount of new snow last time
  • nightSkiing • boolean
    Night skiing available
  • snowDepthPeak • number
    Depth of snow at peak
  • snowDepthBase • number
    Depth of snow at base
  • hasFunPark • boolean
    Fun park available
  • funParkOpen • boolean
    Fun park open
  • updated • string
    Date and time of last update (ISO 8601)
    • Agriculture
    Feature
    Parameters relating to agriculture.
    Hourly
    Hourly agricultural forecast parameters.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 24, maximum 168)
  • tz (optional)
    Time zone in response (IANA time zone database names)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/agriculture/forecast/hourly/:location
    {
  "forecast": [
    {
      "time": "2022-02-03T10:00+02:00",
      "ET0": 0.1,
      "VPD": 0.27,
      "SSRD": 300
    },
    {
      "time": "2022-02-03T11:00+02:00",
      "ET0": 0.23,
      "VPD": 0.4,
      "SSRD": 436
    },
    {
      "time": "2022-02-03T12:00+02:00",
      "ET0": 0.35,
      "VPD": 0.49,
      "SSRD": 554
    }
  ]
}
  • time • string
    ISO 8601 date and time
  • ET0 • number
    Reference evapotranspiration rate (mm/h)
  • VPD • number
    Vapor pressure deficit (kPa)
  • SSRD • number
    Surface solar radiation downwards, W/m² (watts per square meter)
    • Daily
    Daily agricultural forecast parameters.
  • location 
    "Longitude,latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (default 7, maximum 14)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/agriculture/forecast/daily/:location
    {
  "forecast": [
    {
      "date": "2022-02-03",
      "ET0": 1.18,
      "VPD_max": 0.5,
      "VPD_min": 0.05,
      "VPD": 0.18,
      "SSRD": 2424,
      "precipSum24q10": 0.11,
      "precipSum24q90": 0.21,
      "precipSum168q10": 7.4,
      "precipSum168q90": 20.73
    },
    {
      "date": "2022-02-04",
      "ET0": 1.02,
      "VPD_max": 0.46,
      "VPD_min": 0.05,
      "VPD": 0.18,
      "SSRD": 2710,
      "precipSum24q10": 0,
      "precipSum24q90": 0.02,
      "precipSum168q10": 8.26,
      "precipSum168q90": 20.64
    }
  ]
}
  • date • string
    ISO 8601 date
  • ET0 • number
    Reference evapotranspiration (mm)
  • VPD • number
    Vapor pressure deficit average (kPa)
  • VPD_min • number
    Minimum vapor pressure deficit (kPa)
  • VPD_max • number
    Maximum vapor pressure deficit (kPa)
  • SSRD • number
    Surface solar radiation downwards (24h sum, Wh/m²)
  • precipSum24q10 • number
    Lower bound estimate for precipitation sum during the day (10th percentile, mm)
  • precipSum24q90 • number
    Higher bound estimate for precipitation sum during the day (90th percentile, mm)
  • precipSum168q10 • number
    Lower bound estimate for 7-day precipitation sum during the day and 6 following days (10th percentile, mm)
  • precipSum168q90 • number
    Higher bound estimate for 7-day precipitation sum during the day and 6 following days (90th percentile, mm)
    • Energy
    Feature
    This API serves weather forecasts relevant to energy production. The forecast is based on current weather observations and numerical weather predictions. The forecast is available worldwide.
    Hourly
    Hourly energy forecasts.
  • location 
    "Longitude, latitude" or location identifier (id) from the location endpoint
  • periods (optional)
    Number of time steps (maximum = default = 220)
  • tz (optional)
    Time zone in response (IANA time zone database names)
  • tempunit (optional)
    Temperature unit: "C", "F" (default "C")
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/energy/forecast/hourly/:location
    {
  "forecast": [
    {
      "dewPoint": 0.7,
      "relHumidity": 83,
      "ssrd": 351,
      "temperature": 3.32,
      "time": "2025-04-09T16:00+03:00",
      "windd_h100": 298.24,
      "windd_h150": 301.07,
      "windd_h200": 303.57,
      "winds_h100": 12.78,
      "winds_h150": 13.63,
      "winds_h200": 14.52
    },
    {
      "dewPoint": 0.71,
      "relHumidity": 84,
      "ssrd": 248,
      "temperature": 3.17,
      "time": "2025-04-09T17:00+03:00",
      "windd_h100": 299.03,
      "windd_h150": 301.97,
      "windd_h200": 304.57,
      "winds_h100": 13.07,
      "winds_h150": 13.92,
      "winds_h200": 14.8
    },
    {
      "dewPoint": 0.47,
      "relHumidity": 83,
      "ssrd": 135,
      "temperature": 3.1,
      "time": "2025-04-09T18:00+03:00",
      "windd_h100": 299.21,
      "windd_h150": 302.35,
      "windd_h200": 305.18,
      "winds_h100": 13.06,
      "winds_h150": 13.78,
      "winds_h200": 14.54
    }
  ]
}
  • dewpoint • number
    Dew point, in °C (degree Celsius, or requested tempunit)
  • relHumidity • number
    Relative humidity at 2 m height, in % (percentage)
  • ssrd • number
    Surface short-wave (solar) radiation downwards, in W/m² (watts per square meter)
  • temperature • number
    Temperature at 2 m height, in °C (degree Celsius, or requested tempunit)
  • windd_h100 • number
    Wind direction at 100 m height, in degrees, 0...360° (0°: from north, 180°: from south)
  • windd_h150 • number
    Wind direction at 150 m height, in degrees (from windd_h100 and windd_h200)
  • windd_h200 • number
    Wind direction at 200 m height, in degrees
  • winds_h100 • number
    Wind speed at 100 m height, in m/s (meters per second)
  • winds_h150 • number
    Wind speed at 150 m height, in m/s (from winds_h100 and winds_h200)
  • winds_h200 • number
    Wind speed at 200 m height, in m/s
    • Hurricane
    Feature
    Comprehensive hurricane/cyclone/typhoon data from multiple global meteorological agencies including NOAA (US), JMA (Japan), Australian Bureau of Meteorology, Joint Typhoon Warning Center, RSMC La Réunion (Météo-France), MetService New Zealand, and Fiji Meteorological Service. Data includes complete storm tracks, forecast points, uncertainty cones, wind speed and intensity classifications and detailed meteorological properties, in GeoJSON format. Real-time updates as bulletins are issued (typically every 3-6 hours during active storms).
    Current
    Currently active storms. Returns tracking data with latest positions, intensities, and forecasts.
  • limit_area (optional)
    Limit results to specific geographic areas. Comma-separated list of area codes: "us" (Atlantic/Eastern and Central Pacific), "jp" (Western Pacific), "au" (South Pacific), "in" (North Indian Ocean), "re" (Southwest Indian Ocean/Reunion), "nz" (New Zealand), "fj" (Fiji)
    • Click the schema button to see a complete list of available parameters.
    GET
    /api/v1/hurricane/current
    {
  "data": [
    {
      "type": "FeatureCollection",
      "features": [
        {
          "properties": {
            "name": "ERIN",
            "nameLocal": "ERIN",
            "id": "al52025",
            "shortLabel": "H3",
            "attr": "NOAA",
            "label": "Cat 3 Hurricane",
            "date": "Aug 16, 2025",
            "timeLabel": "Sat 1pm +04",
            "timeISO8601": "2025-08-16T13:00:00+04:00",
            "issued": "2025-08-16 09:00:00",
            "dataType": "OBSERVATION",
            "advisory": 20,
            "stormType": "Hurricane",
            "title": "Hurricane ERIN",
            "category": 3,
            "direction": "West-northwest",
            "directionDEG": 285,
            "pressure": 955,
            "pressureIN": 28.2,
            "maxWind": 120.8,
            "maxWindKTS": 105,
            "maxWindKPH": 194.4,
            "maxWindMS": 54,
            "maxGust": 149.7,
            "maxGustKTS": 130.1,
            "maxGustKPH": 240.9,
            "maxGustMS": 66.9,
            "propagationSpeed": 20.1,
            "propagationSpeedKTS": 17.5,
            "propagationSpeedKPH": 32.3,
            "propagationSpeedMS": 9,
            "probabilityRadius": null
          },
          "type": "Feature",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -61.1,
              19.8
            ]
          }
        }
      ]
    }
  ]
}
  • metadata • object
    Response metadata and available areas
  • data • array
    Array of storm feature collections
  • type • string
    Always "FeatureCollection"
  • features • array
    Array of GeoJSON features representing storm track, points, and cones
  • name • string
    Storm name (e.g., "PODUL", "BERYL")
  • nameLocal • string
    Local language storm name if available
  • id • string
    Unique storm identifier (e.g., "wp152025")
  • category • string
    Current storm category/intensity
  • lastCategory • string
    Most recent observed category
  • maxCategory • string
    Maximum category reached during storm lifecycle
  • dataType • string
    Data type ("OBSERVATION", "FORECAST", "CONE")
  • pressure • number
    Central pressure (hPa/mb)
  • maxWind • number
    Maximum sustained winds (mph)
  • maxWindMS • number
    Maximum sustained winds (m/s)
  • maxGust • number
    Maximum wind gusts (mph)
  • maxGustMS • number
    Maximum wind gusts (m/s)
  • propagationSpeed • number
    Storm movement speed
  • propagationSpeedMS • number
    Storm movement speed (m/s)
  • direction • string
    Storm movement direction
  • timeISO8601 • string
    Time of observation/forecast in ISO 8601 format
  • timeLabel • string
    Human-readable time label
  • lastTime • string
    Time of last observation
  • issued • string
    Time when bulletin was issued
  • advisory • number
    Advisory number
  • attr • string
    Data attribution/source agency
  • title • string
    Full storm title
  • stormType • string
    Storm classification (Hurricane, Typhoon, Cyclone, etc.)
  • shortLabel • string
    Abbreviated storm label (H1, H2, T, C, etc.)
  • label • string
    Storm category label
  • numberLocal • number
    Local numbering system storm number
  • probabilityRadius • string
    Probability radius information for uncertainty (km)
  • maxWindKTS • number
    Maximum sustained winds (knots)
  • maxWindKPH • number
    Maximum sustained winds (km/h)
  • maxGustKTS • number
    Maximum wind gusts (knots)
  • maxGustKPH • number
    Maximum wind gusts (km/h)
  • propagationSpeedKTS • number
    Storm movement speed (knots)
  • propagationSpeedKPH • number
    Storm movement speed (km/h)
  • pressureIN • number
    Central pressure (inches of mercury)
  • directionDEG • number
    Storm movement direction (degrees)
  • date • string
    Date in human-readable format
  • year • number
    Storm year
  • is_last_obs • boolean
    Indicates if this is the last observation point (true when present)
  • geometry • object
    GeoJSON geometry (Point for positions, LineString for tracks, Polygon for cones)
  • coordinates • array
    GeoJSON coordinates array
    • History
    Historical storm data. Returns past storms from 2020 onwards with complete lifecycle information including tracks, intensities, and forecasts. Excludes currently active storms.
  • limit (optional)
    Maximum number of storms to return (default 100, maximum 1000)
  • year (optional)
    Filter by specific year (2020 to current year)
  • limit_area (optional)
    Limit results to specific geographic areas. Comma-separated list of area codes: "us" (Atlantic/Eastern and Central Pacific), "jp" (Western Pacific), "au" (South Pacific), "in" (North Indian Ocean), "re" (Southwest Indian Ocean/Reunion), "nz" (New Zealand), "fj" (Fiji)
    • GET
    /api/v1/hurricane/history
    {
  "data": [
    {
      "type": "FeatureCollection",
      "features": [
        {
          "geometry": {
            "coordinates": [
              131.6,
              28.2
            ],
            "type": "Point"
          },
          "type": "Feature",
          "properties": {
            "pressure": 910,
            "stormType": "Hurricane",
            "dataType": "OBSERVATION",
            "date": "Sep 18, 2022",
            "shortLabel": "T",
            "propagationSpeed": 11.2,
            "maxGustMS": 77.2,
            "direction": "North-northwest",
            "numberLocal": 14,
            "category": 6,
            "id": "wp182022",
            "name": "NANMADOL",
            "probabilityRadius": null,
            "timeISO8601": "2022-09-18T01:00:00+09:00",
            "maxWindMS": 54,
            "issued": "2022-09-17 16:40:00",
            "propagationSpeedMS": 5,
            "maxWind": 120.8,
            "timeLabel": "Sun 1am JST",
            "label": "VT",
            "title": "Violent typhoon NANMADOL",
            "maxGust": 172.6,
            "nameLocal": "ナンマドル",
            "advisory": 59
          }
        }
      ]
    }
  ]
}
    Usage
    Month's usage
    Usage by month.
  • month 
    Month (e.g. "2021-03")
  • user 
    Username
  • password 
    Administrative password
    • POST
    /usage/month/:month
    {
  "apis": [
    {
      "name": "Weather API",
      "hits": 32529
    },
    {
      "name": "Map API",
      "hits": 12020
    },
    {
      "name": "Administrative",
      "hits": 0
    }
  ],
  "hits": 44549
}
    Day's usage
    Usage by day.
  • day 
    Day (e.g. "2021-03-15")
  • user 
    Username
  • password 
    Administrative password
    • POST
    /usage/day/:day
    {
  "apis": [
    {
      "name": "Weather API",
      "hits": 380
    },
    {
      "name": "Map API",
      "hits": 785
    },
    {
      "name": "Administrative",
      "hits": 0
    }
  ],
  "hits": 1165
}