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/55c4
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": "55c4",
"resource": "point",
"name": "Anchorage Marina",
"kind": "marina",
"rating": "4.77",
"review_count": 84,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": null
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/a0c45d0c38ce92d87d4933e4ba0d129b1c5858cefdb7248ab009c71f00cf4bab.jpg",
"small_url": "https://img.marinas.com/v2/3c6ea7ae7f989ac855cc0674a92acfea09abd4818c0a3163da3c01f2ff745820.jpg",
"medium_url": "https://img.marinas.com/v2/cb931c86ca38e4f9c39c20469286c0927309014bab35a3320100748dc0be4e40.jpg",
"banner_url": "https://img.marinas.com/v2/2055771c5995b013338c7b5f80b677b2a46bc320a622abd08796940dd83d2364.jpg",
"full_url": "https://img.marinas.com/v2/48c247e7d14b4c52b5b5fc5d7d0ae03b6cdad041370622cf589a72896116cccc.jpg"
}
],
"total_count": 6
},
"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-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.2799007' \
-d 'location[lon]=-76.5830018'
{
"resource": "geolist",
"data": [
{
"id": "55c4",
"resource": "point",
"name": "Anchorage Marina",
"kind": "marina",
"rating": "4.77",
"review_count": 84,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": null
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/a0c45d0c38ce92d87d4933e4ba0d129b1c5858cefdb7248ab009c71f00cf4bab.jpg",
"small_url": "https://img.marinas.com/v2/3c6ea7ae7f989ac855cc0674a92acfea09abd4818c0a3163da3c01f2ff745820.jpg",
"medium_url": "https://img.marinas.com/v2/cb931c86ca38e4f9c39c20469286c0927309014bab35a3320100748dc0be4e40.jpg",
"banner_url": "https://img.marinas.com/v2/2055771c5995b013338c7b5f80b677b2a46bc320a622abd08796940dd83d2364.jpg",
"full_url": "https://img.marinas.com/v2/48c247e7d14b4c52b5b5fc5d7d0ae03b6cdad041370622cf589a72896116cccc.jpg"
}
],
"total_count": 6
},
"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-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.2799007,
"lon": -76.5830018
},
"sw": {
"lat": 39.2799007,
"lon": -76.5830018
}
},
"total_count": 994
}
Returns the requested point
curl -XGET https://api.marinas.com/v1/points/55c4
{
"id": "55c4",
"resource": "point",
"name": "Anchorage Marina",
"kind": "marina",
"rating": "4.77",
"review_count": 84,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": null
},
"images": {
"resource": "list",
"data": [
{
"resource": "image",
"thumbnail_url": "https://img.marinas.com/v2/a0c45d0c38ce92d87d4933e4ba0d129b1c5858cefdb7248ab009c71f00cf4bab.jpg",
"small_url": "https://img.marinas.com/v2/3c6ea7ae7f989ac855cc0674a92acfea09abd4818c0a3163da3c01f2ff745820.jpg",
"medium_url": "https://img.marinas.com/v2/cb931c86ca38e4f9c39c20469286c0927309014bab35a3320100748dc0be4e40.jpg",
"banner_url": "https://img.marinas.com/v2/2055771c5995b013338c7b5f80b677b2a46bc320a622abd08796940dd83d2364.jpg",
"full_url": "https://img.marinas.com/v2/48c247e7d14b4c52b5b5fc5d7d0ae03b6cdad041370622cf589a72896116cccc.jpg"
}
],
"total_count": 6
},
"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-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.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-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.259790916124274,
"lon": -76.6135644707624
},
"sw": {
"lat": 39.259790916124274,
"lon": -76.6135644707624
}
},
"total_count": 179
}
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-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/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-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/m4f9
{
"id": "m4f9",
"resource": "anchorage",
"name": "Isthmus Harbor Department",
"rating": null,
"review_count": 0,
"location": {
"lat": 33.4425011,
"lon": -118.4990005,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/anchorage/m4f9_Isthmus_Harbor_Department_Anchorage_Two_Harbors_CA_United_States",
"api_url": "https://api.marinas.com/v1/anchorages/m4f9",
"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": null
},
"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/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-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/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-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/52an
{
"id": "52an",
"resource": "lighthouse",
"name": "Old Tower Lighthouse",
"rating": null,
"review_count": 0,
"location": {
"lat": 41.2489014,
"lon": -72.9041977,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/lighthouse/52an_Old_Tower_Lighthouse_CT_United_States",
"api_url": "https://api.marinas.com/v1/lighthouses/52an",
"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/wzbr
{
"id": "wzbr",
"resource": "ferry",
"name": "Hardeshøj Ferry Harbor",
"rating": null,
"review_count": 0,
"location": {
"lat": 55.0066986,
"lon": 9.6930599,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/ferry/wzbr_Hardeshøj_Ferry_Harbor_South_Jutland_Denmark",
"api_url": "https://api.marinas.com/v1/ferrys/wzbr",
"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/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-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/elcn
{
"id": "elcn",
"resource": "ramp",
"name": "Calais Town Landing",
"rating": null,
"review_count": 0,
"location": {
"lat": 45.1899986,
"lon": -67.2769012,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/ramp/elcn_Calais_Town_Landing_Ramp_Calais_ME_United_States",
"api_url": "https://api.marinas.com/v1/ramps/elcn",
"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"
}
}