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/55c4The 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": "55c4",
"resource": "point",
"name": "Anchorage Marina",
"kind": "marina",
"rating": "4.81",
"review_count": 109,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": null
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/08a7d8172b9c50ad788829a30352fef9dd53369a2eed9db0a6fc82968f3edac9.jpg",
"small_url": "https://img.marinas.com/v2/66b5c8b6cdb8898c63689e1a470f484a1b6b535f01644fbbff23bb276a600849.jpg",
"medium_url": "https://img.marinas.com/v2/1e6988582eaf56fa27fa2b9d6f030b43fc9a5c8f01a105c03e6f4ad9429d9353.jpg",
"banner_url": "https://img.marinas.com/v2/a1cb110e4527263054798f570359471057a89bdd9b98d5937d46c7741d2b1a53.jpg",
"full_url": "https://img.marinas.com/v2/bd3024d35ac45b8c0d169837b366733c0f8a0f9e9d2bb896547d3e1642609ebb.jpg"
}
],
"total_count": 13
},
"web_url": "https://marinas.com/view/marina/55c4_Anchorage_Marina_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/55c4",
"icon_url": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.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-7a692fc44dd1ae6705b7602653fc781970574941667b972eb06304bc693e70c2.svg",
"regular": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-27bff23b095d1955c948714dc446dad351e5d032d6f8c9606547de44a1e5d2f9.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.2799007' \
-d 'location[lon]=-76.5830018'{
"resource": "geolist",
"data": [
{
"id": "55c4",
"resource": "point",
"name": "Anchorage Marina",
"kind": "marina",
"rating": "4.81",
"review_count": 109,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": null
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/08a7d8172b9c50ad788829a30352fef9dd53369a2eed9db0a6fc82968f3edac9.jpg",
"small_url": "https://img.marinas.com/v2/66b5c8b6cdb8898c63689e1a470f484a1b6b535f01644fbbff23bb276a600849.jpg",
"medium_url": "https://img.marinas.com/v2/1e6988582eaf56fa27fa2b9d6f030b43fc9a5c8f01a105c03e6f4ad9429d9353.jpg",
"banner_url": "https://img.marinas.com/v2/a1cb110e4527263054798f570359471057a89bdd9b98d5937d46c7741d2b1a53.jpg",
"full_url": "https://img.marinas.com/v2/bd3024d35ac45b8c0d169837b366733c0f8a0f9e9d2bb896547d3e1642609ebb.jpg"
}
],
"total_count": 13
},
"web_url": "https://marinas.com/view/marina/55c4_Anchorage_Marina_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/55c4",
"icon_url": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.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-7a692fc44dd1ae6705b7602653fc781970574941667b972eb06304bc693e70c2.svg",
"regular": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-27bff23b095d1955c948714dc446dad351e5d032d6f8c9606547de44a1e5d2f9.svg"
}
}
],
"bounds": {
"ne": {
"lat": 39.2799007,
"lon": -76.5830018
},
"sw": {
"lat": 39.2799007,
"lon": -76.5830018
}
},
"total_count": 388
}Returns the requested point
curl -XGET https://api.marinas.com/v1/points/55c4{
"id": "55c4",
"resource": "point",
"name": "Anchorage Marina",
"kind": "marina",
"rating": "4.81",
"review_count": 109,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": null
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/08a7d8172b9c50ad788829a30352fef9dd53369a2eed9db0a6fc82968f3edac9.jpg",
"small_url": "https://img.marinas.com/v2/66b5c8b6cdb8898c63689e1a470f484a1b6b535f01644fbbff23bb276a600849.jpg",
"medium_url": "https://img.marinas.com/v2/1e6988582eaf56fa27fa2b9d6f030b43fc9a5c8f01a105c03e6f4ad9429d9353.jpg",
"banner_url": "https://img.marinas.com/v2/a1cb110e4527263054798f570359471057a89bdd9b98d5937d46c7741d2b1a53.jpg",
"full_url": "https://img.marinas.com/v2/bd3024d35ac45b8c0d169837b366733c0f8a0f9e9d2bb896547d3e1642609ebb.jpg"
}
],
"total_count": 13
},
"web_url": "https://marinas.com/view/marina/55c4_Anchorage_Marina_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/55c4",
"icon_url": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.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-7a692fc44dd1ae6705b7602653fc781970574941667b972eb06304bc693e70c2.svg",
"regular": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-27bff23b095d1955c948714dc446dad351e5d032d6f8c9606547de44a1e5d2f9.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.259790916124274' \
-d 'location[lon]=-76.6135644707624'{
"resource": "geolist",
"data": [
{
"id": "95cz",
"resource": "marina",
"name": "Baltimore Yacht Basin",
"rating": "1.0",
"review_count": 1,
"location": {
"lat": 39.259790916124274,
"lon": -76.6135644707624,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/marina/95cz_Baltimore_Yacht_Basin_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/95cz",
"icon_url": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_marina-7a692fc44dd1ae6705b7602653fc781970574941667b972eb06304bc693e70c2.svg",
"regular": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-27bff23b095d1955c948714dc446dad351e5d032d6f8c9606547de44a1e5d2f9.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.259790916124274,
"lon": -76.6135644707624
},
"sw": {
"lat": 39.259790916124274,
"lon": -76.6135644707624
}
},
"total_count": 323
}Returns the requested marina
curl -XGET https://api.marinas.com/v1/marinas/95cz{
"id": "95cz",
"resource": "marina",
"name": "Baltimore Yacht Basin",
"rating": "1.0",
"review_count": 1,
"location": {
"lat": 39.259790916124274,
"lon": -76.6135644707624,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/marina/95cz_Baltimore_Yacht_Basin_Baltimore_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/95cz",
"icon_url": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_marina-7a692fc44dd1ae6705b7602653fc781970574941667b972eb06304bc693e70c2.svg",
"regular": "https://marinas.com/assets/map/marker_marina-2cd81bae4bd4c178e63072249648600ec23a38c63fbe701c456a324bae92329f.svg",
"dark": "https://marinas.com/assets/map/dark/marker_marina-27bff23b095d1955c948714dc446dad351e5d032d6f8c9606547de44a1e5d2f9.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/3ntg{
"id": "3ntg",
"resource": "harbor",
"name": "The Pool, Cranberry Island",
"rating": null,
"review_count": 0,
"location": {
"lat": 44.2518997,
"lon": -68.2485962,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/harbor/3ntg_The_Pool_Cranberry_Island_Harbor_ME_United_States",
"api_url": "https://api.marinas.com/v1/harbors/3ntg",
"icon_url": "https://marinas.com/assets/map/marker_harbor-75242b74a7b98d89e189ab8709d29dd9553ebbdb4097196fd32b58c1fd5cf952.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_harbor-aaebd10c4f61768ce01566373b8de6b56cc06bf01d63c74d00425e1bba237bf9.svg",
"regular": "https://marinas.com/assets/map/marker_harbor-75242b74a7b98d89e189ab8709d29dd9553ebbdb4097196fd32b58c1fd5cf952.svg",
"dark": "https://marinas.com/assets/map/dark/marker_harbor-84dd6a6f98eb07de5606c9a621bb4726a1db8c4b046a71c1c6036f11edd71f4e.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": null
},
"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-f913c81c9c3c7bdc6a91b91f1b97d493f611b324a5daeaa0aaa583b187bf6e94.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_anchorage-996ba6c02bba1901ef2abc730247132adc61469c3cbfc915d3eedb372263c203.svg",
"regular": "https://marinas.com/assets/map/marker_anchorage-f913c81c9c3c7bdc6a91b91f1b97d493f611b324a5daeaa0aaa583b187bf6e94.svg",
"dark": "https://marinas.com/assets/map/dark/marker_anchorage-0c410dbef484b46de47f93a2d2eaf93b5fd6feb51ab0e6c07c1192d4f1ffab82.svg"
}
}Returns the requested inlet
curl -XGET https://api.marinas.com/v1/inlets/nviq{
"id": "nviq",
"resource": "inlet",
"name": "Cape Island Creek North Inlet",
"rating": null,
"review_count": 0,
"location": {
"lat": 38.9482994,
"lon": -74.9075012,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/inlet/nviq_Cape_Island_Creek_North_Inlet_Cape_May_NJ_United_States",
"api_url": "https://api.marinas.com/v1/inlets/nviq",
"icon_url": "https://marinas.com/assets/map/marker_inlet-e08407cc686c552eda31dc1eebbb60b79c48864bb91c271de5db6e76e21c2200.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_inlet-5463c651e7a8cbb04db26899bd4ff91008f0818ffa14b96a903e959b1b8bda57.svg",
"regular": "https://marinas.com/assets/map/marker_inlet-e08407cc686c552eda31dc1eebbb60b79c48864bb91c271de5db6e76e21c2200.svg",
"dark": "https://marinas.com/assets/map/dark/marker_inlet-c2bc317398f41507f4b73eaf6354d47603c0f2ff0e9663788fc953198d032268.svg"
}
}Returns the requested bridge
curl -XGET https://api.marinas.com/v1/bridges/nyu3{
"id": "nyu3",
"resource": "bridge",
"name": "E52 Frederikssund Bridge",
"rating": null,
"review_count": 0,
"location": {
"lat": 55.8442001,
"lon": 12.0417004,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/bridge/nyu3_E52_Frederikssund_Bridge_Frederiksberg_Denmark",
"api_url": "https://api.marinas.com/v1/bridges/nyu3",
"icon_url": "https://marinas.com/assets/map/marker_bridge-b5c5323cb25fde34dc678e35a4aadf07f3410cf1603a12b9be077a75b3e28b68.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_bridge-319837ae6b3a6e31aec73139dc534cf124c82891fdb317cee0f2957fce820307.svg",
"regular": "https://marinas.com/assets/map/marker_bridge-b5c5323cb25fde34dc678e35a4aadf07f3410cf1603a12b9be077a75b3e28b68.svg",
"dark": "https://marinas.com/assets/map/dark/marker_bridge-75fa25d20294c19b7dbd342b53ef44d863d37d9b38e0821d180ac565f0434e54.svg"
}
}Returns the requested lock
curl -XGET https://api.marinas.com/v1/locks/rvhr{
"id": "rvhr",
"resource": "lock",
"name": "Millers Ferry Lock",
"rating": null,
"review_count": 0,
"location": {
"lat": 32.0786018,
"lon": -87.3972015,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/lock/rvhr_Millers_Ferry_Lock_AL_United_States",
"api_url": "https://api.marinas.com/v1/locks/rvhr",
"icon_url": "https://marinas.com/assets/map/marker_lock-b965589a1b151e9ed5d1a4062d7fb24c0ad600fc6a8a9014db9b41e13d9bfe89.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_lock-99081577041cbcd84006380725d4cb10fe43d792a4019ac60d911d8d5ee9a5e1.svg",
"regular": "https://marinas.com/assets/map/marker_lock-b965589a1b151e9ed5d1a4062d7fb24c0ad600fc6a8a9014db9b41e13d9bfe89.svg",
"dark": "https://marinas.com/assets/map/dark/marker_lock-e1799b26c6a368d938051cd38ec59a1e5450b8d56b401eb154a90584cd542c0c.svg"
}
}Returns the requested lighthouse
curl -XGET https://api.marinas.com/v1/lighthouses/q6ad{
"id": "q6ad",
"resource": "lighthouse",
"name": "Ostend Lighthouse - Lange Nelle",
"rating": null,
"review_count": 0,
"location": {
"lat": 51.2358017,
"lon": 2.93028,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/lighthouse/q6ad_Ostend_Lighthouse_-_Lange_Nelle_Belgium",
"api_url": "https://api.marinas.com/v1/lighthouses/q6ad",
"icon_url": "https://marinas.com/assets/map/marker_lighthouse-3067ffdb332c55f67b2eea3bff20fe8b0e8b70a781605064b20505a5d7bd5524.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_lighthouse-8afd07831a1db48727a678ddf30cd94a2701fb6e907cd30367014bb843746d1b.svg",
"regular": "https://marinas.com/assets/map/marker_lighthouse-3067ffdb332c55f67b2eea3bff20fe8b0e8b70a781605064b20505a5d7bd5524.svg",
"dark": "https://marinas.com/assets/map/dark/marker_lighthouse-7789409a2a66fdae2a78c756b450ff3be8d9e443daa1b2320f5172732cdc3c12.svg"
}
}Returns the requested ferry
curl -XGET https://api.marinas.com/v1/ferrys/qmb1{
"id": "qmb1",
"resource": "ferry",
"name": "Hals Ferry",
"rating": null,
"review_count": 0,
"location": {
"lat": 56.990799,
"lon": 10.3066998,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/ferry/qmb1_Hals_Ferry_North_Jutland_Denmark",
"api_url": "https://api.marinas.com/v1/ferrys/qmb1",
"icon_url": "https://marinas.com/assets/map/marker_ferry-de343c69b296d046bab0784ac1ca9ae94287c52b78a597ad1cfa8275696136a8.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_ferry-c10d89dd7f3f0dde7b7108965c98e80c236ef3bff9f422fd0af5ff3b610f0e66.svg",
"regular": "https://marinas.com/assets/map/marker_ferry-de343c69b296d046bab0784ac1ca9ae94287c52b78a597ad1cfa8275696136a8.svg",
"dark": "https://marinas.com/assets/map/dark/marker_ferry-02c5d0408dbd15d31171e4180c431a0acebc863afdbc003e68433567f2d90442.svg"
}
}Returns the requested landmark
curl -XGET https://api.marinas.com/v1/landmarks/wqsx{
"id": "wqsx",
"resource": "landmark",
"name": "Damariscove Island, Eastern Tower",
"rating": null,
"review_count": 0,
"location": {
"lat": 43.7542,
"lon": -69.6125031,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/landmark/wqsx_Damariscove_Island_Eastern_Tower_Landmark_Damariscotta_ME_United_States",
"api_url": "https://api.marinas.com/v1/landmarks/wqsx",
"icon_url": "https://marinas.com/assets/map/marker_landmark-75547db68ac388332b3b068c5fcf5c42758eabe76c40bb61f58e3389b5388541.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_landmark-b4ddf0641c3320452505ae3c5ad921f6adaefed263276c6682458dde4d7dc3a7.svg",
"regular": "https://marinas.com/assets/map/marker_landmark-75547db68ac388332b3b068c5fcf5c42758eabe76c40bb61f58e3389b5388541.svg",
"dark": "https://marinas.com/assets/map/dark/marker_landmark-fb7b474803cd9dd8c493c1737a738c8309f73ea53a495aecafb15446478201f9.svg"
}
}Returns the requested ramp
curl -XGET https://api.marinas.com/v1/ramps/qnc2{
"id": "qnc2",
"resource": "ramp",
"name": "Woods Hole Town Ramp",
"rating": null,
"review_count": 0,
"location": {
"lat": 41.5257988,
"lon": -70.6746979,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/ramp/qnc2_Woods_Hole_Town_Ramp_MA_United_States",
"api_url": "https://api.marinas.com/v1/ramps/qnc2",
"icon_url": "https://marinas.com/assets/map/marker_ramp-af1a66a2ec0de9689c448ccc6a50beb300385f0291dbff2d3ee3f38e6cb2ee03.svg",
"icon_urls": {
"light": "https://marinas.com/assets/map/light/marker_ramp-4474a03932ff2a54aaaa76a6c57dc569a25ae2bd52a3b8833fb5f875cfada32d.svg",
"regular": "https://marinas.com/assets/map/marker_ramp-af1a66a2ec0de9689c448ccc6a50beb300385f0291dbff2d3ee3f38e6cb2ee03.svg",
"dark": "https://marinas.com/assets/map/dark/marker_ramp-2e341324c1a2471151165e1eb3bb32f01db7c16771315e527d3428be0ea0ce53.svg"
}
}