{ "openapi": "3.0.1", "info": { "title": "YachtWorld Scraper: Boats, Prices & Broker Contacts", "description": "Extract real YachtWorld boat listings: price, price drops, location, seller, and optional full specs (engine, power, length, year) and broker contact info. Structured filters for boat type, condition, and manufacturer. Optional monitor mode alerts on price or sale-pending changes.", "version": "0.1", "x-build-id": "1orvYwPo9aY6wPmU5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~yachtworld-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-yachtworld-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/getascraper~yachtworld-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-yachtworld-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/getascraper~yachtworld-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-yachtworld-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": { "boatType": { "title": "Boat type", "enum": [ "", "power", "sail" ], "type": "string", "description": "Only return power or sail boats. The named competitor Actor makes you know its raw param name for this; here it's a plain dropdown.", "default": "" }, "condition": { "title": "Condition", "enum": [ "", "new", "used" ], "type": "string", "description": "Only return new or used boats.", "default": "" }, "make": { "title": "Manufacturer", "type": "string", "description": "Only return boats from this manufacturer. Pick a common one below, or type any manufacturer slug from a YachtWorld URL you've visited, since this list is a helpful starting point, not the full catalog.", "default": "" }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Visit each listing's own page for engine, power, hours, class, length, year, model, description, and broker contact info. Off by default since it costs one extra page load per listing; the search-result card already has title, price, location, and seller name.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional extra search or listing pages to scrape, on top of any filters set above. Paste any YachtWorld search-result or boat-detail URL if you already know the exact page you want.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "This Actor clears YachtWorld's bot protection without a proxy, so the default is off, which is the cheapest and fastest option. Turn on a proxy only if a run starts failing to load pages.", "default": { "useApifyProxy": false } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum number of listings to return in this run. Each page needs a real browser to clear the site's bot check, so keep this modest for a quick, low-cost run.", "default": 20 }, "onlyNewOrChanged": { "title": "Incremental monitor mode", "type": "boolean", "description": "Only return listings that are new or whose price or sale-pending status changed since your last run with the same monitor state name. Pair with an Apify schedule to watch a search for price drops or listings going under offer.", "default": false }, "stateName": { "title": "Monitor state name", "type": "string", "description": "Name for this run's incremental state, used only when incremental monitor mode is on. Use different names to track separate searches independently.", "default": "default" } } }, "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 } } } } } } } } } }