{ "openapi": "3.0.1", "info": { "title": "Purple Wave Auctions Scraper", "description": "Scrape Purple Wave no-reserve auction lots: photo, make, model, year, hours, VIN, bid or sold price and closing time. Export to CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "vb7ewgjS6ASus5cAg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~purple-wave-auctions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-purple-wave-auctions-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/parseforge~purple-wave-auctions-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-purple-wave-auctions-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/parseforge~purple-wave-auctions-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-purple-wave-auctions-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": "Purple Wave URLs", "type": "array", "description": "Purple Wave pages to read. An auction page (https://www.purplewave.com/auction/260916) returns every lot in that sale, a single lot page (https://www.purplewave.com/auction/260916/item/ET0375) returns just that lot, and a search page (https://www.purplewave.com/search/skid+steer) returns the whole result set. Any filters already in the URL are kept. Leave empty to read every open Purple Wave lot.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords searched on Purple Wave, one entry per search, for example \"skid steer\" or \"john deere tractor\". Each term is paginated in full and the results are merged with the URLs above.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "auctionStatus": { "title": "Auction status", "enum": [ "upcoming", "past", "all" ], "type": "string", "description": "Which lots to read. \"Open auctions\" covers the roughly 3,900 lots bidding right now and returns the live current bid. \"Closed auction results\" reads the sold archive (more than 720,000 lots) and returns the final contract price. \"Both\" merges the two.", "default": "upcoming" }, "yearsOfResults": { "title": "Years of closed results", "enum": [ "1", "2", "3", "5", "10" ], "type": "string", "description": "How far back the sold archive is read, counting back from the current year. Only used when the auction status includes closed results.", "default": "2" }, "industryCategories": { "title": "Industry categories", "type": "array", "description": "Keep only lots in these Purple Wave industry categories. Leave empty for every category.", "items": { "type": "string", "enum": [ "151", "348", "423", "1", "299", "340", "277", "203", "355", "256", "229" ], "enumTitles": [ "Ag Equipment", "Building Materials", "Business and Personal Property", "Construction Equipment", "Forestry and Logging Equipment", "Forklifts and Material Handling", "Passenger Vehicles, Boats and RVs", "Support Equipment", "Tools, Tires and Parts", "Trailers", "Trucks, Medium and Heavy Duty" ] } }, "states": { "title": "States", "type": "array", "description": "Keep only lots located in these U.S. states. Leave empty for 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" ] } }, "sortBy": { "title": "Sort order", "enum": [ "endtime-asc", "endtime-desc", "current_bid-desc", "current_bid-asc", "date_created-desc", "date_created-asc", "sortorder-asc" ], "type": "string", "description": "Order Purple Wave returns the lots in. Sorting by closing time first is the cheapest way to grab the lots that close soonest; sorting by current bid first grabs the biggest-ticket machines.", "default": "endtime-asc" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Purple Wave answers plain datacenter HTTP, so the proxy is off by default and the run costs nothing extra. Switch it on only if you scrape very large volumes and start seeing failures.", "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 } } } } } } } } } }