CTRL+K

Marine Weather API

GET

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

format

Format of the Response

startDatestring

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.

endDatestring

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.

locationstring

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").

latfloat

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

longfloat

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

ipstring

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

precisionstring

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

timezonestring

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

Sample Responses

400

LANGUAGE

Python

PHP

Java

Node

Ruby


$ pip install requests

RESPONSE

Click Test it to start the request and see the response here!

API Response

Field	Type	Requirement	Description
location	Object	Mandatory	Location object. Can be with coordinates, IP, or location string depending on input.
current	Object	Optional	current marine weather data of the provided location or requester IP.
forecast[date].daily	Object	Optional	An object containing daily marine weather metrics for each forecast date.
forecast[date].hourly[]	Array	Optional	An Array of objects containing hourly marine weather data for the specified date range.
forecast[date].minutely[]	Array	Optional	An Array of objects containing minute-level marine weather data for the specified date range.

"location" (when coordinates Provided) object contains the following fields.

Field	Type	Requirement	Description
latitude	float	Mandatory	Geographic latitude coordinate in decimal degrees, ranging from -90 (South Pole) to +90 (North Pole).
longitude	float	Mandatory	Geographic longitude coordinate in decimal degrees, ranging from -180 (West) to +180 (East).
country_name	string	Mandatory	Full name of the country corresponding to the provided coordinates.
state_prov	string	Mandatory	State, province, or primary administrative division name for the location.
city	string	Mandatory	City or municipal area name associated with the coordinate location.
locality	string	Optional	Specific locality, neighborhood, district, or village name within the broader area.
elevation	float	Optional	Height above mean sea level in meters for the specified coordinates.
timezone	string	Mandatory	IANA timezone database identifier for the location (e.g., America/New_York, Europe/London).
timezone_abbreviation	string	Mandatory	Abbreviated timezone representation based on current offset (e.g., EST, GMT, PST).

"location" (when IP Provided) object contains the following fields.

Field	Type	Requirement	Description
continent_code	string	Mandatory	Two-letter continent code (e.g., NA for North America, EU for Europe, AS for Asia).
continent_name	string	Mandatory	Full name of the continent where the IP address is registered.
country_code2	string	Mandatory	ISO 3166-1 alpha-2 two-letter country code (e.g., US, GB, FR).
country_code3	string	Mandatory	ISO 3166-1 alpha-3 three-letter country code (e.g., USA, GBR, FRA).
country_name	string	Mandatory	Common name of the country associated with the IP address.
country_name_official	string	Mandatory	Official long-form country name as recognized internationally (e.g., United States of America).
is_eu	boolean	Optional	Boolean flag indicating whether the country is a member state of the European Union.
state_prov	string	Mandatory	State, province, or primary administrative division associated with the IP location.
state_code	string	Optional	ISO 3166-2 subdivision code for the state or province (e.g., CA for California).
district	string	Optional	District, county, or secondary administrative division within the region.
city	string	Mandatory	City or urban area name where the IP address is geographically registered.
zipcode	string	Optional	Postal code or ZIP code for the approximate location of the IP address.
latitude	float	Mandatory	Geographic latitude in decimal degrees for the IP geolocation, ranging from -90 to +90.
longitude	float	Mandatory	Geographic longitude in decimal degrees for the IP geolocation, ranging from -180 to +180.
locality	string	Optional	Specific locality, neighborhood, or small area designation within the city.
elevation	float	Optional	Elevation above mean sea level in meters for the IP geolocation.
timezone	string	Mandatory	IANA timezone database identifier for the IP location (e.g., America/Chicago, Asia/Tokyo).
timezone_abbreviation	string	Mandatory	Current timezone abbreviation based on local offset (e.g., CST, JST, UTC).

"location" (when location Provided) object contains the following fields.

