# Liquidation.com Auction Scraper: Bids, Closing Time & Monitor (`getascraper/liquidation-com-scraper`) Actor

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.

- **URL**: https://apify.com/getascraper/liquidation-com-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** E-commerce, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.50 / 1,000 lot records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## 📦 Liquidation.com Auction Scraper: Bids, Closing Time & Monitor

<table width="100%" style="width:100%">
<tr>
<td style="padding:24px 28px;background:#FDF3E7;border:1px solid #F0D9B5;border-top:4px solid #B5651D;border-radius:12px">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Stop refreshing Liquidation.com. Let new lots come to you.</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Pull live bids, closing times, seller, condition, and location for every lot that matches your search, and get notified only when a new one actually shows up.</span>
</td>
</tr>
</table>

<table width="100%" style="width:100%">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0D9B5;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#8A4B15">🔔 Get alerted to new lots</span><br>
<span style="font-size:12px;color:#57534E">Monitor mode remembers every lot it has already seen and reports only the new ones on your next run.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0D9B5;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#8A4B15">📋 See the full picture</span><br>
<span style="font-size:12px;color:#57534E">Turn on lot detail lookup for the product description, condition notes, buyer's premium, and shipping terms.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0D9B5;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#8A4B15">🔎 Look up lots by ID</span><br>
<span style="font-size:12px;color:#57534E">Already tracking specific auctions in a spreadsheet? Pull their live bid and closing time directly.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #F0D9B5;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#8A4B15">🛡️ Built to actually finish</span><br>
<span style="font-size:12px;color:#57534E">Runs reliably without a residential proxy, so a scheduled run doesn't stall or fail partway through.</span>
</td>
</tr>
</table>

### 🔍 What does Liquidation.com Auction Scraper do?

