{ "openapi": "3.0.1", "info": { "title": "Boat Trader Scraper - Boat Listings, Specs, HIN & Dealer Phones", "description": "Scrape BoatTrader boats for sale: price and price drops, year, make, model, class, length, beam, hull, HIN, every engine with hours and horsepower, location with coordinates, dealer or private seller, dealer phones, photos, description, views and days on market. Dealer directory. No login.", "version": "0.1", "x-build-id": "uHIm6et2QSoU9rHPW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~boattrader-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-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/scrapersdelight~boattrader-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-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/scrapersdelight~boattrader-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-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": { "mode": { "title": "📋 What to collect", "enum": [ "listings", "dealers" ], "type": "string", "description": "Boat listings, or dealer-directory rows (name, phone, website, address, coordinates). Dealer rows use States, City, ZIP code, Makes and Keyword (as the dealer name).", "default": "listings" }, "startUrls": { "title": "🔗 BoatTrader URLs", "type": "array", "description": "Search pages (their filters are kept, e.g. /boats/type-power/class-power-pontoon/state-fl/), listing pages or bare listing numbers (e.g. 10330076), dealer inventory pages (/boats/dealer-...-61492/) and dealer-directory pages (/boat-dealers/state-fl/).", "items": { "type": "string" } }, "keyword": { "title": "🔎 Keyword", "type": "string", "description": "The site's keyword search, e.g. \"tower\" (1,864 US boats on 2026-10-14). In dealer mode: part of the dealer name, e.g. \"marinemax\"." }, "descriptionKeyword": { "title": "📝 Words in the description", "type": "string", "description": "Boats whose seller description mentions these words, e.g. \"tower\" (8,207 US boats on 2026-10-14) or \"twin diesel\"." }, "country": { "title": "🌎 Country", "enum": [ "US", "ALL", "MX", "PR", "ES", "IT", "FR", "VG", "TR", "VI", "PA", "GD", "DO", "NL", "BS", "SX", "TT", "MF", "GR", "LC", "AG", "CO", "DE", "AU", "FI", "MC", "MQ", "TW", "CN", "CR", "HR", "KY", "BR", "VE", "GP", "SG", "TH", "ME" ], "type": "string", "description": "BoatTrader lists 113,537 US boats and ~2,400 abroad (2026-10-14). \"All countries\" removes the country filter.", "default": "US" }, "states": { "title": "🗺️ US states", "type": "array", "description": "One search per state (the site filters one state at a time). Empty = the whole country.", "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" ], "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" ] } }, "city": { "title": "🏙️ City", "type": "string", "description": "A city in the one state picked above, e.g. \"Miami\" (1,703 boats). Several cities: separate them with commas." }, "zipCode": { "title": "📮 ZIP code", "type": "string", "description": "A US ZIP code to search around, e.g. \"33139\". Replaces the states filter. Every row then carries its distance in miles." }, "radiusMiles": { "title": "📏 Radius around the ZIP code", "enum": [ "exact", "10", "25", "50", "75", "100", "200", "300", "500", "1000", "any" ], "type": "string", "description": "How far around the ZIP code to look (33139: 25 mi = 5,246 boats, 100 mi = 10,279).", "default": "100" }, "boatType": { "title": "🚤 Boat type", "enum": [ "any", "power", "sail", "pwc", "small", "unpowered" ], "type": "string", "description": "The broadest category. PWC = personal watercraft; Small = dinghies, inflatables, RIBs, tenders, kayaks.", "default": "any" }, "boatClasses": { "title": "🏷️ Boat classes", "type": "array", "description": "Any of the site's 90 classes, e.g. Pontoon (16,988 boats), Center Console (19,176), Sloop. Several = boats in any of them.", "items": { "type": "string", "enum": [ "power-pontoon", "power-center", "power-bowrider", "power-bass", "power-aluminum", "power-cruiser", "power-pwc", "power-skiwake", "power-jon", "power-motor", "power-bay", "power-deck", "power-jet", "power-saltfish", "power-expresscruiser", "power-runabout", "power-other", "power-dualconsole", "sail-cruiser", "power-sportfish", "power-unspec", "power-fresh", "power-trawler", "power-util", "power-sportcruiser", "power-flybridge", "power-skifish", "power-rib", "power-pcatamaran", "power-cuddy", "sail-racercruiser", "power-skiff", "sail-sloop", "power-flats", "power-highperf", "power-downeast", "power-pilot", "power-walk", "power-convertible", "sail-catamaran", "power-house", "power-aft", "power-inflatable", "power-tender", "power-antique", "sail-day", "sail-centercockpit", "unpowered-kayak", "power-surfboat", "sail-racer", "sail-cutter", "sail-multihull", "power-barge", "power-commercial", "power-dinghy", "power-tug", "sail-ketch", "sail-antique", "power-passenger", "power-mega", "sail-motor", "sail-trimaran", "sail-pilot", "power-superyacht", "sail-other", "power-motorsailer", "sail-yawl", "sail-performance", "sail-schooner", "power-crossover", "power-lobster", "unpowered-dinghy", "power-rivercruiser", "power-sloop", "sail-deck", "unpowered-tender", "power-dive", "sail-dinghy", "power-airboat", "power-multihull", "sail-beachcat", "sail-commercial", "power-expeditionyacht", "power-cruiseship", "sail-unspec", "power-narrow", "power-dragger", "power-supportvessel", "power-troller", "sail-barge" ], "enumTitles": [ "Power - Pontoon", "Power - Center Console", "Power - Bowrider", "Power - Bass", "Power - Aluminum Fishing", "Power - Cruisers", "PWC - All PWCs", "Power - Ski and Wakeboard", "Power - Jon", "Power - Motor Yachts", "Power - Bay", "Power - Deck", "Power - Jet", "Power - Saltwater Fishing", "Power - Express Cruiser", "Power - Runabout", "Power - Other", "Power - Dual Console", "Sail - Cruisers", "Power - Sport Fishing", "Power - Unspecified", "Power - Freshwater Fishing", "Power - Trawler", "Power - Utility", "Power - Sports Cruiser", "Power - Flybridge", "Power - Ski and Fish", "Small - Rigid Inflatable", "Power - Power Catamarans", "Power - Cuddy Cabin", "Sail - Racer/Cruiser", "Power - Skiff", "Sail - Sloop", "Power - Flats", "Power - High Performance", "Power - Downeast", "Power - Pilothouse", "Power - Walkaround", "Power - Convertible", "Sail - Catamaran", "Power - Houseboat", "Power - Aft Cabin", "Small - Inflatable", "Small - Tender (Power)", "Power - Antique and Classic", "Sail - Daysailer", "Sail - Center Cockpit", "Small - Canoe/Kayak", "Power - Surf Boats", "Sail - Racing", "Sail - Cutter", "Sail - Multihull", "Power - Barge", "Power - Commercial", "Small - Dinghy (Power)", "Power - Tug", "Sail - Ketch", "Sail - Antique and Classic", "Power - Passenger", "Power - Mega Yachts", "Sail - Motorsailer", "Sail - Trimaran", "Sail - Pilothouse", "Power - Superyachts", "Sail - Other", "Power - Motorsailer", "Sail - Yawl", "Sail - Performance", "Sail - Schooner", "Power - Crossover Boats", "Power - Lobster", "Small - Dinghy (Unpowered)", "Power - River Cruiser", "Power - Sloop", "Sail - Deck Saloon", "Small - Tender (Unpowered)", "Power - Dive", "Small - Dinghy (Sail)", "Power - Airboat", "Power - Multihull", "Sail - Beach Catamaran", "Sail - Commercial", "Power - Expedition Yachts", "Power - Cruise Ships", "Sail - Unspecified", "Small - Narrowboats", "Power - Dragger", "Power - Support Vessels", "Power - Troller", "Sail - Barge" ] } }, "boatGroup": { "title": "🎣 Activity", "enum": [ "any", "fishing-boats", "day-cruising-boats", "overnight-cruising-boats", "long-range-cruising-boats", "watersports", "commercial-boats", "sailing-boats", "lakes-and-rivers-boats", "pleasure-boats", "yachts-for-sale" ], "type": "string", "description": "The site's activity groups (each a set of classes). Replaces Boat type and Boat classes when set.", "default": "any" }, "makes": { "title": "🏭 Makes / models", "type": "array", "description": "Brand names as BoatTrader shows them, e.g. \"Sea Ray\", \"Boston Whaler\", \"Grady-White\"; add a model after a colon, e.g. \"Sea Ray:Sundancer 320\". All in one search.", "items": { "type": "string" } }, "condition": { "title": "✨ Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "New, used or both.", "default": "any" }, "minPrice": { "title": "💲 Min price (USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Lowest asking price in US dollars. 0 = no minimum.", "default": 0 }, "maxPrice": { "title": "💲 Max price (USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Highest asking price in US dollars. 0 = no maximum.", "default": 0 }, "minYear": { "title": "📅 Min model year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Earliest model year, e.g. 2015. 0 = any.", "default": 0 }, "maxYear": { "title": "📅 Max model year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Latest model year. 0 = any.", "default": 0 }, "minLength": { "title": "📐 Min length (ft)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Shortest boat in feet. 0 = any.", "default": 0 }, "maxLength": { "title": "📐 Max length (ft)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Longest boat in feet. 0 = any.", "default": 0 }, "fuelTypes": { "title": "⛽ Fuel", "type": "array", "description": "Several = boats with any of them.", "items": { "type": "string", "enum": [ "gasoline", "diesel", "electric", "other" ], "enumTitles": [ "Gas", "Diesel", "Electric", "Other" ] } }, "hullMaterials": { "title": "🧱 Hull material", "type": "array", "description": "Several = boats with any of them.", "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", "Ferro-cement", "Other" ] } }, "hullShapes": { "title": "🔺 Hull shape", "type": "array", "description": "One search per shape (the site takes one at a time). Sellers publish a shape on ~58% of listings, so this narrows sharply.", "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", "RIB", "Sea V2", "Tunnel", "Roll up", "Foldable", "Other" ] } }, "engineTypes": { "title": "⚙️ Engine set-up", "type": "array", "description": "One search per set-up (the site takes one at a time).", "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" ] } }, "numberOfEngines": { "title": "🔢 Number of engines", "minimum": 0, "maximum": 10, "type": "integer", "description": "Exactly this many engines, e.g. 2 (23,703 US boats). 0 = any.", "default": 0 }, "sellerType": { "title": "🤝 Seller", "enum": [ "any", "dealer", "owner" ], "type": "string", "description": "Dealers and brokers (104,525 US boats) or private sellers (9,011).", "default": "any" }, "priceDropOnly": { "title": "📉 Price dropped in the last 30 days", "type": "boolean", "description": "Only boats whose price was cut in the last 30 days (the site's \"Price drop\" filter).", "default": false }, "sortBy": { "title": "↕️ Sort", "enum": [ "recommended", "newest", "oldest", "price-asc", "price-desc", "year-desc", "year-asc", "length-desc", "length-asc", "nearest" ], "type": "string", "description": "The order the site returns boats in. With a result limit this decides which boats you get.", "default": "recommended" }, "withPhoneOnly": { "title": "📞 Only rows with a phone", "type": "boolean", "description": "Skip listings without a dealer phone (private-seller listings never carry one) and dealers without a phone.", "default": false }, "maxEngineHours": { "title": "⏱️ Max engine hours", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only boats whose engine hours are published and at most this, e.g. 300. 0 = no limit.", "default": 0 }, "includeDetails": { "title": "📊 Add views, saves & days on market", "type": "boolean", "description": "Reads each listing's own record: views, saves, days on market, dealer website, dealer active/sold listing counts, trusted-partner badge, overview and the site's owner-review summary. Slower; no extra charge.", "default": false }, "includePhotos": { "title": "🖼️ Photo and video URLs", "type": "boolean", "description": "Every photo URL per listing (up to 150; video URLs come with details). Off = lighter rows without images.", "default": true }, "monitorMode": { "title": "🔁 Only new or price-changed", "type": "boolean", "description": "Deliver (and charge) only listings this monitor has not delivered before, or whose price changed since (changeType NEW / PRICE_CHANGED, previousPrice).", "default": false }, "monitorStoreName": { "title": "🗂️ Monitor name", "type": "string", "description": "Name of the memory kept between runs. Use one name per schedule, e.g. \"fl-pontoons\". Empty = \"boattrader-monitor\"." }, "maxResults": { "title": "🔢 Max results", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Most rows for the whole run (listings and dealers). 0 = no limit (113,537 US boats on 2026-10-14).", "default": 100 }, "maxResultsPerSearch": { "title": "🔢 Max results per search", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap for each search (each state, hull shape, engine set-up or URL). 0 = only the overall cap.", "default": 0 }, "splitLargeSearches": { "title": "🪓 Go past 10,000 per search", "type": "boolean", "description": "The site serves at most 10,000 boats per search. On: bigger searches are split by state, condition, model year and length, ids deduplicated.", "default": true }, "compact": { "title": "🗜️ Compact rows", "type": "boolean", "description": "Core fields only (31 for listings, 10 for dealers) - for spreadsheets, AI agents and MCP.", "default": false }, "maxConcurrency": { "title": "⚡ Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Detail and lookup requests in flight at once.", "default": 4 }, "proxyConfiguration": { "title": "🛡️ Proxy", "type": "object", "description": "Not needed: the actor starts on a direct connection and moves to its own fallback routes only if the site refuses it. Your own proxy URLs are tried first.", "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 }, "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 } } } } } } } } } }