Field	Type	Requirement	Description
location_string	string	Mandatory	Original location query string as submitted, including full address or place name.
country_name	string	Mandatory	Resolved country name derived from the geocoded location query.
state_prov	string	Mandatory	State, province, or primary administrative division identified from the location.
city	string	Mandatory	City or municipal area name extracted from the geocoded location.
locality	string	Optional	Specific locality, neighborhood, suburb, or village within the geocoded area.
latitude	float	Mandatory	Geocoded latitude coordinate in decimal degrees, ranging from -90 to +90.
longitude	float	Mandatory	Geocoded longitude coordinate in decimal degrees, ranging from -180 to +180.
elevation	float	Optional	Elevation above mean sea level in meters at the geocoded coordinates.
timezone	string	Mandatory	IANA timezone database identifier for the geocoded location (e.g., America/Los_Angeles).
timezone_abbreviation	string	Mandatory	Current timezone abbreviation for the location based on local offset (e.g., PDT, CET).

"current" object contains the following fields.

Field	Type	Requirement	Description
timestamp	String	Mandatory	ISO 8601 formatted timestamp.
wave_height	Number	Mandatory	Significant mean wave height measured in meters (m), representing the average height of the highest one-third of all waves in the combined sea state.
wave_direction	Number	Mandatory	Mean wave direction in degrees (°), indicating where the combined waves are originating from. 0° represents waves coming from the north moving southward, while 90° indicates waves from the east.
wave_period	Number	Mandatory	Time interval in seconds (s) between successive waves in the combined sea state, measuring the duration from one wave crest to the next.
wind_wave_height	Number	Mandatory	Height of wind-generated waves measured in meters (m), representing waves created by local wind conditions rather than distant weather systems.
wind_wave_direction	Number	Mandatory	Directional bearing in degrees (°) showing where wind waves are coming from. 0° indicates northward origin, 90° indicates eastward origin.
wind_wave_period	Number	Mandatory	Duration in seconds (s) between consecutive wind wave crests, indicating the time interval for locally-generated wave patterns.
swell_wave_height	Number	Mandatory	Swell wave height measured in meters (m), representing waves that have traveled from distant storm systems and are no longer influenced by local winds.
swell_wave_direction	Number	Mandatory	Direction in degrees (°) from which swell waves are approaching. Wave directions follow the convention where 0° means from the north, 90° means from the east.
swell_wave_period	Number	Mandatory	Time span in seconds (s) between successive swell wave peaks, measuring the rhythmic interval of long-distance traveling waves.
sea_level_height_msl	Number	Mandatory	Sea surface elevation in meters (m) relative to global mean sea level, accounting for tidal variations, atmospheric pressure effects, and other oceanographic factors.
sea_surface_temperature	Number	Mandatory	Water temperature in degrees Celsius (°C) measured at the ocean surface layer, typically within the top few meters of the water column.
ocean_current_velocity	Number	Mandatory	Ocean current speed in kilometers per hour (km/h), representing the combined flow velocity from Eulerian currents, wave-induced motion, and tidal movements.
ocean_current_direction	Number	Mandatory	Direction in degrees (°) indicating where the ocean current is flowing toward. 0° signifies northward movement, while 90° represents eastward flow.

The "forecast[date].daily" objects having the following fields.

