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/95czThe 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": "95cz",
"resource": "point",
"name": "Baltimore Yacht Basin",
"kind": "marina",
"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",
"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.259790916124274' \
-d 'location[lon]=-76.6135644707624'{
"resource": "geolist",
"data": [
{
"id": "95cz",
"resource": "point",
"name": "Baltimore Yacht Basin",
"kind": "marina",
"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",
"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.259790916124274,
"lon": -76.6135644707624
},
"sw": {
"lat": 39.259790916124274,
"lon": -76.6135644707624
}
},
"total_count": 334
}Returns the requested point
curl -XGET https://api.marinas.com/v1/points/95cz{
"id": "95cz",
"resource": "point",
"name": "Baltimore Yacht Basin",
"kind": "marina",
"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",
"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.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": null
},
"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-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.283166666638884,
"lon": -76.3955
},
"sw": {
"lat": 39.283166666638884,
"lon": -76.3955
}
},
"total_count": 351
}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": null
},
"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-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/ygtv{
"id": "ygtv",
"resource": "harbor",
"name": "Bass Harbor",
"rating": null,
"review_count": 0,
"location": {
"lat": 44.2546997,
"lon": -68.3480988,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/harbor/ygtv_Bass_Harbor_Tremont_ME_United_States",
"api_url": "https://api.marinas.com/v1/harbors/ygtv",
"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/8vfd{
"id": "8vfd",
"resource": "anchorage",
"name": "Marshall Anchorage",
"rating": null,
"review_count": 0,
"location": {
"lat": 38.1511002,
"lon": -122.8889999,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/anchorage/8vfd_Marshall_Anchorage_Marshall_CA_United_States",
"api_url": "https://api.marinas.com/v1/anchorages/8vfd",
"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/7puq{
"id": "7puq",
"resource": "bridge",
"name": "Stainton Memorial Bridge",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.2844009,
"lon": -74.5819016,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/bridge/7puq_Stainton_Memorial_Bridge_Ocean_City_NJ_United_States",
"api_url": "https://api.marinas.com/v1/bridges/7puq",
"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/33h8{
"id": "33h8",
"resource": "lock",
"name": "Holt Lock",
"rating": null,
"review_count": 0,
"location": {
"lat": 33.2518997,
"lon": -87.4511032,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/lock/33h8_Holt_Lock_AL_United_States",
"api_url": "https://api.marinas.com/v1/locks/33h8",
"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/21b3{
"id": "21b3",
"resource": "ferry",
"name": "Hammer Ferry Bridge",
"rating": null,
"review_count": 0,
"location": {
"lat": 55.7552986,
"lon": 11.8436003,
"what3words": null
},
"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-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/rjs1{
"id": "rjs1",
"resource": "landmark",
"name": "Fregatten Jyllands Ship",
"rating": null,
"review_count": 0,
"location": {
"lat": 56.2000008,
"lon": 10.6702995,
"what3words": null
},
"images": {
"resource": "list",
"data": [],
"total_count": 0
},
"web_url": "https://marinas.com/view/landmark/rjs1_Fregatten_Jyllands_Ship_Landmark_North_Jutland_Denmark",
"api_url": "https://api.marinas.com/v1/landmarks/rjs1",
"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/2zc9{
"id": "2zc9",
"resource": "ramp",
"name": "Wellingdorf Boat Works",
"rating": null,
"review_count": 0,
"location": {
"lat": 54.3258018,
"lon": 10.1856003,
"what3words": null
},
"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-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"
}
}