[Liquidation.com](https://www.liquidation.com/) lists thousands of wholesale pallets, packages,
and truckloads from major retailers, but its own search page only shows you a snapshot the
moment you happen to load it. This Actor pulls the same data programmatically: seller, current
bid, bid and watcher counts, closing time, condition, lot size, item count, and warehouse
location for every lot matching your search.

Search by keyword, category, condition, lot size, or US region, or hand it specific lot IDs
you're already tracking. Turn on lot detail lookup to add the full product description, condition
notes, minimum bid, buyer's premium percentage, shipping terms, and pallet count for each lot.
Turn on monitor mode to get only the lots that are new since your last run, ideal for a
scheduled search that watches a category for you.

### 💡 Why use this scraper?

**Wholesale resellers and arbitrage buyers** who source inventory from liquidation lots know the
real cost of missing a good pallet: someone else bids it away before you even see it listed.
Checking the site by hand a few times a day means you're always a step behind.

- **Stop babysitting a browser tab.** Schedule a run and let monitor mode tell you only when a
  genuinely new lot appears in your category.
- **Evaluate a lot without opening it.** Bid history, condition, and location arrive in one row,
  so you can decide whether it's worth a closer look before you click through.
- **Get the details that matter for margin.** Buyer's premium and shipping terms change the real
  cost of a lot; lot detail lookup surfaces both instead of leaving you to check by hand.
- **Feed your own pricing or sourcing tools.** Export straight to JSON, CSV, or Excel, or connect
  it to a spreadsheet or database through Apify's integrations.

### 🚀 How to use it

<table width="100%" style="width:100%">
<tr>
<td style="padding:16px 14px;width:33%;background:#FDF3E7;border:1px solid #F0D9B5;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#B5651D;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Tell it what to find</span><br>
<span style="font-size:12px;color:#57534E">Enter keywords, pick a category, condition, lot size, or region, or paste specific lot IDs.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#FDF3E7;border:1px solid #F0D9B5;border-left:none;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#B5651D;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Run the Actor</span><br>
<span style="font-size:12px;color:#57534E">It collects live bid, closing time, seller, condition, and location for every matching lot.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#FDF3E7;border:1px solid #F0D9B5;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#B5651D;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Get your data</span><br>
<span style="font-size:12px;color:#57534E">Download as JSON, CSV, or Excel, or schedule it to send you only the new lots.</span>
</td>
</tr>
</table>

### ⚙️ Input

Configure the Actor from the Input tab in Apify Console, or pass JSON directly through the API.

| Field | Type | Required | Description |
|---|---|---|---|
| `keywords` | array of strings | No | Free-text search terms, e.g. "laptop" or "power tools". |
| `lotIds` | array of strings | No | Specific auction IDs to fetch directly, skipping search. |
| `startUrls` | array of URLs | No | Paste liquidation.com search or category URLs directly for full manual control. |
| `categories` | enum (multi-select) | No | Restrict to one or more product categories. |
| `conditions` | enum (multi-select) | No | Restrict to one or more item conditions (New, Returns, Shelf Pulls, and others). |
| `lotSizes` | enum (multi-select) | No | Restrict to Package, Pallet, or Truckload lots. |
| `usRegions` | enum (multi-select) | No | Restrict to lots warehoused in a US region. |
| `fetchLotDetails` | boolean | No | Also visit each lot's detail page for description, condition notes, buyer's premium, and shipping terms. |
| `maxItems` | integer | No | Maximum number of lots to collect in this run. |
| `monitorMode` | boolean | No | Only output lots not seen in a previous run using the same monitor state name. |
| `monitorStateName` | string | No | Name identifying this saved search's monitor state, for repeated scheduled runs. |
| `proxyConfiguration` | object | No | Proxy settings. Not required by default; this Actor runs reliably without a proxy. |

### 📊 Data table

| Field | Type | Description |
|---|---|---|
| `lotId` | string | The auction's unique ID on liquidation.com. |
| `title` | string | The lot's listing title. |
| `category` | string | The lot's category, when the search applied one. |
| `seller` | string | The seller's account name. |
| `condition` | string | The item condition (Returns, New, Shelf Pulls, and others). |
| `lotSize` | string | Package, Pallet, or Truckload. |
| `itemCount` | number | Number of items in the lot. |
| `currentBid` | number | Current bid in USD. |
| `estRetail` | number | Estimated retail value in USD, when the seller listed one. |
| `bidCount` | number | Number of bids placed so far. |
| `watchers` | number | Number of buyers watching the lot. |
| `views` | number | Number of times the lot has been viewed. |
| `closingAt` | string | When bidding closes. |
| `location` | string | The lot's warehouse location. |
| `imageUrl` | string | Link to the lot's listing photo. |
| `detailUrl` | string | Link to the lot's page on liquidation.com. |
| `productDescription` | string | Full product description (with lot detail lookup enabled). |
| `conditionNote` | string | Condition detail note (with lot detail lookup enabled). |
| `minimumBid` | number | Minimum bid required in USD (with lot detail lookup enabled). |
| `buyersPremiumPercent` | number | Buyer's premium as a percentage (with lot detail lookup enabled). |
| `totalWeightLbs` | number | Total lot weight in pounds (with lot detail lookup enabled). |
| `shippingTerms` | string | Shipping arrangement for the lot (with lot detail lookup enabled). |
| `numberOfPallets` | number | Number of pallets in the lot (with lot detail lookup enabled). |
| `zipCode` | string | Warehouse zip code (with lot detail lookup enabled). |

Fields with no real value on a given lot are left out of that item rather than filled with a
placeholder, so every field you do see is genuine.

#### Example output

```json
{
    "lotId": "21461151",
    "title": "Signature Hardware SHWORK1BZ Stainless Steel Kitchen Sink",
    "category": "Home Improvement",
    "seller": "FergusonHome",
    "condition": "Returns",
    "lotSize": "Pallet",
    "itemCount": 1,
    "currentBid": 42,
    "estRetail": 823.9,
    "bidCount": 2,
    "watchers": 2,
    "views": 87,
    "closingAt": "Today 9:10AM",
    "location": "Indiana",
    "detailUrl": "https://www.liquidation.com/auction/view?id=21461151",
    "buyersPremiumPercent": 11,
    "shippingTerms": "For pick-up only"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

### 💰 Pricing

This Actor uses Apify's pay-per-result pricing: **$0.01 per lot record**, with automatic
discounts on paid Apify plans. You pay only for the lots it actually returns; an empty run, or
one that finds nothing matching your filters, costs nothing. There is no subscription and no
minimum spend.

### ⭐ Enjoying Liquidation.com Auction Scraper?

<table width="100%" style="display:table;width:100%">
<tr>
<td style="padding:20px 24px 14px;background:#FDF3E7;border:1px solid #F0D9B5;border-left:5px solid #B5651D;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">Found a lot before it sold out to someone else? That's worth a rating.</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other resellers and wholesale buyers find this Actor. Your feedback also tells us what to build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#B5651D;border:1px solid #F0D9B5;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/liquidation-com-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### 🛠️ Tips

- Keep `fetchLotDetails` off for a first run to see what a plain listing scrape returns before
  paying for the extra detail-page fetch.
- Combine `monitorMode` with Apify's Scheduler to get a running feed of new lots in a category
  you watch regularly, instead of re-running a full search every time.
- Use `lotIds` when you already know which auctions you want to track, since it skips search
  entirely and goes straight to each lot's page.

### ❓ FAQ

**Does this Actor need a login or account on liquidation.com?**
No. It reads publicly visible listing data the same way the site's own search page shows it.

**Will this place bids for me?**
No. This Actor only reads and reports lot data; it does not place bids or take any action on
your behalf.

**Why do some lots have fewer fields than others?**
A field only appears when the site actually published a value for it. Rather than guess or fill
in a placeholder, this Actor leaves a missing field out of that lot's data entirely.

**Can I track a specific category over time?**
Yes. Set your filters, turn on monitor mode, and schedule the run. Each run after the first will
report only lots that weren't already seen.

### 🔗 Other actors

- [GovDeals Vehicle Auction Scraper: Government Surplus Vehicles](https://apify.com/getascraper/govdeals-vehicle-auction-scraper) ↗ - tracks government surplus vehicle auctions with bid and closing data.
- [Government Surplus Auction Outcome Feed](https://apify.com/getascraper/government-surplus-outcome-feed) ↗ - reports outcomes from government surplus auctions after they close.
- [AuctionNinja Scraper: Estate Sales & Online Auctions](https://apify.com/getascraper/auctionninja-scraper) ↗ - tracks estate sale and online auction listings across AuctionNinja.
- [Heavy-equipment auction comps feed](https://apify.com/getascraper/heavy-equipment-auction-comps-feed) ↗ - pulls sold comps for heavy equipment auctions.
- [Goldin Auctions Scraper: Sports Cards & Sold Comps](https://apify.com/getascraper/goldin-auctions-scraper) ↗ - tracks sports card auctions and sold prices on Goldin.

# Actor input Schema

## `keywords` (type: `array`):

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.

## `lotIds` (type: `array`):

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.

## `startUrls` (type: `array`):

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.

## `categories` (type: `array`):

Restrict results to one or more product categories.

## `conditions` (type: `array`):

Restrict results to one or more item conditions, e.g. only New or only Returns lots.

## `lotSizes` (type: `array`):

Restrict results to a lot size: Package (small), Pallet, or Truckload.

## `usRegions` (type: `array`):

Restrict results to lots warehoused in one or more US regions.

## `fetchLotDetails` (type: `boolean`):

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.

## `maxItems` (type: `integer`):

Maximum number of lots to collect in this run. Kept low by default so a default run finishes quickly; raise it for larger pulls.

## `monitorMode` (type: `boolean`):

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.

## `monitorStateName` (type: `string`):

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.

## `proxyConfiguration` (type: `object`):

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.

## Actor input object example

```json
{
  "keywords": [
    "electronics"
  ],
  "lotIds": [],
  "startUrls": [],
  "categories": [],
  "conditions": [],
  "lotSizes": [],
  "usRegions": [],
  "fetchLotDetails": false,
  "maxItems": 20,
  "monitorMode": false,
  "monitorStateName": "liquidation-monitor-state",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "electronics"
    ],
    "lotIds": [],
    "startUrls": [],
    "categories": [],
    "conditions": [],
    "lotSizes": [],
    "usRegions": [],
    "fetchLotDetails": false,
    "maxItems": 20,
    "monitorMode": false,
    "monitorStateName": "liquidation-monitor-state",
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/liquidation-com-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["electronics"],
    "lotIds": [],
    "startUrls": [],
    "categories": [],
    "conditions": [],
    "lotSizes": [],
    "usRegions": [],
    "fetchLotDetails": False,
    "maxItems": 20,
    "monitorMode": False,
    "monitorStateName": "liquidation-monitor-state",
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/liquidation-com-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "electronics"
  ],
  "lotIds": [],
  "startUrls": [],
  "categories": [],
  "conditions": [],
  "lotSizes": [],
  "usRegions": [],
  "fetchLotDetails": false,
  "maxItems": 20,
  "monitorMode": false,
  "monitorStateName": "liquidation-monitor-state",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call getascraper/liquidation-com-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/liquidation-com-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hw0j0C1Qs3ZarFh10/builds/30eJj3NgjMRAezazC/openapi.json