SearchCtrl+K

Marine Weather API Reference

Access real-time and forecast marine weather data for any location worldwide. Supports lookup by city name or address, GPS coordinates, or IP address. Each response includes ocean wave parameters, wind wave data, and swell information with daily, hourly, or minutely precision for up to 16 days ahead.

GEThttps://api.apifreaks.com/v1.0/weather/marine

Test

The Marine Weather API delivers wave height, wave direction, wave period, wind wave data, and swell wave data. By default the API returns current marine conditions. When a date range is specified via startDate and endDate the API switches to forecast mode. The maximum forecast range is 16 days. When no location parameter is provided the API auto-detects the requesting IP address.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/weather/marine?lat=51.50000&long=2.00000' \
  -H 'X-apiKey: API-KEY'

Response

{
  "location": {
    "latitude": "51.50000",
    "longitude": "2.00000",
    "country_name": "United Kingdom",
    "state_prov": "",
    "city": "",
    "locality": "",
    "elevation": "",
    "timezone": "Etc/GMT",
    "timezone_abbreviation": "GMT"
  },
  "forecast": {
    "2026-06-04": {
      "daily": {
        "timestamp": "2026-06-04",
        "wave_height_max": 2.04,
        "wave_direction_dominant": 220,
        "wave_period_max": 5.6,
        "wind_wave_height_max": 2.02,
        "wind_wave_direction_dominant": 222,
        "wind_wave_period_max": 5,
        "wind_wave_peak_period_max": 6.95,
        "swell_wave_height_max": 1.12,
        "swell_wave_direction_dominant": 206,
        "swell_wave_period_max": 7,
        "swell_wave_peak_period_max": 8.4
      }
    },
    "2026-06-05": {
      "daily": {
        "timestamp": "2026-06-05",
        "wave_height_max": 1.34,
        "wave_direction_dominant": 231,
        "wave_period_max": 4.8,
        "wind_wave_height_max": 1.22,
        "wind_wave_direction_dominant": 232,
        "wind_wave_period_max": 4,
        "wind_wave_peak_period_max": 4.75,
        "swell_wave_height_max": 0.56,
        "swell_wave_direction_dominant": 229,
        "swell_wave_period_max": 7,
        "swell_wave_peak_period_max": 7.65
      }
    },
    "2026-06-06": {
      "daily": {
        "timestamp": "2026-06-06",
        "wave_height_max": 2.18,
        "wave_direction_dominant": 196,
        "wave_period_max": 5.9,
        "wind_wave_height_max": 2.1,
        "wind_wave_direction_dominant": 194,
        "wind_wave_period_max": 5.3,
        "wind_wave_peak_period_max": 6.95,
        "swell_wave_height_max": 0.48,
        "swell_wave_direction_dominant": 202,
        "swell_wave_period_max": 5.65,
        "swell_wave_peak_period_max": 8.4
      }
    }
  }
}

API Request

Query Parameters

All parameters are optional query string parameters. Pass location, lat/long, or ipto specify a target. If none are provided the API resolves marine data for the calling machine's IP address. Use startDate and endDate to switch to forecast mode. Use precision to control forecast granularity.

formatoptionalStringdefault: json

Response format: 'json'.

startDateoptionalString

Starting date for which to fetch marine forecast data. Must follow YYYY-MM-DD format (e.g., 2025-08-25). Forecast dates must be current or future dates only. Past dates are not allowed for forecast data.

endDateoptionalString

End date for which to fetch marine forecast data. Must follow YYYY-MM-DD format (e.g., 2025-08-25). Forecast dates must be current or future dates only. Past dates are not allowed for forecast data.

locationoptionalString

Specifies the target location. It can be a city name, place name, or a complete address (e.g., "Lahore", "Paris, France", "1600 Amphitheatre Parkway, Mountain View, CA").

latoptionalFloat

Latitude of the target location. Must be used together with "long".

longoptionalFloat

Longitude of the target location. Must be used together with "lat".

ipoptionalString

IPv4 or IPv6 address used to infer location. Defaults to the requester's public IP if not provided.

precisionoptionalStringdefault: daily

Set the data precision: "daily" for daily, "hourly" for hourly, and "minutely" for minute-level data. Defaults to "daily".

timezoneoptionalString

Specifies the timezone for returned results. Defaults to the resolved location's timezone.

API Response Schema