Field	Type	Requirement	Description
timestamp	string	Mandatory	ISO 8601 formatted timestamp.
wave_height_max	float	Mandatory	Highest recorded significant mean wave height throughout the day, measured in meters (m), representing the peak wave conditions during the 24-hour period.
wave_direction_dominant	integer	Mandatory	Most frequently occurring wave direction for mean waves during the day, expressed in degrees (°) from north.
wave_period_max	float	Mandatory	Longest time interval in seconds (s) between consecutive mean wave crests recorded throughout the day.
wind_wave_height_max	float	Mandatory	Peak height of wind-generated waves measured in meters (m) within the 24-hour period, representing the maximum locally-driven wave conditions.
wind_wave_direction_dominant	integer	Mandatory	Prevailing directional bearing in degrees (°) for wind waves throughout the day, indicating the most common source direction.
wind_wave_period_max	float	Mandatory	Longest duration in seconds (s) between wind wave crests observed during the daily period.
wind_wave_peak_period_max	float	Mandatory	Maximum peak period in seconds (s) for wind waves during the day, representing the interval of the most energetic wind-driven wave component.
swell_wave_height_max	float	Mandatory	Highest swell wave elevation in meters (m) recorded throughout the day for waves originating from distant weather systems.
swell_wave_direction_dominant	integer	Mandatory	Primary direction in degrees (°) from which swell waves approached during the day, representing the most common swell orientation.
swell_wave_period_max	float	Mandatory	Longest time interval in seconds (s) between swell wave peaks recorded during the 24-hour period.
swell_wave_peak_period_max	float	Mandatory	Maximum peak period in seconds (s) for swell waves throughout the day, indicating the interval of the most powerful swell component.

"forecast[date].hourly[]" An Array of objects having the following fields.

Field	Type	Requirement	Description
timestamp	string	Mandatory	ISO 8601 formatted timestamp.
wave_height	float	Mandatory	Significant mean wave height in meters (m) for the specified hour, representing the average of the highest one-third of all waves.
wave_direction	integer	Mandatory	Directional bearing in degrees (°) showing the origin of mean waves at this hour. 0° indicates north, 90° indicates east.
wave_period	float	Mandatory	Time duration in seconds (s) between successive mean wave crests for the given hour.
wind_wave_height	float	Mandatory	Height of locally-generated wind waves in meters (m) at this specific hour, created by current wind conditions.
wind_wave_peak_period	float	Mandatory	Peak period in seconds (s) representing the interval of the most energetic wind wave component at the given hour.
wind_wave_direction	integer	Mandatory	Direction in degrees (°) from which wind waves are originating during this hour. 0° represents northward, 90° represents eastward origin.
wind_wave_period	float	Mandatory	Time interval in seconds (s) between consecutive wind wave peaks at the specified hour.
swell_wave_height	float	Mandatory	Swell wave elevation in meters (m) for the given hour, representing waves that have propagated from remote storm systems.
swell_wave_direction	integer	Mandatory	Source direction in degrees (°) of swell waves at this hour, where 0° indicates northern origin and 90° indicates eastern origin.
swell_wave_period	float	Mandatory	Duration in seconds (s) between swell wave crests recorded at the specified hour.
swell_wave_peak_period	float	Mandatory	Peak period in seconds (s) of the most dominant swell wave component present during the given hour.
sea_surface_temperature	float	Mandatory	Ocean surface water temperature in degrees Celsius (°C) at the near-surface layer for the specified hour.
sea_level_height_msl	float	Mandatory	Sea level elevation in meters (m) above mean sea level at the given hour, incorporating tidal effects and atmospheric influences. Limited accuracy near coastlines.
ocean_current_velocity	float	Mandatory	Current flow speed in kilometers per hour (km/h) at this hour, combining tidal, wave-induced, and general circulation components.
ocean_current_direction	integer	Mandatory	Flow direction in degrees (°) showing where the ocean current is heading at the specified hour. 0° means northward, 90° means eastward movement.

"forecast[date].minutely[]" An Array of objects having the following fields.

Field	Type	Requirement	Description
timestamp	string	Mandatory	ISO 8601 formatted timestamp.
ocean_current_velocity	float	Mandatory	Current flow velocity in kilometers per hour (km/h) at the specified minute, accounting for Eulerian flow, wave effects, and tidal movements.
ocean_current_direction	integer	Mandatory	Direction in degrees (°) indicating the flow path of the ocean current at this minute. 0° signifies northward flow, 90° signifies eastward flow.
sea_level_height_msl	float	Mandatory	Sea surface height in meters (m) relative to global mean sea level for the given minute, reflecting tidal variations and barometric pressure effects. Reliability decreases in coastal zones.