{ "openapi": "3.0.1", "info": { "title": "Liquidation.com Auction Scraper: Bids, Closing Time & Monitor", "description": "Extract live liquidation.com wholesale lot auctions: seller, bid count, closing time, condition, lot size, and location for every pallet, package, or truckload matching your search. Runs with no residential proxy. Optional detail lookup and new-lot monitor mode. $0.01 per lot, JSON/CSV/Excel export.", "version": "0.1", "x-build-id": "30eJj3NgjMRAezazC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~liquidation-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-liquidation-com-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~liquidation-com-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-liquidation-com-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~liquidation-com-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-liquidation-com-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Free-text search terms (e.g. \"laptop\", \"power tools\"). Matched against lot titles and descriptions the same way the site's own search box works.", "default": [ "electronics" ], "items": { "type": "string" } }, "lotIds": { "title": "Specific Lot IDs", "type": "array", "description": "Exact liquidation.com auction IDs (the number in an auction URL, e.g. 21424760) to fetch directly, skipping search entirely. Useful for re-checking known lots. This entry mode has no equivalent in the main named competitor's scraper, which only accepts search terms, categories, conditions, and locations.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (advanced)", "type": "array", "description": "Paste full liquidation.com search or category URLs directly (copied from your browser's address bar) for full manual control over filters the form below doesn't expose. Leave empty to use Keywords/Categories/Filters instead.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categories": { "title": "Categories", "type": "array", "description": "Restrict results to one or more product categories.", "items": { "type": "string", "enum": [ "1001", "1002", "1003", "1004", "1005", "1006", "1011", "1045", "1133", "1201", "1600", "1700", "1800", "1900" ], "enumTitles": [ "Clothing & Accessories", "Computers & Networking", "Tools & Machinery", "Consumer Electronics", "General Merchandise", "Housewares & Lighting", "Jewelry & Watches", "Holiday & Seasonal", "Store Fixtures & Equipment", "Personal Protective Equipment (PPE)", "Furniture", "Appliances", "Health & Beauty", "Home Improvement" ] }, "default": [] }, "conditions": { "title": "Condition", "type": "array", "description": "Restrict results to one or more item conditions, e.g. only New or only Returns lots.", "items": { "type": "string", "enum": [ "10001", "10002", "10003", "10004", "10005", "10006", "10008" ], "enumTitles": [ "New", "Used", "Refurbished", "Returns", "Shelf Pulls", "Salvage", "Scratch and Dent" ] }, "default": [] }, "lotSizes": { "title": "Lot Size", "type": "array", "description": "Restrict results to a lot size: Package (small), Pallet, or Truckload.", "items": { "type": "string", "enum": [ "10901", "10902", "10903" ], "enumTitles": [ "Package", "Pallet", "Truckload" ] }, "default": [] }, "usRegions": { "title": "US Region", "type": "array", "description": "Restrict results to lots warehoused in one or more US regions.", "items": { "type": "string", "enum": [ "10101", "10102", "10103", "10104" ], "enumTitles": [ "Northeast", "Midwest", "West", "South" ] }, "default": [] }, "fetchLotDetails": { "title": "Fetch lot detail pages", "type": "boolean", "description": "When enabled, visits each lot's own detail page for its product description, condition note, minimum bid, buyer's premium percentage, total weight, shipping terms, number of pallets, and warehouse zip code. Roughly doubles the number of pages fetched per lot, so it is off by default.", "default": false }, "maxItems": { "title": "Max Lots", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of lots to collect in this run. Kept low by default so a default run finishes quickly; raise it for larger pulls.", "default": 20 }, "monitorMode": { "title": "Enable monitor mode", "type": "boolean", "description": "When enabled, this run only outputs lots whose auction ID was not seen in a previous run using the same monitor state name below. Combine with Apify's Scheduler to get only new lots matching your search on every run.", "default": false }, "monitorStateName": { "title": "Monitor State Name", "type": "string", "description": "A name identifying this saved search's state, so repeated scheduled runs know which lots were already reported. Use a different name for each distinct search you monitor. Only used when Monitor Mode is enabled.", "default": "liquidation-monitor-state" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "liquidation.com's Akamai bot defense is cleared by this Actor's browser fingerprint alone (confirmed live, no proxy needed), unlike the named competitor's scraper which requires residential proxies. Only enable a proxy here as a fallback if you see blocked or empty runs.", "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 } } } } } } } } } }