A successful request returns a 200 OK response with a JSON object. The top-level object always contains location. When a date range is provided the response also contains a forecast object keyed by date. See the response preview on the right for the full JSON structure.

date (Object)

Address Lookup (Object), Coordinates Lookup (Object), IP Lookup (Object)

timestamp (String), wave_height (Float), wave_direction (Float), wave_period (Float), wind_wave_height (Float), …

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Invalid latitude or longitude values. Latitude must be between -90 and 90, and longitude must be between -180 and 180

404

Location not found

Marine Weather API Reference

GEThttps://api.apifreaks.com/v1.0/weather/marine

Test

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/weather/marine?lat=51.50000&long=2.00000' \
  -H 'X-apiKey: API-KEY'

Response

{
  "location": {
    "latitude": "51.50000",
    "longitude": "2.00000",
    "country_name": "United Kingdom",
    "state_prov": "",
    "city": "",
    "locality": "",
    "elevation": "",
    "timezone": "Etc/GMT",
    "timezone_abbreviation": "GMT"
  },
  "forecast": {
    "2026-06-04": {
      "daily": {
        "timestamp": "2026-06-04",
        "wave_height_max": 2.04,
        "wave_direction_dominant": 220,
        "wave_period_max": 5.6,
        "wind_wave_height_max": 2.02,
        "wind_wave_direction_dominant": 222,
        "wind_wave_period_max": 5,
        "wind_wave_peak_period_max": 6.95,
        "swell_wave_height_max": 1.12,
        "swell_wave_direction_dominant": 206,
        "swell_wave_period_max": 7,
        "swell_wave_peak_period_max": 8.4
      }
    },
    "2026-06-05": {
      "daily": {
        "timestamp": "2026-06-05",
        "wave_height_max": 1.34,
        "wave_direction_dominant": 231,
        "wave_period_max": 4.8,
        "wind_wave_height_max": 1.22,
        "wind_wave_direction_dominant": 232,
        "wind_wave_period_max": 4,
        "wind_wave_peak_period_max": 4.75,
        "swell_wave_height_max": 0.56,
        "swell_wave_direction_dominant": 229,
        "swell_wave_period_max": 7,
        "swell_wave_peak_period_max": 7.65
      }
    },
    "2026-06-06": {
      "daily": {
        "timestamp": "2026-06-06",
        "wave_height_max": 2.18,
        "wave_direction_dominant": 196,
        "wave_period_max": 5.9,
        "wind_wave_height_max": 2.1,
        "wind_wave_direction_dominant": 194,
        "wind_wave_period_max": 5.3,
        "wind_wave_peak_period_max": 6.95,
        "swell_wave_height_max": 0.48,
        "swell_wave_direction_dominant": 202,
        "swell_wave_period_max": 5.65,
        "swell_wave_peak_period_max": 8.4
      }
    }
  }
}

API Request

Query Parameters

formatoptionalStringdefault: json

Response format: 'json'.

startDateoptionalString

endDateoptionalString

End date for which to fetch marine forecast data. Must follow YYYY-MM-DD format (e.g., 2025-08-25). Forecast dates must be current or future dates only. Past dates are not allowed for forecast data.

locationoptionalString

Specifies the target location. It can be a city name, place name, or a complete address (e.g., "Lahore", "Paris, France", "1600 Amphitheatre Parkway, Mountain View, CA").

latoptionalFloat

Latitude of the target location. Must be used together with "long".

longoptionalFloat

Longitude of the target location. Must be used together with "lat".

ipoptionalString

IPv4 or IPv6 address used to infer location. Defaults to the requester's public IP if not provided.

precisionoptionalStringdefault: daily

Set the data precision: "daily" for daily, "hourly" for hourly, and "minutely" for minute-level data. Defaults to "daily".

timezoneoptionalString

Specifies the timezone for returned results. Defaults to the resolved location's timezone.

API Response Schema

date (Object)

Address Lookup (Object), Coordinates Lookup (Object), IP Lookup (Object)

timestamp (String), wave_height (Float), wave_direction (Float), wave_period (Float), wind_wave_height (Float), …

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Invalid latitude or longitude values. Latitude must be between -90 and 90, and longitude must be between -180 and 180

404

Location not found

Quick Links

Quick Links

Marine Weather API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts

Quick Links

Quick Links

Marine Weather API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts