{ "openapi": "3.0.1", "info": { "title": "HiBid Scraper: Live Auction Bids, Lot Data & Closed Sale Prices", "description": "Scrape live and closed auction lots from HiBid.com. Get current bids, high and low bid amounts, final hammer prices, bid counts, time remaining, buyer premiums, reserve status, and appraisal estimates for every lot, direct from HiBid auctioneers across the US and Canada. No login required.", "version": "0.2", "x-build-id": "zejkLzppFWGzymv7Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~hibid-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-hibid-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~hibid-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-hibid-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~hibid-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-hibid-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Product keywords (e.g. 'laptop', 'furniture'). Leave empty if using direct Start URLs.", "default": [ "laptop" ] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct category or search page links (e.g. 'https://florida.hibid.com/lots/?query=laptop'). Overrides queries.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "region": { "title": "Unblocked regional gateway", "enum": [ "FLORIDA", "TEXAS", "ONTARIO", "GLOBAL" ], "type": "string", "description": "Select the unblocked regional subdomain. Pinned regional routes have relaxed WAF settings and bypass Cloudflare instantly.", "default": "FLORIDA" }, "lowPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include lots with a current bid at or above this value. 0 = no minimum.", "default": 0 }, "highPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include lots with a current bid at or below this value. 0 = no maximum.", "default": 0 }, "lotType": { "title": "Lot filter", "enum": [ "ALL", "ONLINE", "CLOSING", "FEATURED" ], "type": "string", "description": "Filter by HiBid's `filter` URL param. ONLINE = online-only lots, CLOSING = lots ending soon, FEATURED = highlighted lots.", "default": "ONLINE" }, "auctionStatus": { "title": "Auction status", "enum": [ "ALL", "OPEN", "CLOSING", "CLOSED" ], "type": "string", "description": "Filter by HiBid's `status` URL param. OPEN = currently bidding, CLOSING = ending in <24h, CLOSED = auction ended.", "default": "OPEN" }, "includeArchived": { "title": "Include archived (closed) lots for sold comps", "type": "boolean", "description": "Pull closed/archived lots so you get final hammer (realized) prices for sold comps. When on, the scraper targets HiBid's closed archive unless you have set a specific auction status above.", "default": false }, "onlyClosedLots": { "title": "Only closed lots", "type": "boolean", "description": "Keep only lots that have finished bidding. Open and closing lots are dropped from the output.", "default": false }, "onlyWithRealizedPrice": { "title": "Only lots with a realized price", "type": "boolean", "description": "Keep only sold lots that expose a final hammer (realized) price. Lots that did not sell, or whose price is not published, are dropped. Nothing is ever faked.", "default": false }, "closedAfter": { "title": "Closed after", "type": "string", "description": "Only include lots that closed on or after this date (e.g. 2026-01-01). Lots with no close date are dropped when a window is set. Leave empty for no lower bound." }, "closedBefore": { "title": "Closed before", "type": "string", "description": "Only include lots that closed on or before this date (e.g. 2026-06-30, inclusive of the whole day). Leave empty for no upper bound." }, "maxItems": { "title": "Maximum results", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Maximum number of lots to output per search. Defaults to 100.", "default": 25 }, "debugLogging": { "title": "Verbose debug logs", "type": "boolean", "description": "Print granular tracing tags (API, FETCH, EMIT) to the run logs.", "default": false }, "proxyConfiguration": { "title": "Proxy setup", "type": "object", "description": "US Residential proxy is the verified default for reliable public HiBid results. Requests use a small JSON payload, keeping proxy bandwidth low.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }