# Unicorn Auctions Scraper — Rare Bourbon & Whisky Lots (`lulzasaur/unicornauctions-scraper`) Actor

Scrape Unicorn Auctions (unicornauctions.com) rare bourbon, whisky, spirits & wine lots. Search by keyword; filter by category & status. Per lot: title, category, size, proof, age, condition, current bid or realized sold price, estimates, reserve, sale comps, close date, image, URL.

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

## Pricing

from $10.00 / 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 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

## Unicorn Auctions Scraper 🦄🥃

Scrape rare **bourbon, whisky, spirits & wine** auction lots from [Unicorn Auctions](https://www.unicornauctions.com) (unicornauctions.com) — the leading online marketplace for hard-to-find bottles.

Search live & upcoming lots or dig into **ended lots with realized sold prices** — the single most useful signal for pricing rare bottles.

### What it does

- 🔎 **Keyword search** across the full catalog (700k+ lots) — e.g. `pappy van winkle`, `macallan`, `yamazaki`, `hirsch`
- 🏷️ **Filter by category** (Bourbon, Scotch, Japanese Whisky, Tequila, Wine, Rye, Irish, Rum, Cognac …)
- 📊 **Live bids** (current running high bid) **or** **sold comps** (realized winning/hammer price on ended lots)
- 📈 **Historical sale comps** per bottle (all-time low/high realized price + number of sales)
- 🖼️ Full image URLs, lot detail links, estimates, reserve prices, proof & age

### Example input

```json
{
  "searchQueries": ["pappy van winkle", "macallan"],
  "maxResults": 100,
  "status": "Sold",
  "category": "Bourbon",
  "sortBy": "current_bid_desc",
  "proxyConfiguration": { "useApifyProxy": false }
}
```

#### Input fields

| Field | Description |
|-------|-------------|
| `searchQueries` | Array of keywords. Use `[""]` to browse all lots. Each query runs a separate search. |
| `maxResults` | Max lot records per run (shared across queries). Default `100`. |
| `status` | `Live` (live & upcoming), `Sold` (ended lots with realized price — best for comps), or `Any`. |
| `category` | Optional spirit category filter (Bourbon, Scotch, Japanese, Tequila, Wine, …). |
| `sortBy` | `lot_number`, `ending_soon`, `current_bid_desc/asc`, `estimate_desc/asc`, `reserve_desc/asc`. |
| `proxyConfiguration` | Optional. Not required — the source API is open. |

### Output

Each lot record includes:

| Field | Description |
|-------|-------------|
| `title` | Full lot title (bottle name) |
| `category` | Bourbon / Scotch / Japanese / Tequila / Wine / … |
| `size` | Bottle size (e.g. `750 ml`) |
| `quantity` | Number of bottles in the lot |
| `proof` / `ageStatement` | Parsed from the lot description when present |
| `condition` | Condition notes (label wear, fill level, etc.) |
| `description` | Full plain-text lot description |
| `currentBid` | Running high bid (live lots only) |
| `realizedPrice` | Winning / hammer price (sold / ended lots only) |
| `bidTimestamp` | Timestamp of the current/winning bid |
| `lowEstimate` / `highEstimate` | Auction house estimate range |
| `reservePrice` / `reservePriceMet` | Reserve price and whether it was met |
| `compLowSale` / `compHighSale` / `compTotalSales` | All-time sale comps for this bottle |
| `state` / `tagStatus` / `isSold` | Lot lifecycle (LIVE / ENDED, SOLD) |
| `startDatetime` / `endDatetime` | Auction open / close datetimes (ISO 8601) |
| `imageUrl` / `images` | Primary image + all lot photos |
| `url` | Direct link to the lot detail page |
| `currency` | Bid currency (USD) |

#### Sample record

```json
{
  "lotUuid": "4922bbd9-166e-45e6-8b27-889beb9a044e",
  "auctionUuid": "e34424fe-3e65-48ac-b5c9-cfc1f5801d2c",
  "lotNumber": 1,
  "title": "A.H. Hirsch 18 Year 'Reserve' Bourbon (Lawrenceburg, Gold Wax)",
  "category": "Bourbon",
  "size": "750 ml",
  "proof": "93",
  "ageStatement": "Eighteen Years",
  "condition": "Wear and stains on label",
  "currentBid": 18400,
  "realizedPrice": null,
  "lowEstimate": 20000,
  "highEstimate": 30000,
  "reservePrice": 0,
  "reservePriceMet": true,
  "state": "LIVE",
  "endDatetime": "2026-08-16T23:00:00.001000Z",
  "currency": "USD",
  "url": "https://www.unicornauctions.com/auction/e34424fe-.../lot/4922bbd9-...",
  "imageUrl": "https://digqdh912fmd8.cloudfront.net/.../ita_PKg4w1BW5if4vpsbFhIHGjZA.jpg"
}
```

### Use cases

- 💰 **Price rare bottles** using real realized auction comps
- 📉 Track a distillery or bottling's value over time
- 🔔 Monitor live lots and reserve status for bottles you collect
- 🗃️ Build a spirits price database for a valuation / insurance tool

### Notes

- Data comes from Unicorn Auctions' own public GraphQL API — no login required.
- Prices are in USD.
- `status: "Sold"` returns ended lots; `realizedPrice` holds the winning bid.

*Not affiliated with or endorsed by Unicorn Auctions. For research and personal use; respect the site's terms.*

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search Unicorn Auctions, e.g. 'pappy van winkle', 'macallan', 'yamazaki', 'hirsch'. Leave a single empty string \[""] to browse all lots. Each query runs a separate search.

## `maxResults` (type: `integer`):

Maximum number of lot records to return per run (shared across all queries). Default 100.

## `status` (type: `string`):

'Live' = current live & upcoming lots (running bids). 'Sold' = ended lots with the realized winning price (great for sold-price comps). 'Any' = both.

## `category` (type: `string`):

Filter by spirit category. Leave blank for all categories.

## `sortBy` (type: `string`):

Result ordering.

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

Proxy settings. Unicorn Auctions' GraphQL API is open with no anti-bot protection, so NO proxy is needed. Enable a proxy only if you scale to very high volume.

## Actor input object example

```json
{
  "searchQueries": [
    "pappy van winkle"
  ],
  "maxResults": 100,
  "status": "Live",
  "category": "",
  "sortBy": "lot_number",
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "pappy van winkle"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("lulzasaur/unicornauctions-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 = {
    "searchQueries": ["pappy van winkle"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("lulzasaur/unicornauctions-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 '{
  "searchQueries": [
    "pappy van winkle"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call lulzasaur/unicornauctions-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lulzasaur/unicornauctions-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/RAWnEgY5OaXgdUtiS/builds/yig7egHm9kS2OfIbX/openapi.json