{ "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.1", "x-build-id": "odHbrMh47x5BU8n6C" }, "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" }, "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 } } } } } } } } } }