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.6585365853658537",
"review_count": 41,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": "crab.couches.sports"
},
"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.6585365853658537",
"review_count": 41,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": "crab.couches.sports"
},
"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": 57
}
Returns the requested point
curl -XGET https://api.marinas.com/v1/points/55c4
{
"id": "55c4",
"resource": "point",
"name": "Anchorage Marina",
"kind": "marina",
"rating": "4.6585365853658537",
"review_count": 41,
"location": {
"lat": 39.2799007,
"lon": -76.5830018,
"what3words": "crab.couches.sports"
},
"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.28783449044417' \
-d 'location[lon]=-76.39857580839772'
{
"resource": "geolist",
"data": [
{
"id": "jncq",
"resource": "marina",
"name": "Baltimore Yacht Club",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.28783449044417,
"lon": -76.39857580839772,
"what3words": "figs.ongoing.hesitating"
},
"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": 144
}
Returns the requested marina
curl -XGET https://api.marinas.com/v1/marinas/jncq
{
"id": "jncq",
"resource": "marina",
"name": "Baltimore Yacht Club",
"rating": null,
"review_count": 0,
"location": {
"lat": 39.28783449044417,
"lon": -76.39857580839772,
"what3words": "figs.ongoing.hesitating"
},
"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/mpt7
{
"id": "mpt7",
"resource": "harbor",
"name": "Boothbay Harbor",
"rating": null,
"review_count": 0,
"location": {
"lat": 43.8330002,
"lon": -69.6343994,
"what3words": "roadshow.flaunting.brightest"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/harbor/mpt7_Boothbay_Harbor_Boothbay_ME_United_States",
"api_url": "https://api.marinas.com/v1/harbors/mpt7",
"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/ylu5
{
"id": "ylu5",
"resource": "bridge",
"name": "Egernsund Bridge",
"rating": null,
"review_count": 0,
"location": {
"lat": 54.9067001,
"lon": 9.6005602,
"what3words": "admiration.psychic.riverside"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/bridge/ylu5_Egernsund_Bridge_South_Jutland_Denmark",
"api_url": "https://api.marinas.com/v1/bridges/ylu5",
"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/n2hw
{
"id": "n2hw",
"resource": "lock",
"name": "General Joe Wheeler Lock",
"rating": null,
"review_count": 0,
"location": {
"lat": 34.8128014,
"lon": -87.3843994,
"what3words": "bookstores.abolish.exuding"
},
"images": {
"resource": "list",
"data": [
],
"total_count": 0
},
"web_url": "https://marinas.com/view/lock/n2hw_General_Joe_Wheeler_Lock_AL_United_States",
"api_url": "https://api.marinas.com/v1/locks/n2hw",
"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/r1bl
{
"id": "r1bl",
"resource": "ferry",
"name": "Ebeltoft Faergenhavn",
"rating": null,
"review_count": 0,
"location": {
"lat": 56.1502991,
"lon": 10.6710997,
"what3words": "rift.refinement.bonded"
},
"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/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/wlc3
{
"id": "wlc3",
"resource": "ramp",
"name": "Anchorage Park Marina Ramp",
"rating": null,
"review_count": 0,
"location": {
"lat": 26.8080997,
"lon": -80.0710983,
"what3words": "scarf.fencing.faces"
},
"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"
}
}