{ "openapi": "3.0.1", "info": { "title": "Nettivene Scraper: Finland Boats, Sailboats, Jet Skis, Engines", "description": "Scrape nettivene.com, the Finnish boat marketplace: motor boats, sailboats, jet skis, engines and 20 more types with prices, make, model, year, length, engine hours and power, photos, seller type, plus the sold archive and 235 dealers. No login, no proxy. Export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "cwEWMZ3OzL2O42oKE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~nettivene-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-nettivene-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/recordsdata~nettivene-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-nettivene-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/recordsdata~nettivene-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-nettivene-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": [ "search", "urls", "dealers" ], "type": "string", "description": "search = boat listings for the filters below (one row per ad). urls = ad, dealer-inventory, saved-search or newest-ads addresses (or ad numbers) you provide, always with full detail. dealers = the boat-dealer directory (one row per company).", "default": "search" }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops after this many rows (all record types together). Free plans are limited to 10 items per run.", "default": 50 }, "boatTypes": { "title": "Boat types", "type": "array", "description": "Which kinds of boat to read. Empty means motor boats. Pick \"All boat types\" to search the whole site (sailboats, jet skis, engines, rowing boats, kayaks and the rest). Each type is searched on its own, one after another.", "items": { "type": "string", "enum": [ "all", "motor-boat", "sailboat", "jet-ski", "engine", "rowing-boat", "inflatable-boat", "rib-boat", "motor-yacht", "catamaran", "trimaran", "work-boat", "fishing-boat", "trawler", "canoe", "kayak", "dinghy", "pedal-boat", "surfboard", "sauna-raft", "houseboat", "hovercraft", "hydrocopter", "hydrofoil", "ice-yacht" ], "enumTitles": [ "All boat types", "Motor boat", "Sailboat", "Jet ski / personal watercraft", "Boat engine (outboard, inboard, electric)", "Rowing boat", "Inflatable boat", "RIB (rigid inflatable boat)", "Motor yacht", "Catamaran", "Trimaran", "Work boat", "Fishing boat", "Trawler", "Canoe", "Kayak", "Dinghy / yawl", "Pedal boat", "Surfboard", "Sauna raft", "Houseboat", "Hovercraft", "Hydrocopter", "Hydrofoil craft", "Ice yacht" ] }, "default": [ "motor-boat" ] }, "listingStatus": { "title": "Listing status", "enum": [ "for-sale", "sold" ], "type": "string", "description": "for-sale = ads that are live now. sold = ads the seller marked as sold (kept in the site archive; the asking price is no longer shown, so sold rows have no price).", "default": "for-sale" }, "makes": { "title": "Makes", "type": "array", "description": "Optional. One or more boat makes as nettivene.com writes them, for example Buster, Yamarin, Finnmaster, Bavaria, Sea-Doo. Common short names such as HR for Hallberg-Rassy are understood; an unknown name returns close matches. Empty means every make. For engine ads this is the engine make. Several makes cannot be combined with models.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Optional. Models of the single make above, for example 4902 CLX. Needs exactly one make. Empty means every model of the make.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Optional. Regions (maakunta) of Finland to search in. Empty means all of Finland. In dealer mode it narrows the dealer directory.", "items": { "type": "string", "enum": [ "Ahvenanmaa", "Etelä-Karjala", "Etelä-Pohjanmaa", "Etelä-Savo", "Kainuu", "Kanta-Häme", "Keski-Pohjanmaa", "Keski-Suomi", "Kymenlaakso", "Lappi", "Pirkanmaa", "Pohjanmaa", "Pohjois-Karjala", "Pohjois-Pohjanmaa", "Pohjois-Savo", "Päijät-Häme", "Satakunta", "Uusimaa", "Varsinais-Suomi", "Outside Finland" ], "enumTitles": [ "Ahvenanmaa", "Etelä-Karjala", "Etelä-Pohjanmaa", "Etelä-Savo", "Kainuu", "Kanta-Häme", "Keski-Pohjanmaa", "Keski-Suomi", "Kymenlaakso", "Lappi", "Pirkanmaa", "Pohjanmaa", "Pohjois-Karjala", "Pohjois-Pohjanmaa", "Pohjois-Savo", "Päijät-Häme", "Satakunta", "Uusimaa", "Varsinais-Suomi", "Outside Finland" ] } }, "towns": { "title": "Towns", "type": "array", "description": "Optional. Towns inside the single region chosen above, for example Espoo or Helsinki. Needs exactly one region in search mode.", "items": { "type": "string" } }, "minYear": { "title": "Minimum model year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Optional. Oldest model year. 0 means no limit." }, "maxYear": { "title": "Maximum model year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Optional. Newest model year. 0 means no limit." }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Optional. Lowest asking price in euros. 0 means no limit." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Optional. Highest asking price in euros. 0 means no limit." }, "minLength": { "title": "Minimum length (m)", "minimum": 0, "maximum": 200, "type": "number", "description": "Optional. Shortest boat length in metres, for example 4.5. 0 means no limit." }, "maxLength": { "title": "Maximum length (m)", "minimum": 0, "maximum": 200, "type": "number", "description": "Optional. Longest boat length in metres, for example 9. 0 means no limit." }, "minWidth": { "title": "Minimum width (m)", "minimum": 0, "maximum": 60, "type": "number", "description": "Optional. Narrowest beam in metres, for example 2. 0 means no limit." }, "maxWidth": { "title": "Maximum width (m)", "minimum": 0, "maximum": 60, "type": "number", "description": "Optional. Widest beam in metres, for example 3. 0 means no limit." }, "minWeight": { "title": "Minimum weight (kg)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Optional. Lightest boat in kilograms. 0 means no limit." }, "maxWeight": { "title": "Maximum weight (kg)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Optional. Heaviest boat in kilograms. 0 means no limit." }, "minDraft": { "title": "Minimum draft (m)", "minimum": 0, "maximum": 30, "type": "number", "description": "Optional. Shallowest draft in metres, for example 0.3. 0 means no limit." }, "maxDraft": { "title": "Maximum draft (m)", "minimum": 0, "maximum": 30, "type": "number", "description": "Optional. Deepest draft in metres, for example 1.5. 0 means no limit." }, "minBerths": { "title": "Minimum berths", "minimum": 0, "maximum": 200, "type": "integer", "description": "Optional. Fewest sleeping places. 0 means no limit." }, "maxBerths": { "title": "Maximum berths", "minimum": 0, "maximum": 200, "type": "integer", "description": "Optional. Most sleeping places. 0 means no limit." }, "hullMaterials": { "title": "Hull materials", "type": "array", "description": "Optional. Keep only these hull materials. Empty means any.", "items": { "type": "string", "enum": [ "aluminium", "concrete", "carbon-fibre", "fibreglass", "plastic", "wood", "steel" ], "enumTitles": [ "Aluminium", "Concrete", "Carbon fibre", "Fibreglass", "Plastic", "Wood", "Steel" ] } }, "subTypes": { "title": "Boat styles", "type": "array", "description": "Optional. Keep only these styles (the site calls it \"Laji\": cruiser, day cruiser, cabin boat, open console and so on). Each style exists for a few boat types only. Empty means any.", "items": { "type": "string", "enum": [ "bowrider", "cabin", "day-cruiser", "lightweight", "racing", "cruiser-racer", "cruiser", "other", "open-console", "pilot-house", "sailing-trawler", "wooden-boat", "rowing-motor", "rowing", "windshield" ], "enumTitles": [ "Bowrider", "Cabin boat", "Day cruiser", "Lightweight boat", "Racing boat", "Cruiser / racer", "Cruiser", "Other boat", "Open / console", "Pilot house boat", "Sailing trawler", "Wooden boat", "Rowing / motor boat", "Rowing boat", "Windshield boat" ] } }, "engineMakes": { "title": "Engine makes", "type": "array", "description": "Optional. Engine makes as nettivene.com writes them, for example Yamaha, Mercury, Suzuki, Volvo Penta, Yanmar. An unknown name returns close matches. Empty means any.", "items": { "type": "string" } }, "engineTypes": { "title": "Engine types", "type": "array", "description": "Optional. Where the engine sits: outboard, inboard, stern drive, electric motor or water jet. Empty means any.", "items": { "type": "string", "enum": [ "outboard", "inboard", "stern-drive", "electric", "water-jet" ], "enumTitles": [ "Outboard", "Inboard", "Stern drive", "Electric motor", "Water jet" ] } }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Optional. Keep only these fuels. Empty means any.", "items": { "type": "string", "enum": [ "petrol", "diesel", "gas", "electric" ], "enumTitles": [ "Petrol", "Diesel", "Gas", "Electric" ] } }, "engineStrokes": { "title": "Engine strokes", "type": "array", "description": "Optional. Two-stroke or four-stroke engines. Empty means any.", "items": { "type": "string", "enum": [ "2-stroke", "4-stroke" ], "enumTitles": [ "2-stroke", "4-stroke" ] } }, "minEnginePower": { "title": "Minimum engine power (hp)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Optional. Lowest engine power in horsepower. 0 means no limit." }, "maxEnginePower": { "title": "Maximum engine power (hp)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Optional. Highest engine power in horsepower. 0 means no limit." }, "minEngineHours": { "title": "Minimum engine hours", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Optional. Lowest engine-hour reading. 0 means no limit." }, "maxEngineHours": { "title": "Maximum engine hours", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Optional. Highest engine-hour reading. 0 means no limit." }, "minEngineYear": { "title": "Minimum engine year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Optional. Oldest engine model year. 0 means no limit." }, "maxEngineYear": { "title": "Maximum engine year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Optional. Newest engine model year. 0 means no limit." }, "withoutEngine": { "title": "Boats sold without an engine", "type": "boolean", "description": "On: only boats advertised without an engine (hull and trailer packages). Cannot be combined with engine filters.", "default": false }, "accessories": { "title": "Equipment", "type": "array", "description": "Optional. Keep only boats whose ad lists all of these items (autopilot, GPS, trailer, VHF and so on). The ad page is checked, so leave \"Read ad pages\" on. Empty means any.", "items": { "type": "string", "enum": [ "autopilot", "gps", "refrigerator", "echo-sounder", "railings", "chartplotter", "inspected", "engine-remote-control", "stove", "bow-thruster", "compass", "navigation-lights", "canopy", "log", "shore-power", "mattresses", "life-raft", "life-jackets", "sauna", "stereo", "shower", "trailer", "radar", "cushions", "swim-ladder", "fishing-gear", "vhf", "toilet" ], "enumTitles": [ "Autopilot", "Gps", "Refrigerator", "Echo sounder", "Railings", "Chartplotter", "Inspected", "Engine remote control", "Stove", "Bow thruster", "Compass", "Navigation lights", "Canopy", "Log", "Shore power", "Mattresses", "Life raft", "Life jackets", "Sauna", "Stereo", "Shower", "Trailer", "Radar", "Cushions", "Swim ladder", "Fishing gear", "Vhf", "Toilet" ] } }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Optional. dealer = boat dealers only. private = private persons only (flagged with isPrivateSeller, never named, no contact details). any means both.", "default": "any" }, "onlyWithPrice": { "title": "Only ads with a price", "type": "boolean", "description": "On: leave out ads that state no asking price (\"price on request\").", "default": false }, "maxAgeDays": { "title": "Updated within", "enum": [ "any", "1", "3", "7", "14", "28" ], "type": "string", "description": "Optional. Keep only ads created or changed within this many days.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest", "price-asc", "price-desc", "year-desc", "year-asc", "make-model-asc", "make-model-desc" ], "type": "string", "description": "Order of the results. Newest first is the default and the best choice for monitoring.", "default": "newest" }, "startUrls": { "title": "Addresses", "type": "array", "description": "Ad addresses (https://www.nettivene.com/moottorivene/buster/1234567), dealer pages (https://www.nettivene.com/yritys/1234), saved-search results (https://www.nettivene.com/hakutulokset?haku=...) or the newest ads (https://www.nettivene.com/uusimmat).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingIds": { "title": "Ad numbers", "type": "array", "description": "Ad numbers (the number at the end of an ad address), for example 1055080.", "items": { "type": "string" } }, "dealerIds": { "title": "Dealer numbers", "type": "array", "description": "Dealer numbers (the number in a dealer page address, https://www.nettivene.com/yritys/1234). Empty means walk the directory with the regions and towns above.", "items": { "type": "string" } }, "dealerQuery": { "title": "Dealer name search", "type": "string", "description": "Optional. Keep only dealers whose name contains these words, for example \"Marine\".", "default": "" }, "fetchDetails": { "title": "Read ad pages", "type": "boolean", "description": "On (default): every ad page is read for the full record (description, equipment, size, engine block, seller, update date, dealer address) and billed as a detail record. Off: only the list card is read (title, price, year, engine line, city, photos), billed as a standard record. For dealers: on adds the profile (website, logo, description, address).", "default": true }, "includeContactDetails": { "title": "Dealer contact details (phone, texts)", "type": "boolean", "description": "Off (default): phone numbers and e-mail addresses written into dealer texts are replaced by a marker and no phone is read. On: dealer texts are kept as written, ad rows of dealers get sellerPhone and dealer rows get phone, the business line behind the call button (one extra request each). Named sales people and private persons never get contact data, whatever this says.", "default": false }, "includeRaw": { "title": "Include raw data", "type": "boolean", "description": "Adds a \"raw\" column with the unprocessed data blocks of the site (list card and ad page analytics data).", "default": false }, "onlyNew": { "title": "Only new listings (monitor mode)", "type": "boolean", "description": "Schedule the Actor and receive only ads you have not been given before. The first run returns everything and builds the memory. Use together with sort \"Newest first\".", "default": false }, "stateKey": { "title": "Monitor label", "type": "string", "description": "Optional name of the monitor memory. Same label plus same filters = same memory. Empty derives the label from the filters.", "default": "" }, "resetSeen": { "title": "Reset monitor memory", "type": "boolean", "description": "Forget everything seen before and start the memory again. Use after changing what you want to track.", "default": false }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 4, "type": "integer", "description": "Ad pages read at the same time. The site answers slowly; 2 is the polite default.", "default": 2 }, "maxScanSeconds": { "title": "Time limit (seconds)", "minimum": 10, "maximum": 86400, "type": "integer", "description": "Stops reading after this many seconds and delivers what was collected.", "default": 3000 } } }, "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 } } } } } } } } } }