Point Forecast API
Accurate weather data. Anywhere on Earth.
Connect your applications to powerful weather insights.
Point Forecast API enables you to quickly and easily integrate accurate point or route weather forecasts with your applications. The API quickly returns the highest resolution result from the available datasets for any coordinate on Earth.
Key Features
Forecast data for any point on the planet
Up to 10 days forecast horizon
Five days of historical forecasts
Forecasts for individual sites or routes
Forecast data from multiple models
Available Data
Air temperature
Atmospheric pressure
Currents
Convective potential energy
Cloud base height
Cloud cover
Precipitation
Relative humidity
Solar radiation
Sea surface temperature
Visibility
Wind speed, gust and direction
Waves
By removing the complexity of managing large weather datasets,
we leave you free to focus on building beautiful interactive applications
with robust weather-based functionality.
The Point Forecast API provides both atmospheric and oceanographic forecasts, with recent historical forecasts, to serve a wide variety of purposes. Available datasets include best-of-class global forecast models and local high-resolution models run in-house by our expert scientists. Our data sets are customer driven. We work closely with our customers to ensure models meet their needs.
Operational models we cover
Plans and pricing
Starter
Free
50,000 API units
for personal use only
Horizon
Up to 10-day forecast
5 days historical forecast
Models/Domains
Global Forecast System (GFS)
ECMWF global
ECMWF long-range
WW3 global
Support
Unavailable
Payment option
Credit card
Basic
$30 / month
100,000 API units
$0.04 per 100 additional units
Horizon
Up to 10-day forecast
5 days historical forecast
Models/Domains
Everything in our Starter Plan and…
Global currents (Mercarter)
ROMS (New Zealand)
SWAN open ocean & national domains
Support
Email support
Payment option
Credit card
Plus
$75/month
250,000 API units
$0.03 per 100 additional units
Horizon
Up to 10-day forecast
5 days historical forecast
Models/Domains
Everything in our Basic Plan and…
SWAN regional domains
MetService NZ 8km WRF models
Support
Email support
Payment option
Credit card
Pro
$500/month
1,500,000 API units
$0.02 per 100 additional units
Horizon
Up to 10-day forecast
5 days historical forecast
Models/Domains
Everything in our Plus Plan and…
MetService NZ 4km WRF models
MetraWeather GBR & Adelaide 4km WRF models
ROMS national domain
SWAN high resolution local domains
Support
Email support
Business hours phone support (NZT)
5-day issue resolution target
Payment option
Credit card
Enterprise
POA
High call volumes and custom domains.
Horizon
Up to 10-day forecast
5 days historical forecast
Models/Domains
Everything in our Pro Plan and…
High-resolution MetService regional NZ WRF models
Custom models and domains configured to your requirements
Support
Email support
Business hours phone support (NZT)
After hours support via service desk
2-day issue resolution target
Payment option
Credit card
Invoice
Frequently asked questions
-
An Application Programming Interface (API) is a way for applications to exchange data and functionality easily and securely
-
This is the unique value, in the form of letters and numbers, that identifies you and therefore, the data you can access. Your API key is issued when you sign up for the service.
-
This is the measure by which you are charged for the API service. It is made up of requests x variables x points.
variable: wave.height x point = 1 API Units
variables: (air.temperature.at-2m, cloud.cover) x point = 2 API Units
variables: (wave.height, air.temperature.at-2m, cloud.cover) x 2 points = 6 API Units
You receive a base number of API units based on your subscription plan, after these base units have been used you are then charged for each additional API Unit (in lots of 100) up to the absolute limit you set in the "USAGE & KEYS" section of your account, found in the console.
-
This is most often in marine applications and may have several causes. Further details here.
It may be due to the “masking” of the land. This is used to prevent the return of marine data such as waves from points on land. Because the coast is not a straight line, there are sometimes places where the mask covers the ocean, and so does not return data.
The variable may not be available if a value is null.
-
Payment by invoice is currently available for our Enterprise Plan. If your monthly API call exceeds the Pro level, please contact us to discuss further.
-
Under an Enterprise plan, we can provide high resolution domains, depending on the variables needed. This will require a set-up fee and on-going support for the model. Contact us to discuss.
-
Yes, you can upgrade your subscription at any time. Your currently subscription will be cancelled, and you will be charged the full price for the new plan, not considering the remaining time in your billing cycle. Your billing cycle and renewal date will change.
-
Payment in different currencies is negotiable for Enterprise customers with payments made by invoice.
-
Please check the number of API calls consumed in the "USAGE & KEYS" section in your account, which can be found in the console. If you have reached your limit, you can manually extend the cap by changing the set custom limit.
-
No, you will be charged only for the amount used. The cap will prevent accidental excessive charges (maximum to be used/charged will be the limit set).
-
The full description of which variables is available here, but see below some key parameters and their correlated API variables.
Significant wave height: wave.height
Swell height: wave.height.above-8s
Swell direction: wave.direction.above-8s.peak
Maximum wave height: wave.height.max
Wind direction at 10m: wind.direction.at-10m
Wind speed at 10m: wind.speed.at-10m -
See examples in Python at https://github.com/metoceanapi/forecast-api-docs/tree/main/examples-py
-
Check the API documentation for further information on how to get started with the Forecast API.
-
Our demo interface allows you to visualise the Forecast API capability.
-
Every month you will be charged the price of the API plan selected plus any extra units used on the previous month.
-
You can update your credit card information in the console, “Manage Users” tab.