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/eycq
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": "eycq",
"resource": "point",
"name": "All Star Marine",
"kind": "marina",
"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-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.283166666638884' \
-d 'location[lon]=-76.3955'
{
"resource": "geolist",
"data": [
{
"id": "eycq",
"resource": "point",
"name": "All Star Marine",
"kind": "marina",
"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-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.283166666638884,
"lon": -76.3955
},
"sw": {
"lat": 39.283166666638884,
"lon": -76.3955
}
},
"total_count": 820
}
Returns the requested point
curl -XGET https://api.marinas.com/v1/points/eycq
{
"id": "eycq",
"resource": "point",
"name": "All Star Marine",
"kind": "marina",
"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-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.28783449044417' \
-d 'location[lon]=-76.39857580839772'
{
"resource": "geolist",
"data": [
{
"id": "jncq",
"resource": "marina",
"name": "Baltimore Yacht Club",
"rating": "4.33",
"review_count": 3,
"location": {
"lat": 39.28783449044417,
"lon": -76.39857580839772,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/marina/jncq_Baltimore_Yacht_Club_Essex_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/jncq",
"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": true,
"has_propane": false,
"has_gas": true,
"propane_price": null,
"diesel_price": null,
"gas_regular_price": null,
"gas_super_price": null,
"gas_premium_price": null
}
}
],
"bounds": {
"ne": {
"lat": 39.28783449044417,
"lon": -76.39857580839772
},
"sw": {
"lat": 39.28783449044417,
"lon": -76.39857580839772
}
},
"total_count": 96
}
Returns the requested marina
curl -XGET https://api.marinas.com/v1/marinas/jncq
{
"id": "jncq",
"resource": "marina",
"name": "Baltimore Yacht Club",
"rating": "4.33",
"review_count": 3,
"location": {
"lat": 39.28783449044417,
"lon": -76.39857580839772,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/marina/jncq_Baltimore_Yacht_Club_Essex_MD_United_States",
"api_url": "https://api.marinas.com/v1/marinas/jncq",
"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": true,
"has_propane": false,
"has_gas": true,
"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/rltp
{
"id": "rltp",
"resource": "harbor",
"name": "Belfast Harbor",
"rating": null,
"review_count": 0,
"location": {
"lat": 44.4333,
"lon": -69.0121994,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/harbor/rltp_Belfast_Harbor_Belfast_ME_United_States",
"api_url": "https://api.marinas.com/v1/harbors/rltp",
"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/mli4
{
"id": "mli4",
"resource": "inlet",
"name": "Beach Creek South Inlet",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.0032997,
"lon": -74.8133011,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/inlet/mli4_Beach_Creek_South_Inlet_North_Wildwood_NJ_United_States",
"api_url": "https://api.marinas.com/v1/inlets/mli4",
"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": null
},
"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": null
},
"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/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/r1bl
{
"id": "r1bl",
"resource": "ferry",
"name": "Ebeltoft Faergenhavn",
"rating": null,
"review_count": 0,
"location": {
"lat": 56.1502991,
"lon": 10.6710997,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/ferry/r1bl_Ebeltoft_Faergenhavn_Ferry_Aarhus_Denmark",
"api_url": "https://api.marinas.com/v1/ferrys/r1bl",
"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/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-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/wlc3
{
"id": "wlc3",
"resource": "ramp",
"name": "Anchorage Park Marina Ramp",
"rating": null,
"review_count": 0,
"location": {
"lat": 26.8080997,
"lon": -80.0710983,
"what3words": null
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/ramp/wlc3_Anchorage_Park_Marina_Ramp_FL_United_States",
"api_url": "https://api.marinas.com/v1/ramps/wlc3",
"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"
}
}