{ "openapi": "3.0.1", "info": { "title": "Boat Trader Scraper", "description": "Scrape boattrader.com boat-for-sale listings - browse by type, class, make, condition, fuel, hull shape, US state, and price/year/length range, or fetch full listing detail by ID/URL.", "version": "1.0", "x-build-id": "iWy0ZNov2ovgawx9n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~boat-trader-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-boat-trader-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/crawlerbros~boat-trader-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-boat-trader-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/crawlerbros~boat-trader-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-boat-trader-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "browse", "byId" ], "type": "string", "description": "What to fetch.", "default": "browse" }, "boatIds": { "title": "Boat IDs or URLs (mode=byId)", "type": "array", "description": "Boat Trader listing IDs (e.g. `9979385`) or full listing URLs (e.g. `https://www.boattrader.com/boat/2025-bennington-22ssbse-9979385/`).", "default": [], "items": { "type": "string" } }, "boatType": { "title": "Boat type (mode=browse)", "enum": [ "", "power", "sail", "pwc", "small" ], "type": "string", "description": "Top-level Boat Trader taxonomy. Leave blank to browse all types (or use Boat group instead).", "default": "power" }, "boatClass": { "title": "Boat class (mode=browse)", "enum": [ "", "power-pwc", "power-aft", "power-airboat", "power-aluminum", "power-antique", "power-barge", "power-bass", "power-bay", "power-bowrider", "power-center", "power-commercial", "power-convertible", "power-crossover", "power-cruiseship", "power-cruiser", "power-cuddy", "power-deck", "power-dive", "power-downeast", "power-dragger", "power-dualconsole", "power-expeditionyacht", "power-expresscruiser", "power-flats", "power-flybridge", "power-fresh", "power-highperf", "power-house", "power-jet", "power-jon", "power-lobster", "power-mega", "power-motor", "power-motorsailer", "power-multihull", "power-other", "power-passenger", "power-pilot", "power-pontoon", "power-pcatamaran", "power-rivercruiser", "power-runabout", "power-saltfish", "power-skifish", "power-skiwake", "power-skiff", "power-sloop", "power-sportfish", "power-sportcruiser", "power-surfboat", "power-trawler", "power-troller", "power-tug", "power-unspec", "power-util", "power-walk", "sail-antique", "sail-barge", "sail-beachcat", "sail-catamaran", "sail-centercockpit", "sail-commercial", "sail-cruiser", "sail-cutter", "sail-day", "sail-deck", "sail-ketch", "sail-motor", "sail-multihull", "sail-other", "sail-performance", "sail-pilot", "sail-racercruiser", "sail-racer", "sail-schooner", "sail-sloop", "sail-trimaran", "sail-unspec", "sail-yawl", "unpowered-kayak", "power-dinghy", "sail-dinghy", "unpowered-dinghy", "power-inflatable", "power-narrow", "power-rib", "power-tender", "unpowered-tender" ], "type": "string", "description": "Sub-category within Boat type (e.g. Pontoon, Center Console, Sloop). Must match the selected Boat type's family (power-*/sail-*/unpowered-*) or it is ignored.", "default": "" }, "boatGroup": { "title": "Boat group / activity (mode=browse)", "enum": [ "", "fishing-boats", "day-cruising-boats", "overnight-cruising-boats", "long-range-cruising-boats", "lakes-and-rivers-boats", "sailing-boats", "watersports", "commercial-boats" ], "type": "string", "description": "Alternative activity-based taxonomy (fishing, cruising, watersports, etc). When set, this replaces Boat type / Boat class (Boat Trader treats them as mutually exclusive).", "default": "" }, "make": { "title": "Make / brand (mode=browse)", "enum": [ "", "tracker", "sea-ray", "sun-tracker", "yamaha-boats", "sea-doo", "ranger", "bennington", "boston-whaler", "other", "chaparral", "regal", "bayliner", "yamaha-waverunner", "grady-white", "tahoe", "cobalt", "barletta", "starcraft", "robalo", "tidewater", "lowe", "nitro", "g3", "avalon", "beneteau", "key-west", "mastercraft", "sea-hunt", "sportsman", "lund", "pursuit", "nautique", "harris", "sea-pro", "sylvan", "mako", "scout", "malibu", "formula", "crownline", "highfield", "monterey", "chris-craft", "godfrey", "skeeter", "four-winns", "wellcraft", "sea-fox", "cobia", "cruisers-yachts", "xpress", "jeanneau", "tiara-yachts", "hurricane", "carver", "stingray", "carolina-skiff", "custom", "suncatcher", "catalina", "bentley-pontoons", "nauticstar", "veranda", "crestliner", "everglades", "tig", "parker", "hunter", "viaggio", "crest", "azimut", "pathfinder", "premier", "world-cat", "regulator", "vexus", "scarab", "edgewater", "axopar", "contender", "vision-marine-technologies", "rinker", "sailfish", "hatteras", "shoalwater", "edge-duck-boats", "silverton", "blackfin", "supra", "triton", "caymas", "viking", "fountain", "manitou", "evotti", "alumacraft", "axis", "regency", "yellowfin", "zodiac" ], "type": "string", "description": "Top 100 most-listed brands on Boat Trader. For any other brand, leave this blank and use `makeCustom` instead.", "default": "" }, "makeCustom": { "title": "Custom make / brand (mode=browse)", "type": "string", "description": "Free-text brand name for makes not in the `make` dropdown (e.g. `Marex`, `Axopar`). Overrides `make` when set." }, "condition": { "title": "Condition (mode=browse)", "enum": [ "", "new", "used" ], "type": "string", "description": "New or used boats.", "default": "" }, "fuelType": { "title": "Fuel type (mode=browse)", "enum": [ "", "gas", "diesel", "electric", "other" ], "type": "string", "description": "Engine fuel type.", "default": "" }, "hullShape": { "title": "Hull shape (mode=browse)", "enum": [ "", "modified-vee", "deep-vee", "pontoon", "other", "flat", "monohull", "catamaran", "displacement", "semi-displacement", "rib", "planing", "sea-v2", "tunnel", "trimaran", "roll-up", "foldable" ], "type": "string", "description": "Hull shape / configuration.", "default": "" }, "state": { "title": "US state (mode=browse)", "enum": [ "", "AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY" ], "type": "string", "description": "Restrict results to listings located in this US state.", "default": "" }, "keyword": { "title": "Keyword (mode=browse)", "type": "string", "description": "Full-text keyword search across title, description, and equipment (e.g. engine brand) — matches Boat Trader's own site search. Combines with other filters above." }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop listings priced below this amount." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop listings priced above this amount." }, "minYear": { "title": "Min model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Drop listings older than this model year." }, "maxYear": { "title": "Max model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Drop listings newer than this model year." }, "minLengthFt": { "title": "Min length (ft)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Drop boats shorter than this length in feet." }, "maxLengthFt": { "title": "Max length (ft)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Drop boats longer than this length in feet." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify proxy. Boat Trader is usually reachable without it; enable the free AUTO datacenter group if you see blocked/empty runs from your IP.", "default": { "useApifyProxy": false } } } }, "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 } } }, "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 } } } } } } } } } }