{
"openapi": "3.0.1",
"info": {
"title": "Marinas.com Scraper — Contacts, Fuel, Amenities & Reviews",
"description": "Scrape Marinas.com marinas: phone, website, address, GPS, slips, depths, fuel prices, amenities, ratings, reviews and website emails.",
"version": "0.1",
"x-build-id": "MIsIXt3Hf1SxZshJR"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zapticx~marinas-com-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zapticx-marinas-com-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/zapticx~marinas-com-scraper/runs": {
"post": {
"operationId": "runs-sync-zapticx-marinas-com-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/zapticx~marinas-com-scraper/run-sync": {
"post": {
"operationId": "run-sync-zapticx-marinas-com-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"startUrls": {
"title": "Marinas.com URLs",
"type": "array",
"description": "Marina profile URLs (marinas.com/view/marina/…), state or country directory pages (marinas.com/browse/marina/US/FL) or Marinas.com marina search URLs. When you add URLs here, the location fields below are ignored.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Extract the Marinas.com marinas of whole countries, e.g. Croatia or HR. For the United States every state is walked in turn.",
"items": {
"type": "string"
}
},
"states": {
"title": "US states",
"type": "array",
"description": "Extract every marina Marinas.com lists in these US states (each state's complete directory, all pages). Large extractions: we recommend about 5 states per run, then download the results and run the next batch; see the README.",
"items": {
"type": "string",
"enum": [
"AL",
"AK",
"AS",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"GU",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"MP",
"OH",
"OK",
"OR",
"PA",
"PR",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VI",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
],
"enumTitles": [
"Alabama",
"Alaska",
"American Samoa",
"Arizona",
"Arkansas",
"California",
"Colorado",
"Connecticut",
"Delaware",
"District of Columbia",
"Florida",
"Georgia",
"Guam",
"Hawaii",
"Idaho",
"Illinois",
"Indiana",
"Iowa",
"Kansas",
"Kentucky",
"Louisiana",
"Maine",
"Maryland",
"Massachusetts",
"Michigan",
"Minnesota",
"Mississippi",
"Missouri",
"Montana",
"Nebraska",
"Nevada",
"New Hampshire",
"New Jersey",
"New Mexico",
"New York",
"North Carolina",
"North Dakota",
"Northern Mariana Islands",
"Ohio",
"Oklahoma",
"Oregon",
"Pennsylvania",
"Puerto Rico",
"Rhode Island",
"South Carolina",
"South Dakota",
"Tennessee",
"Texas",
"Utah",
"U.S. Virgin Islands",
"Vermont",
"Virginia",
"Washington",
"West Virginia",
"Wisconsin",
"Wyoming"
]
}
},
"cities": {
"title": "US cities",
"type": "array",
"description": "Marinas in and around a US city, e.g. Annapolis, MD. Marinas.com's city search shows up to about 50 marinas; choose a state for complete coverage.",
"items": {
"type": "string"
}
},
"extractAllMarinas": {
"title": "Extract all Marinas.com marinas",
"type": "boolean",
"description": "Extract every marina listed on Marinas.com (worldwide, about 20,000) from Marinas.com's marina sitemap. Set Maximum marinas to 25000 to get them all. Uses fast contact mode. Large runs take several hours; progress is saved continuously, so a stopped run can be resurrected and continues where it left off without charging any marina twice.",
"default": false
},
"searchTerms": {
"title": "Marina name contains",
"type": "array",
"description": "Find marinas by name, e.g. Safe Harbor or yacht club. Add states, cities or countries to narrow the search.",
"items": {
"type": "string"
}
},
"maxResults": {
"title": "Maximum marinas",
"minimum": 1,
"maximum": 25000,
"type": "integer",
"description": "The TOTAL number of marinas for the whole run, across all selected states, cities and countries (not per state). At 20, a five-state run returns at most 20 marinas in total. For a normal 5-state batch, raise it high enough to cover every marina in those states, e.g. 5000. You pay only for marinas delivered to your dataset.",
"default": 100
},
"enrichEmailsFromWebsite": {
"title": "Find emails on official websites",
"type": "boolean",
"description": "Marinas.com rarely shows email addresses. When on, the Actor visits each marina's own official website, respects robots.txt and returns publicly displayed business emails with their source page; it never guesses addresses. How many pages it reads is set by Fast contact mode. Included in the price. Turn off for faster runs without emails.",
"default": true
},
"fastContactMode": {
"title": "Fast contact mode (phone + email)",
"type": "boolean",
"description": "On by default. Email lookup reads the marina's homepage and, only if no public business email is found there, at most one Contact page; it stops at the first valid email. Turn off for the thorough lookup (up to 3 pages: home, contact, about), which is slower. Always on with Extract all Marinas.com marinas.",
"default": true
},
"includeReviews": {
"title": "Include reviews",
"type": "boolean",
"description": "Add every review shown on the marina's Marinas.com profile: rating, date, verified stay, text and the marina's response. Reviewer names are not collected. Included in the price; popular marinas can have hundreds of reviews.",
"default": false
},
"includeClosed": {
"title": "Include closed marinas",
"type": "boolean",
"description": "Also return marinas that Marinas.com reports as closed (labelled closed: true). Skipped closed marinas are never charged.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Apify datacenter proxy works well for Marinas.com and is the default.",
"default": {
"useApifyProxy": true
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}