The Marinas.com API supports both authenticated and unauthenticated requests. Requests are authenticated requests with an API Key, which is put into the access_token
query parameter of any request. Or as an Authorization header Authorization: Bearer access_token
Get yours at the developers homepage.
curl -XGET https://api.marinas.com/v1/points/4qcq
The Marinas.com API returns preformed links on point of interest data to help assist you in database traversal and Attribution requirements. The web_url
, api_url
, and icon_url
properties will always return a working link for you to embed in your application.
{
"id": "4qcq",
"resource": "point",
"name": "Atlantis Marina, Inc.",
"kind": "marina",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.223719,
"lon": -76.460863,
"what3words": "thread.bystanders.tuned"
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/3ee8e150dc5e396ad9aad131f06ed780c9e7c74aa180131a84bbdd65ddcc1c82.jpg",
"small_url": "https://img.marinas.com/v2/da6087ec30ec72fb2e74f2f43f7a126ce929b09d7d4f646c181edb2b8636cedf.jpg",
"medium_url": "https://img.marinas.com/v2/79c874e063923be4c8288922dd8bf869bc9a47197df695c9e42e0cbb1e8aba93.jpg",
"banner_url": "https://img.marinas.com/v2/ee52722ffd68dc76a5b60b60d0c2de621abfe8e1975ac4c7b880ebb5859b126a.jpg",
"full_url": "https://img.marinas.com/v2/ba7e4d53efb0a248a520e22c3d62f2efacbadc112a9cbcea2cb69cf787ff2143.jpg"
}
],
"total_count": 4
},
"web_url": "https://marinas.com/view/marina/4qcq_Atlantis_Marina_Inc_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/4qcq",
"icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"fuel": {
"has_diesel": false,
"has_propane": false,
"has_gas": false,
"propane_price": null,
"diesel_price": null,
"gas_regular_price": null,
"gas_super_price": null,
"gas_premium_price": null
},
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
"regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
}
}
Searches through all points of interest, returning a Geolist of Points objects.
Points can be any kind from marina
, harbor
, anchorage
, inlet
, bridge
, lock
, lighthouse
, ferry
, landmark
, ramp
.
Points are essentially polymorphic wrappers around the individual point of interest data types. For example, a Marina object has more properties than a Point. To access those, you can either use the Marina search API or retrieve the associated object from the api_url
property.
marina
, anchorage
, harbor
, inlet
, bridge
, lock
, lighthouse
, ferry
, landmark
, ramp
.curl -XGET -G https://api.marinas.com/v1/points/search \
-d 'location[lat]=39.223719' \
-d 'location[lon]=-76.460863'
{
"resource": "geolist",
"data": [
{
"id": "4qcq",
"resource": "point",
"name": "Atlantis Marina, Inc.",
"kind": "marina",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.223719,
"lon": -76.460863,
"what3words": "thread.bystanders.tuned"
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/3ee8e150dc5e396ad9aad131f06ed780c9e7c74aa180131a84bbdd65ddcc1c82.jpg",
"small_url": "https://img.marinas.com/v2/da6087ec30ec72fb2e74f2f43f7a126ce929b09d7d4f646c181edb2b8636cedf.jpg",
"medium_url": "https://img.marinas.com/v2/79c874e063923be4c8288922dd8bf869bc9a47197df695c9e42e0cbb1e8aba93.jpg",
"banner_url": "https://img.marinas.com/v2/ee52722ffd68dc76a5b60b60d0c2de621abfe8e1975ac4c7b880ebb5859b126a.jpg",
"full_url": "https://img.marinas.com/v2/ba7e4d53efb0a248a520e22c3d62f2efacbadc112a9cbcea2cb69cf787ff2143.jpg"
}
],
"total_count": 4
},
"web_url": "https://marinas.com/view/marina/4qcq_Atlantis_Marina_Inc_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/4qcq",
"icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"fuel": {
"has_diesel": false,
"has_propane": false,
"has_gas": false,
"propane_price": null,
"diesel_price": null,
"gas_regular_price": null,
"gas_super_price": null,
"gas_premium_price": null
},
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
"regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
}
}
],
"bounds": {
"ne": {
"lat": 39.223719,
"lon": -76.460863
},
"sw": {
"lat": 39.223719,
"lon": -76.460863
}
},
"total_count": 895
}
Returns the requested point
curl -XGET https://api.marinas.com/v1/points/4qcq
{
"id": "4qcq",
"resource": "point",
"name": "Atlantis Marina, Inc.",
"kind": "marina",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.223719,
"lon": -76.460863,
"what3words": "thread.bystanders.tuned"
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/3ee8e150dc5e396ad9aad131f06ed780c9e7c74aa180131a84bbdd65ddcc1c82.jpg",
"small_url": "https://img.marinas.com/v2/da6087ec30ec72fb2e74f2f43f7a126ce929b09d7d4f646c181edb2b8636cedf.jpg",
"medium_url": "https://img.marinas.com/v2/79c874e063923be4c8288922dd8bf869bc9a47197df695c9e42e0cbb1e8aba93.jpg",
"banner_url": "https://img.marinas.com/v2/ee52722ffd68dc76a5b60b60d0c2de621abfe8e1975ac4c7b880ebb5859b126a.jpg",
"full_url": "https://img.marinas.com/v2/ba7e4d53efb0a248a520e22c3d62f2efacbadc112a9cbcea2cb69cf787ff2143.jpg"
}
],
"total_count": 4
},
"web_url": "https://marinas.com/view/marina/4qcq_Atlantis_Marina_Inc_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/4qcq",
"icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"fuel": {
"has_diesel": false,
"has_propane": false,
"has_gas": false,
"propane_price": null,
"diesel_price": null,
"gas_regular_price": null,
"gas_super_price": null,
"gas_premium_price": null
},
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
"regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
}
}
Searches through all Marina objects, returning a Geolist of Marinas
true
, false
.true
, false
.true
, false
.curl -XGET -G https://api.marinas.com/v1/marinas/search \
-d 'location[lat]=39.283166666638884' \
-d 'location[lon]=-76.3955'
{
"resource": "geolist",
"data": [
{
"id": "eycq",
"resource": "marina",
"name": "All Star Marine",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.283166666638884,
"lon": -76.3955,
"what3words": "lawn.dunked.flies"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/marina/eycq_All_Star_Marine_Middle_River_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/eycq",
"icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
"regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
},
"fuel": {
"has_diesel": false,
"has_propane": false,
"has_gas": false,
"propane_price": null,
"diesel_price": null,
"gas_regular_price": null,
"gas_super_price": null,
"gas_premium_price": null
}
}
],
"bounds": {
"ne": {
"lat": 39.283166666638884,
"lon": -76.3955
},
"sw": {
"lat": 39.283166666638884,
"lon": -76.3955
}
},
"total_count": 511
}
Returns the requested marina
curl -XGET https://api.marinas.com/v1/marinas/eycq
{
"id": "eycq",
"resource": "marina",
"name": "All Star Marine",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.283166666638884,
"lon": -76.3955,
"what3words": "lawn.dunked.flies"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/marina/eycq_All_Star_Marine_Middle_River_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/eycq",
"icon_url": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_marina-5010a82e1bce7bf8a225fe4d19cf9befa9acea1997dd43fcb46703722810b3a3.svg",
"regular": "https://marinas.com/assets/map/marker_marina-61b3ca5ea8e7fab4eef2d25df94457f060498ca1a72e3981715f46d2ab347db4.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-813d72233e076185a2c77761f802728ced60cc0e72044871c1c15f0b9c0bcf58.svg"
},
"fuel": {
"has_diesel": false,
"has_propane": false,
"has_gas": false,
"propane_price": null,
"diesel_price": null,
"gas_regular_price": null,
"gas_super_price": null,
"gas_premium_price": null
}
}
Returns the requested harbor
curl -XGET https://api.marinas.com/v1/harbors/n5tj
{
"id": "n5tj",
"resource": "harbor",
"name": "Bar Harbor",
"rating": null,
"review_count": 0,
"location": {
"lat": 44.3988991,
"lon": -68.200798,
"what3words": "crab.soils.credential"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/harbor/n5tj_Bar_Harbor_Bar_Harbor_ME_United_States",
"api_url": "https://api.marinas.com/v1/harbors/n5tj",
"icon_url": "https://marinas.com/assets/map/marker_harbor-b6a4ad67eebea11fa25cccfcb58b1515b588c226eb29350fceeb52da0144b75d.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_harbor-c8ba8a95ffca2767350ee39f59707f82a3b913f6ac502a01efab799fe68ecc95.svg",
"regular": "https://marinas.com/assets/map/marker_harbor-b6a4ad67eebea11fa25cccfcb58b1515b588c226eb29350fceeb52da0144b75d.svg",
"dark": "https://marinas.com/assets/map/dark/marker_harbor-4bf72282329ba3f7f436d240ec6278ecd91f9dfe525b4acbdbe3005211a49c20.svg"
}
}
Returns the requested anchorage
curl -XGET https://api.marinas.com/v1/anchorages/zgfl
{
"id": "zgfl",
"resource": "anchorage",
"name": "Matinicus Island Moorings",
"rating": null,
"review_count": 0,
"location": {
"lat": 43.8652992,
"lon": -68.8824997,
"what3words": "rooks.deductions.another"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/anchorage/zgfl_Matinicus_Island_Moorings_Anchorage_Matinicus_Island_ME_United_States",
"api_url": "https://api.marinas.com/v1/anchorages/zgfl",
"icon_url": "https://marinas.com/assets/map/marker_anchorage-2f24ab8edcca606182cf75e5c4941fbcb058cd442052ac1283445b75333a0dbc.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_anchorage-38e61b655945d59090fd4cf6a508a6a8e7463b29bcdfda53e870048289f28a89.svg",
"regular": "https://marinas.com/assets/map/marker_anchorage-2f24ab8edcca606182cf75e5c4941fbcb058cd442052ac1283445b75333a0dbc.svg",
"dark": "https://marinas.com/assets/map/dark/marker_anchorage-ef89d62febdb605982bf5464c2a9235eaa48ca22bf0ce960cecad98719e10c8a.svg"
}
}
Returns the requested inlet
curl -XGET https://api.marinas.com/v1/inlets/7gim
{
"id": "7gim",
"resource": "inlet",
"name": "Beach Creek North Inlet",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.0250015,
"lon": -74.7966995,
"what3words": "boggles.motivations.notable"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/inlet/7gim_Beach_Creek_North_Inlet_Wildwood_NJ_United_States",
"api_url": "https://api.marinas.com/v1/inlets/7gim",
"icon_url": "https://marinas.com/assets/map/marker_inlet-d52f22ecf736a694c6d25afd910be07557cc743c23d6ff101f08c7d7819af587.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_inlet-0f2efbe7e8e4487d4f0586a68170fbcb4fc234a393c33793a415efb96004a5e0.svg",
"regular": "https://marinas.com/assets/map/marker_inlet-d52f22ecf736a694c6d25afd910be07557cc743c23d6ff101f08c7d7819af587.svg",
"dark": "https://marinas.com/assets/map/dark/marker_inlet-6c9bbeb093269f605158c0725b0ea8e82a5df3de3d1b382c25ccd6a92e893d24.svg"
}
}
Returns the requested bridge
curl -XGET https://api.marinas.com/v1/bridges/mguw
{
"id": "mguw",
"resource": "bridge",
"name": "Ocean Drive Bascule Bridge",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.1288986,
"lon": -74.7110977,
"what3words": "treatable.smarting.crocodiles"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/bridge/mguw_Ocean_Drive_Bascule_Bridge_NJ_United_States",
"api_url": "https://api.marinas.com/v1/bridges/mguw",
"icon_url": "https://marinas.com/assets/map/marker_bridge-1a891cdf787180475bf780707eb754ede507781f5d123f3d51412deda2726631.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_bridge-f85a984cc9b0b1a35a6dc0359c12c9e3b7f4ec8f7102fd0b7d9e3f87f98f2706.svg",
"regular": "https://marinas.com/assets/map/marker_bridge-1a891cdf787180475bf780707eb754ede507781f5d123f3d51412deda2726631.svg",
"dark": "https://marinas.com/assets/map/dark/marker_bridge-a74ad91c41d9ed84bfe6f84d4f970356230c4cc818972f9c9f3ae186c6014d6b.svg"
}
}
Returns the requested lock
curl -XGET https://api.marinas.com/v1/locks/m2h8
{
"id": "m2h8",
"resource": "lock",
"name": "John C Stennis Lock",
"rating": null,
"review_count": 0,
"location": {
"lat": 33.5177994,
"lon": -88.4891968,
"what3words": "heavyweight.tailoring.freebies"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/lock/m2h8_John_C_Stennis_Lock_MS_United_States",
"api_url": "https://api.marinas.com/v1/locks/m2h8",
"icon_url": "https://marinas.com/assets/map/marker_lock-031ad3063a02c6ae9a9e83a4b831b71e514336e5fddc42f57dd0b1b76ad4bc4f.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_lock-033a1936f243e2446f49139b3bd50a18fce252b184295a56c5382aa998ce543d.svg",
"regular": "https://marinas.com/assets/map/marker_lock-031ad3063a02c6ae9a9e83a4b831b71e514336e5fddc42f57dd0b1b76ad4bc4f.svg",
"dark": "https://marinas.com/assets/map/dark/marker_lock-dc7a9ac7f2ae3766b18356c24761515921ba2d2459c40ba5e2699e609efa3986.svg"
}
}
Returns the requested lighthouse
curl -XGET https://api.marinas.com/v1/lighthouses/enae
{
"id": "enae",
"resource": "lighthouse",
"name": "Lynde Point Light",
"rating": null,
"review_count": 0,
"location": {
"lat": 41.2714005,
"lon": -72.3435974,
"what3words": "prowess.docked.product"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/lighthouse/enae_Lynde_Point_Light_Lighthouse_CT_United_States",
"api_url": "https://api.marinas.com/v1/lighthouses/enae",
"icon_url": "https://marinas.com/assets/map/marker_lighthouse-4c26738be58762d672a6b14b92c79485e7fb4fd5f914f91b92c46a9dcae1d0ba.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_lighthouse-6cc43fae0cf6bfe9a6b60ce7c9bdb9fbca9a9191e5c513da38c6fe5b78ef9ada.svg",
"regular": "https://marinas.com/assets/map/marker_lighthouse-4c26738be58762d672a6b14b92c79485e7fb4fd5f914f91b92c46a9dcae1d0ba.svg",
"dark": "https://marinas.com/assets/map/dark/marker_lighthouse-8275a4410d887c23e4a9b13a09b7bf2d447114ec2c79efb4c1f195caaa886c18.svg"
}
}
Returns the requested ferry
curl -XGET https://api.marinas.com/v1/ferrys/21b3
{
"id": "21b3",
"resource": "ferry",
"name": "Hammer Ferry Bridge",
"rating": null,
"review_count": 0,
"location": {
"lat": 55.7552986,
"lon": 11.8436003,
"what3words": "carefully.renditions.shines"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/ferry/21b3_Hammer_Ferry_Bridge_Frederiksborg_Denmark",
"api_url": "https://api.marinas.com/v1/ferrys/21b3",
"icon_url": "https://marinas.com/assets/map/marker_ferry-20bb3acde367b1ea44b1d114ad0e55ef932bc473f3900585cd611e989f64780e.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_ferry-1f907f64d317adc52f3e9abf613884b140ad38ae28f5153c99b2569b1a26a674.svg",
"regular": "https://marinas.com/assets/map/marker_ferry-20bb3acde367b1ea44b1d114ad0e55ef932bc473f3900585cd611e989f64780e.svg",
"dark": "https://marinas.com/assets/map/dark/marker_ferry-67963604d93cc5547e29be8f56e66290ef12cb73a72ad38d7678ffb5e60ec928.svg"
}
}
Returns the requested landmark
curl -XGET https://api.marinas.com/v1/landmarks/2rse
{
"id": "2rse",
"resource": "landmark",
"name": "Maine Maritime Museum",
"rating": null,
"review_count": 0,
"location": {
"lat": 43.8936005,
"lon": -69.8135986,
"what3words": "grumble.babysitter.scrolled"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/landmark/2rse_Maine_Maritime_Museum_Landmark_Bath_ME_United_States",
"api_url": "https://api.marinas.com/v1/landmarks/2rse",
"icon_url": "https://marinas.com/assets/map/marker_landmark-ea7546c4fd3808495beb2dd71648bff53b27b53775184e82de28d6b4642bfea3.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_landmark-06372b51341fe6bbd1f5922361c5decca8278d994f800d734e13b8508e3a8410.svg",
"regular": "https://marinas.com/assets/map/marker_landmark-ea7546c4fd3808495beb2dd71648bff53b27b53775184e82de28d6b4642bfea3.svg",
"dark": "https://marinas.com/assets/map/dark/marker_landmark-bc3efb1860dc523eda12bb06d34607754d53728f9ae9d9ebf68fd794ef53ed84.svg"
}
}
Returns the requested ramp
curl -XGET https://api.marinas.com/v1/ramps/2zc9
{
"id": "2zc9",
"resource": "ramp",
"name": "Wellingdorf Boat Works",
"rating": null,
"review_count": 0,
"location": {
"lat": 54.3258018,
"lon": 10.1856003,
"what3words": "surfed.genetics.boxing"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/ramp/2zc9_Wellingdorf_Boat_Works_Ramp_Schleswig-Holstein_Germany",
"api_url": "https://api.marinas.com/v1/ramps/2zc9",
"icon_url": "https://marinas.com/assets/map/marker_ramp-bf89640e772dbc6730ecabdef9383c853b655e6838285aeb2ddb9f651f92ffee.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_ramp-cd016dd1a911bb98d5bb176fe543f006439ed4f9c08b401a6d32b9b025ff3d87.svg",
"regular": "https://marinas.com/assets/map/marker_ramp-bf89640e772dbc6730ecabdef9383c853b655e6838285aeb2ddb9f651f92ffee.svg",
"dark": "https://marinas.com/assets/map/dark/marker_ramp-d6f9fa2dcc5d6909b5688b688b2806b31205cbde47c5fd5aaea0376d7b614490.svg"
}
}