Foreca Weather API Documentation

Premium global weather data, delivered as one REST API.

Evaluating it for your business? Weather API overview: features, use cases and pricing

Get an API key OpenAPI spec for AI assistantsJSON · 120 KB

Quickstart

  1. Get an API key

    Choose a plan on the pricing page. Your key appears in My API, and the Authorization endpoints manage keys from code.

  2. Make your first request

    Send requests to https://weatherapi.foreca.net with the key in an Authorization: Bearer YOUR_KEY header, or as ?token=YOUR_KEY. Send them from your own server: in a web page or an app anyone can read the key, map tile URLs included (FAQ Q4).

    A location is longitude,latitude, longitude first, or an id from Location search. The example request works as pasted once your key is in it. Signed in, the Test Request panels on each feature page fill your key in.

  3. Adjust the response

    Query parameters change what comes back. Add ?tempunit=F&windunit=KMH&tz=Europe/London to the example request to get Fahrenheit, km/h and London time.

    The reference lists every parameter and the response schema of each endpoint, for example Current.

Step by step: the full quickstart, or the same in Python and JavaScript.

Next

Find a location/api/v1/location/search/{query}Hourly forecast/api/v1/forecast/hourly/{location}Daily forecast/api/v1/forecast/daily/{location}Map layers and tiles/api/v1/capabilities
GET /api/v1/current/{location} 
curl --header 'Authorization: Bearer YOUR_KEY' \
  'https://weatherapi.foreca.net/api/v1/current/24.9384,60.1699'
200 Response Helsinki · 2026-10-07T14:50+03:00
{
  "current": {
    "time": "2026-10-07T14:50+03:00",
    "symbol": "d000",
    "symbolPhrase": "clear",
    "temperature": 14,
    "feelsLikeTemp": 14,
    "relHumidity": 52,
    "dewPoint": 4,
    "windSpeed": 6,
    "windDir": 281,
    "windDirString": "W",
    "windGust": 10,
    "precipProb": 1,
    "precipRate": 0,
    "cloudiness": 4,
    "thunderProb": 0,
    "uvIndex": 1,
    "pressure": 1011.09,
    "visibility": 10547
  }
}

Plans & features

All paid plans include Point Forecasts, Air Quality, and Weather Maps, with more features unlocked at higher tiers. Historical Weather, Ski Resorts, Energy, Agriculture, and Lightning Flashes bounding box are available on request — contact sales. See the Foreca Weather API pricing page for the full plan and feature breakdown.

This site is the technical reference. For what the API is intended for, the data behind it and how it is licensed, see the Foreca Weather API product page.

Request limits

The number of included requests per month depends on your plan. Exceeding requests are billed separately. In addition, a queries-per-second limit applies, which is a hard limit that is defined by your plan. See the Pricing page for more details.

The free trial and Freemium plans each have a daily limit of 2,000 requests per day.

Only successful requests count towards the limit. For the Maps endpoints, each tile counts as one request.

You can monitor your API usage with the Usage endpoints, as well as through My API.

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.

Logo + trademark guidelines: business.foreca.com/logo.

Third Party Attributions

Customer's application must show third-party attribution as given in API response. For example, the Capabilities endpoint under Weather Maps 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, GeoSphere Austria
  • 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
  • Lightning data: EUMETSAT, National Oceanic and Atmospheric Administration (NOAA)

Support

Signed-in customers find the support address for their plan on the My API page. For anything else, use the contact form.