{ "openapi": "3.0.1", "info": { "title": "Boat Trader Scraper", "description": "[💰 $2.5 / 1K] Extract new and used boat listings from Boat Trader — price, year, make, model, length, engines, hull, HIN, dealer contacts, specs and photos. Filter by type, class, brand, condition, hull, state or ZIP radius, or paste any Boat Trader URL.", "version": "1.0", "x-build-id": "BGXh8sLnRf5grSIj0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~boattrader-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-boattrader-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/solidcode~boattrader-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-boattrader-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/solidcode~boattrader-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-boattrader-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": "Boat Trader URLs", "type": "array", "description": "Paste Boat Trader search-result pages or individual boat listing pages, for example 'https://www.boattrader.com/boats/type-power/class-power-pontoon/state-fl/' or 'https://www.boattrader.com/boat/2011-tracker-super-guide-v-16-sc-10259181/'. A bare listing number such as 10259181 works too. All three kinds are detected automatically, and boat pages are opened several at a time. Anything that isn't a Boat Trader search or boat page is skipped with a message, so a mistyped link can never turn into a nationwide search. When you add URLs here, the filters below are ignored. Leave empty to build a search with the filters instead.", "items": { "type": "string" } }, "searchKeyword": { "title": "Keyword", "type": "string", "description": "Words to look for in the listing title, description and equipment list, for example 'wake tower', 'twin diesel' or 'bass boat'. Leave empty to skip keyword matching." }, "boatType": { "title": "Boat Type", "enum": [ "any", "power", "sail", "pwc", "small" ], "type": "string", "description": "The broadest category of boat. Choose 'Any' to include everything." }, "boatClasses": { "title": "Boat Classes", "uniqueItems": true, "type": "array", "description": "Specific boat categories such as Pontoon, Center Console, Bowrider or Sloop. Pick as many as you like. Leave empty for all classes in the chosen boat type.", "items": { "type": "string", "enum": [ "power-aft", "power-airboat", "power-aluminum", "power-antique", "power-barge", "power-bass", "power-bay", "power-bowrider", "power-cargo", "power-center", "power-commercial", "power-convertible", "power-crossover", "power-cruiseship", "power-cruiser", "power-cuddy", "power-deck", "power-dive", "power-downeast", "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-supportvessel", "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", "power-pwc" ], "enumTitles": [ "Power — Aft Cabin", "Power — Airboat", "Power — Aluminum Fishing", "Power — Antique and Classic", "Power — Barge", "Power — Bass", "Power — Bay", "Power — Bowrider", "Power — Cargo Ships", "Power — Center Console", "Power — Commercial", "Power — Convertible", "Power — Crossover Boats", "Power — Cruise Ships", "Power — Cruisers", "Power — Cuddy Cabin", "Power — Deck", "Power — Dive", "Power — Downeast", "Power — Dual Console", "Power — Expedition Yachts", "Power — Express Cruiser", "Power — Flats", "Power — Flybridge", "Power — Freshwater Fishing", "Power — High Performance", "Power — Houseboat", "Power — Jet", "Power — Jon", "Power — Lobster", "Power — Mega Yachts", "Power — Motor Yachts", "Power — Motorsailer", "Power — Multihull", "Power — Other", "Power — Passenger", "Power — Pilothouse", "Power — Pontoon", "Power — Power Catamarans", "Power — River Cruiser", "Power — Runabout", "Power — Saltwater Fishing", "Power — Ski and Fish", "Power — Ski and Wakeboard", "Power — Skiff", "Power — Sloop", "Power — Sport Fishing", "Power — Sports Cruiser", "Power — Support Vessels", "Power — Surf Boats", "Power — Trawler", "Power — Troller", "Power — Tug", "Power — Unspecified", "Power — Utility", "Power — Walkaround", "Sail — Antique and Classic", "Sail — Barge", "Sail — Beach Catamaran", "Sail — Catamaran", "Sail — Center Cockpit", "Sail — Commercial", "Sail — Cruisers", "Sail — Cutter", "Sail — Daysailer", "Sail — Deck Saloon", "Sail — Ketch", "Sail — Motorsailer", "Sail — Multihull", "Sail — Other", "Sail — Performance", "Sail — Pilothouse", "Sail — Racer/Cruiser", "Sail — Racing", "Sail — Schooner", "Sail — Sloop", "Sail — Trimaran", "Sail — Unspecified", "Sail — Yawl", "Small — Canoe/Kayak", "Small — Dinghy (Power)", "Small — Dinghy (Sail)", "Small — Dinghy (Unpowered)", "Small — Inflatable", "Small — Narrowboats", "Small — Rigid Inflatable", "Small — Tender (Power)", "Small — Tender (Unpowered)", "PWC — All PWCs" ] } }, "boatGroup": { "title": "Activity Group", "enum": [ "any", "fishing-boats", "day-cruising-boats", "overnight-cruising-boats", "long-range-cruising-boats", "lakes-and-rivers-boats", "sailing-boats", "watersports", "commercial-boats" ], "type": "string", "description": "Boat Trader's activity-based grouping, for example all fishing boats or all watersports boats. When you choose a group it replaces the Boat Type and Boat Classes filters above." }, "makes": { "title": "Makes / Brands", "type": "array", "description": "Brand names exactly as Boat Trader shows them, for example 'Sea Ray', 'Bennington', 'Boston Whaler' or 'Grady-White'. Add as many as you like. Any of Boat Trader's 2,000+ brands works here. Leave empty for all brands.", "items": { "type": "string" } }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Show only new boats, only used boats, or both." }, "fuelTypes": { "title": "Fuel Types", "uniqueItems": true, "type": "array", "description": "Engine fuel. Pick one or more, or leave empty for all fuels.", "items": { "type": "string", "enum": [ "gas", "diesel", "electric", "other" ], "enumTitles": [ "Gas", "Diesel", "Electric", "Other" ] } }, "hullShapes": { "title": "Hull Shapes", "uniqueItems": true, "type": "array", "description": "The shape of the hull, which affects how the boat rides. Pick one or more, or leave empty for all shapes. Boat Trader runs one search per hull shape, and the combined total of states x hull shapes x engine configurations must stay at or below 200 searches per run — if you go over, the run stops straight away and tells you which list to shorten. When you set a result limit, it is shared out evenly between the searches. Note that Boat Trader publishes a hull shape on only a small share of listings, so this filter is narrow.", "items": { "type": "string", "enum": [ "modified-vee", "deep-vee", "pontoon", "tritoon", "flat", "monohull", "catamaran", "trimaran", "displacement", "semi-displacement", "planing", "rib", "sea-v2", "tunnel", "roll-up", "foldable", "other" ], "enumTitles": [ "Modified Vee", "Deep Vee", "Pontoon", "Tritoon", "Flat", "Monohull", "Catamaran", "Trimaran", "Displacement", "Semi-displacement", "Planing", "Rigid inflatable (RIB)", "Sea V2", "Tunnel", "Roll up", "Foldable", "Other" ] } }, "hullMaterials": { "title": "Hull Materials", "uniqueItems": true, "type": "array", "description": "What the hull is built from. Pick one or more, or leave empty for all materials.", "items": { "type": "string", "enum": [ "fiberglass+reinforced", "fiberglass--composite", "aluminum", "wooden", "steel", "hypalon", "plastic", "ferro-cement", "other" ], "enumTitles": [ "Fiberglass / Reinforced", "Fiberglass / Composite", "Aluminum", "Wooden", "Steel", "Hypalon", "Plastic / PVC", "Ferro-cement", "Other" ] } }, "engineConfigurations": { "title": "Engine Configurations", "uniqueItems": true, "type": "array", "description": "How many engines the boat has and how they are mounted. Pick one or more, or leave empty for all configurations. Boat Trader runs one search per configuration, and the combined total of states x hull shapes x engine configurations must stay at or below 200 searches per run — if you go over, the run stops straight away and tells you which list to shorten. When you set a result limit, it is shared out evenly between the searches.", "items": { "type": "string", "enum": [ "single+outboard", "twin+outboard", "triple+outboard", "single+inboard", "twin+inboard", "single+i--o", "twin+i--o", "triple+i--o", "jet+drive", "v+drive", "direct+drive", "none", "other" ], "enumTitles": [ "Single outboard", "Twin outboard", "Triple outboard", "Single inboard", "Twin inboard", "Single inboard/outboard", "Twin inboard/outboard", "Triple inboard/outboard", "Jet drive", "V-drive", "Direct drive", "No engine", "Other" ] } }, "minPrice": { "title": "Minimum Price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only show boats asking at least this much, in US dollars. Leave empty for no lower limit." }, "maxPrice": { "title": "Maximum Price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only show boats asking at most this much, in US dollars. Leave empty for no upper limit." }, "minYear": { "title": "Earliest Model Year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only show boats from this model year or later, for example 2015. Leave empty for any age." }, "maxYear": { "title": "Latest Model Year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only show boats from this model year or earlier. Leave empty for any age." }, "minLengthFt": { "title": "Minimum Length (feet)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Only show boats at least this long, in feet. Leave empty for no lower limit." }, "maxLengthFt": { "title": "Maximum Length (feet)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Only show boats at most this long, in feet. Leave empty for no upper limit." }, "states": { "title": "US States & Territories", "uniqueItems": true, "type": "array", "description": "Only show boats located in these states or territories. Pick as many as you like. Leave empty to search the whole country. Boat Trader runs one search per state, and the combined total of states x hull shapes x engine configurations must stay at or below 200 searches per run — if you go over, the run stops straight away and tells you which list to shorten. When you set a result limit, it is shared out evenly between the states you pick.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR", "VI" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "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", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "Puerto Rico", "US Virgin Islands" ] } }, "zipCode": { "title": "ZIP Code", "type": "string", "description": "A US ZIP code to search around, for example '33139'. Works together with Search Radius below. When you fill this in, the US States filter is ignored — Boat Trader searches around the ZIP instead. Leave empty to search by state or nationwide." }, "radiusMiles": { "title": "Search Radius (miles)", "enum": [ "0", "10", "25", "50", "75", "100", "200", "300", "500", "1000" ], "type": "string", "description": "How far around the ZIP code to look. Choose 'ZIP code only' to stay inside that ZIP. This is only used when a ZIP code is filled in above." }, "sortBy": { "title": "Sort Results By", "enum": [ "recommended", "price:asc", "price:desc", "year:desc", "year:asc", "length:asc", "length:desc" ], "type": "string", "description": "The order Boat Trader returns listings in. Combined with a result limit, this decides which boats you get, for example the 100 cheapest or the 100 newest." }, "includeDetails": { "title": "Include full listing details", "type": "boolean", "description": "When on, every boat comes back with its complete record: all engines with hours and horsepower, hull identification number (HIN), hull material and shape, beam, draft, weight and capacity, the full seller description, every photo, video links and all published seller phone numbers. Turn it off for a lightweight run that returns only the fields shown on the search result cards (make, model, year, price, length, location, seller, main photo). This never changes how many pages are requested, only how much data each page carries, so 'off' is faster on big runs but costs exactly the same number of requests." }, "maxResults": { "title": "Maximum Results", "minimum": 0, "maximum": 100000, "type": "integer", "description": "The most boats to return in total for the whole run, across every filter combination and every URL you provide. When your choices need several searches (one per state, hull shape or engine configuration), this total is shared out evenly between them, and any share that isn't used up is passed on to the searches that still have more to give. The scraper stops asking for new pages once the total is reached, so you may receive a handful of extra boats from the last page. Set to 0 for no limit — with no other filters that means every boat listed in the country, well over 100,000 results, billed accordingly, so add a state, boat class or price filter to keep a run predictable. Boat Trader itself only serves the first 10,000 results of any single search; when a search matches more than that, the scraper automatically splits it by state, then condition, then price band (three levels deep) to reach the rest, and tells you if some matches are still out of reach." } } }, "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 } } } } } } } } } }