SeaLegs Developer API
Build AI-powered marine forecasts into your applications.
Introduction
The SeaLegs Developer API provides access to professional-grade marine weather forecasting powered by AI. Use our API to integrate accurate marine forecasts into your boating, sailing, or fishing applications.
Base URL
All API requests should be made to:
https://api.sealegs.ai/v3Key Features
SpotCast Forecasts
Get detailed AI-powered N-day weather forecasts for any marine location.
Accuracy
We analyze data from multiple weather models and look at trends with a proprietary algorithm to create trusted, accurate forecasts.
Localization
Support for 6 languages with more coming soon.
Global Coverage
Weather forecasts for any coordinates worldwide, from coastal waters to open ocean.
Quick Example
Here's a simple example to get you started:
# Create a SpotCast forecast
curl -X POST https://api.sealegs.ai/v3/spotcast \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"latitude": 25.7617,
"longitude": -80.1918,
"start_date": "2025-12-05T00:00:00Z",
"num_days": 2
}'import requests
API_KEY = "sk_live_your_api_key"
BASE_URL = "https://api.sealegs.ai/v3"
# Create a SpotCast forecast
response = requests.post(
f"{BASE_URL}/spotcast",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
},
json={
"latitude": 25.7617,
"longitude": -80.1918,
"start_date": "2025-12-05T00:00:00Z",
"num_days": 2
}
)
data = response.json()
print(f"SpotCast ID: {data['id']}")
print(f"Status: {data['status']}")const API_KEY = 'sk_live_your_api_key';
const BASE_URL = 'https://api.sealegs.ai/v3';
// Create a SpotCast forecast
const response = await fetch(`${BASE_URL}/spotcast`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
latitude: 25.7617,
longitude: -80.1918,
start_date: '2025-12-05T00:00:00Z',
num_days: 2
})
});
const data = await response.json();
console.log(`SpotCast ID: ${data.id}`);
console.log(`Status: ${data.status}`);The API will return a response like this:
{
"id": "spc_abc123xyz",
"status": "processing",
"created_at": "2025-12-01T10:30:00Z",
"estimated_completion_seconds": 45,
"links": {
"self": "https://api.sealegs.ai/v3/spotcast/spc_abc123xyz",
"status": "https://api.sealegs.ai/v3/spotcast/spc_abc123xyz/status"
}
}