# AuctionNinja Scraper: Estate Sales & Online Auctions (`getascraper/auctionninja-scraper`) Actor Scrape estate sales and online auctions from AuctionNinja.com. Extract lot details, current bids, bidding counts, conditions, descriptions, buyer premiums, times remaining, images, and locations site-wide without proxies. - **URL**: https://apify.com/getascraper/auctionninja-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 lot scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does AuctionNinja Scraper do? Get current online auctions and estate sale listings from AuctionNinja.com: lot details, current high bids, bidding counts, condition grades, hosting company names, and image URLs, ready for your spreadsheet in under 60 seconds. This scraper connects directly to the platform, meaning no login or complex proxies are required to get 100% fresh, real-time pricing data. Built for vintage resellers, estate appraisers, antique collectors, and liquidators. ### Why use AuctionNinja Scraper? - **I am a vintage reseller** tracking hot bids on mid-century modern furniture, art, and designer goods to secure high-demand stock at local pick-up estate sales. - **I am an estate appraiser** compiling real-time resale pricing data to value antique collections, home estates, and business liquidations accurately. - **I am an antique collector** monitoring bidding activity on specific rare lots (jewelry, sterling silver, porcelain, toys) across multiple auctions simultaneously. - **I am a liquidation analyst** watching closing times and bidding patterns to understand supply volume, average lot values, and final sale prices. - **I am an e-commerce store owner** sourcing unique home decor inventory from estate liquidations and keeping our pricing aligned with secondary market demand. ### How to use AuctionNinja Scraper 1. Create a free Apify account (no credit card needed). 2. Open the AuctionNinja Scraper in the Apify Console. 3. Paste one or more direct Auction Details links (e.g. `/sales/details/...`). 4. Set optional filters for price range, specific seller company, or max results limit. 5. Click **Start** and download your structured lot catalog as CSV, Excel, or JSON. ### Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `startUrls` | array of URLs | Yes | Direct Auction Details links (e.g. `https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html`). | | `searchQueries` | array of strings | No | Fuzzy-match search keywords to filter or map. Bypassed if Start URLs are provided. | | `minPrice` | integer | No | Only include lots with a current bid at or above this value. 0 = no minimum. | | `maxPrice` | integer | No | Only include lots with a current bid at or below this value. 0 = no maximum. | | `sellerFilter` | string | No | Restrict listings to a specific estate-sale company slug (e.g. `clearinghouseestatesales`). | | `scrapeDetails` | boolean | No | Fetch individual lot detail pages in parallel for rich specifications (descriptions, condition grades, buyer premiums, and bid counts). Slower. Defaults to false. | | `maxItems` | integer | No | Maximum number of lots to output per auction. Defaults to 100. | | `maxConcurrency` | integer | No | Maximum parallel requests (1-20). Higher is faster. Defaults to 5. | | `debugLogging` | boolean | No | Print detailed tags (CATEGORY, DETAIL, EMIT) to the run log. Defaults to false. | | `proxyConfiguration` | object | No | Proxy settings. Not needed by default. | ### Output A structured dataset of auction items with lot numbers, current bidded prices, time remaining, condition grades, and primary photo links. Free users get up to 50 results per run, paid plans scale to 1,000,000. ```json { "productID": "2424786", "title": "Beautiful Soft Black & Cream Toned Rug", "price": 1, "currency": "USD", "lotNumber": "Lot #: 1", "condition": "Unknown", "timeLeft": "8 hours 29 minutes left", "bidCount": 0, "buyerPremium": "", "sellerName": "", "sellerLocation": "", "imageUrl": "https://www.pictureserver1.auctionninja.com/pictureserver/clearinghouseestatesales/Pictures/Thumbs/IMG_0054_21_2331288_1780840793472.jpg", "description": "", "listingUrl": "https://www.auctionninja.com/clearinghouseestatesales/product/beautiful-soft-black-cream-toned-rug-2424786.html", "categories": [], "scrapedAt": "2026-06-14T15:38:08.991Z" } ```` ### Data table | Field | Type | Description | | --- | --- | --- | | `productID` | string | Unique AuctionNinja item product identifier (7-character numeric). | | `title` | string | Full title of the auction lot. | | `price` | number | Current high bid amount in USD. | | `currency` | string | Currency code, always USD. | | `lotNumber` | string | Display lot number (e.g. `Lot #: 15`). | | `condition` | string | Physical condition grade (e.g. `Very Good`, `Excellent`, `Fair`). | | `timeLeft` | string | Relative time remaining for bidding (e.g. `8 hours 35 minutes left`). | | `bidCount` | number | Total number of bids placed. | | `buyerPremium` | string | Extra buyer fee percentage (e.g. `18%`). | | `sellerName` | string | Display name of the estate-sale hosting company. | | `sellerLocation` | string | City and state the item is located in (e.g. `Raleigh, NC`). | | `imageUrl` | string | Primary lot image URL. | | `description` | string | Full seller specifications and dimensions. | | `listingUrl` | string | Canonical link to the item bidding page on AuctionNinja. | | `categories` | array | Nested category tags assigned by the app. | | `scrapedAt` | string | ISO 8601 timestamp of when the row was scraped. | ### Pricing The Actor costs **$4.99 per 1,000 results**. A typical run extracting 100 lots from an estate sale costs about $0.50. No proxy bandwidth is needed, so your run costs stay at the absolute minimum. ### Tips or advanced options - **Fetch index pages by default for extreme speed.** By keeping `scrapeDetails: false` (the default), the Actor extracts all lot titles, prices, images, and lot numbers straight from the catalog list. This is 10x faster and gets 90% of the data in under 5 seconds! - **Enable detail enrichment for full appraisal specifications.** Turn on `scrapeDetails: true` if you require detailed condition grades, buyer premiums, full text descriptions, and precise bid counts. This will crawl every lot bidding page in parallel. - **Filter by price to target sweet spots.** Set `minPrice` and `maxPrice` to capture only high-value furniture or exclude low-value dollar items from your final CSV output. - **Paginate seamlessly.** The scraper automatically follows the next-page links (`?Page=N`) until the `maxItems` limit is reached, giving you full coverage of large estate auctions. ### FAQ, disclaimers, and support ##### Is the AuctionNinja scraper legal and compliant? Yes. The AuctionNinja scraper reads public listing information that is visible to any logged-out user on the platform. It does not bypass paywalls, read private user accounts, or place automatic financial bids. You are responsible for compliance with AuctionNinja terms of service and local laws. ##### Does this scraper require proxies or get blocked? No. AuctionNinja uses standard server infrastructure that is open to public crawlers. It does not block normal datacenter runs. This means your scraper compiles and runs reliably on every single attempt with zero residential proxy overhead. ##### Can I track bid counts and remaining times? Yes. By default, the catalog list captures the relative time remaining. If you require exact bid counts (e.g. `32 Bids`) and detailed condition grades, simply turn on the `scrapeDetails` enrichment setting in the run parameters. ##### Which AuctionNinja categories and sellers are supported? All 399 active estate sale companies and thousands of online auctions listed on the platform, including mid-century modern furniture, art, jewelry, silver, cameras, tools, and vehicles. You can restrict runs to a specific company using the `sellerFilter` option. **Disclaimer:** This Actor accesses public web listing data only. It does not bypass authentication, paywalls, or anti-bot systems on the live site. AuctionNinja is the registered trademark of Clearing House Estate Sales, LLC. This Actor is not affiliated with, endorsed by, or sponsored by Clearing House Estate Sales, LLC. # Actor input Schema ## `startUrls` (type: `array`): Paste direct Auction Details pages (e.g. 'https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html'). Overrides queries. ## `searchQueries` (type: `array`): Fuzzy-match terms (e.g. 'jewelry' will filter matching lots or find sales). Bypassed if Start URLs are provided. ## `minPrice` (type: `integer`): Only include lots with a current bid at or above this value. 0 = no minimum. ## `maxPrice` (type: `integer`): Only include lots with a current bid at or below this value. 0 = no maximum. ## `sellerFilter` (type: `string`): Restrict the run to a specific estate-sale company slug (e.g. 'clearinghouseestatesales'). ## `scrapeDetails` (type: `boolean`): Fetch individual lot pages in parallel for rich JSON-LD details (conditions, descriptions, bid counts, premiums). Highly recommended for appraisers. Slower. ## `maxItems` (type: `integer`): Maximum number of lots to output per auction. 0 = unlimited. ## `maxConcurrency` (type: `integer`): Maximum parallel requests (1-20). Higher is faster but may trigger CDX rate limits. ## `debugLogging` (type: `boolean`): Print granular tracing tags (CDX, FETCH, EMIT) to the run logs. ## `proxyConfiguration` (type: `object`): Proxy options. Required only if fetching from highly active live storefronts. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html" } ], "searchQueries": [], "minPrice": 0, "maxPrice": 0, "sellerFilter": "", "scrapeDetails": false, "maxItems": 100, "maxConcurrency": 5, "debugLogging": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html" } ], "searchQueries": [], "minPrice": 0, "maxPrice": 0, "sellerFilter": "", "scrapeDetails": false, "maxItems": 100, "maxConcurrency": 5, "debugLogging": false, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/auctionninja-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html" }], "searchQueries": [], "minPrice": 0, "maxPrice": 0, "sellerFilter": "", "scrapeDetails": False, "maxItems": 100, "maxConcurrency": 5, "debugLogging": False, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/auctionninja-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html" } ], "searchQueries": [], "minPrice": 0, "maxPrice": 0, "sellerFilter": "", "scrapeDetails": false, "maxItems": 100, "maxConcurrency": 5, "debugLogging": false, "proxyConfiguration": { "useApifyProxy": false } }' | apify call getascraper/auctionninja-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/auctionninja-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AuctionNinja Scraper: Estate Sales & Online Auctions", "description": "Scrape estate sales and online auctions from AuctionNinja.com. Extract lot details, current bids, bidding counts, conditions, descriptions, buyer premiums, times remaining, images, and locations site-wide without proxies.", "version": "0.1", "x-build-id": "eBb1Z4x17Y2ZK0Tdh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~auctionninja-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-auctionninja-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~auctionninja-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-auctionninja-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~auctionninja-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-auctionninja-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": "Start URLs", "type": "array", "description": "Paste direct Auction Details pages (e.g. 'https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html'). Overrides queries.", "default": [ { "url": "https://www.auctionninja.com/clearinghouseestatesales/sales/details/harwinton-ct-multiple-estates-auction-17221.html" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Fuzzy-match terms (e.g. 'jewelry' will filter matching lots or find sales). Bypassed if Start URLs are provided.", "default": [] }, "minPrice": { "title": "Min bid price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include lots with a current bid at or above this value. 0 = no minimum.", "default": 0 }, "maxPrice": { "title": "Max bid price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include lots with a current bid at or below this value. 0 = no maximum.", "default": 0 }, "sellerFilter": { "title": "Seller company filter", "type": "string", "description": "Restrict the run to a specific estate-sale company slug (e.g. 'clearinghouseestatesales').", "default": "" }, "scrapeDetails": { "title": "Enrich detail pages", "type": "boolean", "description": "Fetch individual lot pages in parallel for rich JSON-LD details (conditions, descriptions, bid counts, premiums). Highly recommended for appraisers. Slower.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Maximum number of lots to output per auction. 0 = unlimited.", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum parallel requests (1-20). Higher is faster but may trigger CDX rate limits.", "default": 5 }, "debugLogging": { "title": "Verbose debug logs", "type": "boolean", "description": "Print granular tracing tags (CDX, FETCH, EMIT) to the run logs.", "default": false }, "proxyConfiguration": { "title": "Proxy setup", "type": "object", "description": "Proxy options. Required only if fetching from highly active live storefronts.", "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 } } } } } } } } } } ```