Surf Forecast API

High-resolution global wave forecasts with multiple models. Access wave height, period, direction, wind data, and secondary swell forecasts through a simple REST API.

Swellcloud Surf Forecast API - Professional Marine Weather API

The Swellcloud Surf Forecast API is a comprehensive marine weather API and surf forecasting API providing real-time wave forecast data, wind conditions, and secondary swell information. Our marine API delivers high-resolution global wave forecasts with support for multiple forecast models including GFS and CMEMS. Access wave height, period, direction, wind speed, wind direction, secondary swell, and wind wave data through our RESTful surf forecast API. Perfect for surf forecasting applications, marine weather services, and ocean data integration.

Location and Time

Performance Warning: Long date queries (e.g., 16 days) can take up to 2 minutes to process. We recommend you cache these results in a production environment.

Click map to position marker

Marine Weather Variables

Significant Wave Height
Significant mean wave height (hs)
Peak Wave Period
Peak period between waves (tp)
Wave Direction
Peak wave direction (dp)
Secondary Swell Height
Secondary swell wave height (ss_hs)
Secondary Swell Direction
Secondary swell direction (ss_dp)
Wind Wave Height
Significant height of wind waves (ww_hs)
Wind Wave Direction
Wind wave direction (ww_dp)
Wind Speed
Surface wind speed (wndspd)
Wind Direction
Surface wind direction (wnddir)

Model Selection

Swellcloud Default
Resolution: 0.25° (~28 km) • Updates: 4x daily • Range: 16 days
Full variable suite including wind and secondary swell
CMEMS Global Wave High-Res
Resolution: 1/12° (~9 km) • Updates: Daily • Range: 10 days
3x higher resolution with satellite data assimilation
⚠️ First request may take 10-30 seconds to download data

API Response

Request URL

Click "Run Query" to see API URL

JSON Response

// Click "Run Query" to see response...

Forecast Charts

Surf Forecast API Documentation

Endpoint

GET https://api.swellcloud.net/v1/point

Authentication

All API requests require an API key sent via the X-API-Key header.

Playground Test Key:

test_playground_key_12345

Limited to playground testing only

Production API Key:

For regular use, request your API key by emailing info@swellcloud.net

Parameters

Parameter Type Default Description
lat float required Latitude (-90 to 90)
lon float required Longitude (-180 to 180)
vars string hs,tp,dp,ss_hs,ss_dp,ww_hs,ww_dp Comma-separated: hs, tp, dp, ss_hs, ss_dp, ww_hs, ww_dp, wndspd, wnddir
model string gfs Wave model: gfs (Swellcloud) or cmems-global
units string si si (meters, m/s) or uk (feet, mph)
start ISO 8601 now Start time (UTC), e.g. 2025-10-13T00:00Z
end ISO 8601 now+24h End time (UTC)

Example cURL

Swellcloud Model (default):
curl -H "X-API-Key: YOUR_API_KEY" \ "https://api.swellcloud.net/v1/point?lat=50.087&lon=-5.318&model=gfs" | jq .
CMEMS High-Res Model:
curl -H "X-API-Key: YOUR_API_KEY" \ "https://api.swellcloud.net/v1/point?lat=50.087&lon=-5.318&model=cmems-global" | jq .

Variables

  • hs - Wave height (m or ft)
  • tp - Peak wave period (s)
  • dp - Wave direction (°)
  • ss_hs - Secondary swell height (m or ft)
  • ss_dp - Secondary swell direction (°)
  • ww_hs - Wind wave height (m or ft)
  • ww_dp - Wind wave direction (°)
  • wndspd - Wind speed (mph by default, m/s with units=si)
  • wnddir - Wind direction (°)

Available Models

Swellcloud (default)
0.25° (~28 km) • 16 days • 4x daily updates
CMEMS Global ⚡
1/12° (~9 km) • 10 days • Daily updates • High-Res