# HiBid Scraper (`solidcode/hibid-scraper`) Actor

\[💰 $1.00 / 1K] Scrape HiBid auction lots — current bids, bid counts, estimates, descriptions, images, categories, auctioneer, location, and close dates. Search by keyword or paste auction & lot URLs.

- **URL**: https://apify.com/solidcode/hibid-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

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/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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

## HiBid Scraper

Pull auction-lot data from HiBid at scale — live bids, estimate ranges, full descriptions, image galleries, and the parent auction behind every lot, delivered as one clean row per item. Search by keyword across every HiBid auction, or paste the exact catalogs and lots you care about. Built for resellers, estate buyers, and market researchers who need HiBid lot data in a spreadsheet without copying catalog after catalog by hand.

### Why This Scraper?

- **Live bid economics on every lot** — current high bid, total bid count, opening bid, and the auctioneer's low–high estimate range, so you can read demand and value at a glance.
- **15 top-level categories, drawn from a 359-category tree** — from Coins & Currency and Jewelry, Watches & Gemstones to Cars & Vehicles and Construction & Farm.
- **Proximity search with a 10–500 mile radius** — center on any city, state, or ZIP and keep only the auctions within the distance you set.
- **Five auction-status filters** — Open for bidding, Closing soon, Upcoming, Closed / past, or All auctions.
- **Full lot detail on demand** — one toggle adds the complete image gallery, the full item description, and the category breadcrumb to every lot.
- **Two ways in** — keyword search across all HiBid auctions (up to about 10,000 matches per keyword), or paste specific catalog and single-lot URLs, which have no result ceiling.
- **~24 ready-to-use fields per lot** — auction title, auctioneer, location, close date, lot number, thumbnail, and more, flattened onto every row so there are no parent-child joins to untangle.
- **Per-auction sampling cap** — skim huge estate and liquidation catalogs with Max Lots per Auction, then bound the whole run with a single Max Results total.
- **Nationwide US coverage** — every HiBid auctioneer and catalog, with no per-seller setup.

### Use Cases

**Reseller & Flip Sourcing**
- Find undervalued lots by keyword across every open auction
- Compare current bids to estimate ranges to spot bargains before close
- Track Closing soon lots for last-minute buy opportunities
- Pull whole catalogs to build a sourcing shortlist

**Price & Market Research**
- Benchmark realized bids by category and region
- Measure bid counts to gauge demand for a product type
- Compare estimate ranges against final high bids over time
- Build datasets of comparable lots for valuation models

**Estate & Liquidation Monitoring**
- Watch new estate and liquidation catalogs in a target metro
- Sample the first lots of a mega-catalog before committing
- Track closing dates across auctions you follow
- Capture full descriptions and galleries for record-keeping

**Auctioneer & Lead Intelligence**
- Map active auctioneers and their catalogs by location
- Monitor competitor catalogs for category mix and lot volume
- Identify high-activity auction houses by bid counts
- Feed auction calendars into your own alerts

**Collectors & Specialists**
- Follow specific categories like coins, art, or jewelry nationwide
- Set a location radius to collect within driving distance
- Archive lot images and descriptions for a personal catalog
- Watch Upcoming auctions to plan bidding ahead of time

### Getting Started

#### Simple Keyword Search

The fastest way to start — one keyword and a result cap:

```json
{
    "searchKeywords": ["coins"],
    "maxResults": 100
}
````

#### Category + Location + Status

Narrow a keyword search to a category, a metro area, and open auctions only:

```json
{
    "searchKeywords": ["antique furniture"],
    "category": "furniture",
    "location": "Dallas, TX",
    "distanceMiles": 100,
    "auctionStatus": "open",
    "maxResults": 500
}
```

#### Full-Featured Example

Mix keywords with pasted catalog and lot URLs, sample each catalog, and pull complete lot detail:

```json
{
    "searchKeywords": ["1889-cc morgan dollar"],
    "auctionUrls": [
        "https://hibid.com/catalog/592418",
        "https://hibid.com/lot/48210773"
    ],
    "category": "coins_currency",
    "auctionStatus": "closing_soon",
    "maxResults": 1000,
    "maxLotsPerAuction": 50,
    "fetchLotDetails": true
}
```

### Input Reference

#### What to Collect

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchKeywords` | array | `["coins"]` | Keyword searches run across all HiBid auctions — for example "coins", "antique furniture", or "John Deere tractor". Add one keyword per line; each produces its own set of lots. |
| `auctionUrls` | array | `[]` | Paste HiBid auction (catalog) URLs or individual lot URLs to pull their lots directly. Use this when you already know which auctions you want. |

#### Filters

Filters apply to keyword searches only. They are ignored when Auction URLs are provided, since a pasted URL already scopes its own auction.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `category` | select | `Any category` | Restrict keyword searches to a single HiBid category. Leave as "Any category" to search everything. |
| `location` | string | (empty) | City, state, or ZIP code to center a nearby search on (for example "Dallas, TX" or "75201"). Leave empty to search nationwide. |
| `distanceMiles` | integer | `100` | How far from the Location to include auctions, in miles (10–500). Only used when a Location is set. |
| `auctionStatus` | select | `Open for bidding` | Only include lots from auctions in this state: All auctions, Open for bidding, Closing soon, Upcoming, or Closed / past. |

#### Limits & Options

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `100` | Maximum total number of lots to return across everything. Set to 0 for unlimited, capped at 100,000 lots as a safety limit. A single keyword search reaches up to about 10,000 lots — to go beyond that, split into more specific keywords or use Auction URLs, which have no such limit. |
| `maxLotsPerAuction` | integer | `0` | Cap how many lots are pulled from each individual auction or catalog URL you paste. Set to 0 for no per-auction cap. Useful for sampling large catalogs. |
| `fetchLotDetails` | boolean | `false` | When enabled, each lot's own page is opened to collect the full description, the complete image gallery, and the category breadcrumb. Slower, but far richer data. |

### Output

Each lot becomes one row, with its parent auction's details flattened onto the same row. Here is a representative lot with full detail enabled:

```json
{
    "auctionId": 592418,
    "auctionTitle": "Estate Coin & Currency Auction",
    "auctioneerName": "Heartland Auction Group",
    "auctionType": "Online-Only",
    "auctionStartDate": "2026-07-18T13:00:00Z",
    "auctionEndDate": "2026-07-25T18:00:00Z",
    "auctionLocation": "Dallas, TX",
    "auctionUrl": "https://hibid.com/catalog/592418",
    "lotId": 48210773,
    "lotNumber": "104",
    "lotTitle": "1889-CC Morgan Silver Dollar",
    "lotDescription": "1889-CC Morgan Silver Dollar, key date, strong reverse detail, light obverse toning.",
    "category": "Coins & Currency > US Coins > Morgan Dollars",
    "currentBid": 1250.00,
    "estimateLow": 750.00,
    "estimateHigh": 1250.00,
    "currency": "USD",
    "bidCount": 17,
    "lotStatus": "OPEN",
    "lotClosingDate": "2026-07-25T18:00:00Z",
    "images": [
        "https://media.hibid.com/lot/592418/48210773/full-1.jpg",
        "https://media.hibid.com/lot/592418/48210773/full-2.jpg"
    ],
    "thumbnailUrl": "https://media.hibid.com/lot/592418/48210773/thumb-1.jpg",
    "lotUrl": "https://hibid.com/lot/48210773/1889-cc-morgan-silver-dollar"
}
```

Empty fields are omitted from each row rather than returned as blanks.

#### Auction Fields

Denormalized onto every lot row — no separate parent record to join.

| Field | Type | Description |
|-------|------|-------------|
| `auctionId` | integer | HiBid auction (event) ID |
| `auctionTitle` | string | Auction / catalog title |
| `auctioneerName` | string | Auction house or seller name |
| `auctionType` | string | Auction format (e.g. Online-Only, Live) |
| `auctionStartDate` | string | Auction start datetime (ISO) |
| `auctionEndDate` | string | Auction end / close datetime (ISO) |
| `auctionLocation` | string | Auction city and state |
| `auctionUrl` | string | Catalog URL |

#### Lot Fields

| Field | Type | Description |
|-------|------|-------------|
| `lotId` | integer | HiBid lot ID |
| `lotNumber` | string | Lot number within the auction |
| `lotTitle` | string | Lot title / headline |
| `lotDescription` | string | Full description (fuller when Fetch Full Lot Details is on) |
| `category` | string | Category breadcrumb (added when Fetch Full Lot Details is on) |
| `lotStatus` | string | Lot state (e.g. OPEN, CLOSED) |
| `lotClosingDate` | string | When the auction closes (ISO) — shared by every lot in that auction, since HiBid auctions close as a whole rather than lot-by-lot |
| `lotUrl` | string | Direct lot page URL |

#### Bid & Estimate Fields

| Field | Type | Description |
|-------|------|-------------|
| `currentBid` | number | Current high bid |
| `startingBid` | number | Opening bid — shown on lots that have not yet received a bid |
| `estimateLow` | number | Low end of the auctioneer's estimate |
| `estimateHigh` | number | High end of the auctioneer's estimate |
| `currency` | string | ISO currency code (usually USD) |
| `bidCount` | integer | Number of bids placed |

#### Media Fields

| Field | Type | Description |
|-------|------|-------------|
| `images` | array | Image URLs — full gallery when Fetch Full Lot Details is on, otherwise the primary image |
| `thumbnailUrl` | string | Primary thumbnail image URL |

### Tips for Best Results

- **Start small** — set Max Results to 50–100 on your first run to confirm the lots match what you want, then scale up.
- **Turn on lot details only when you need them** — Fetch Full Lot Details adds the complete gallery, full description, and category breadcrumb, but opens each lot individually. Leave it off for a fast overview.
- **A single keyword tops out around 10,000 lots** — that is HiBid's own search ceiling. To pull deeper, split into more specific keywords, add a category, or narrow by location. A pasted catalog URL under Auction URLs has no such ceiling.
- **Sample huge catalogs with Max Lots per Auction** — pull the first 25–50 lots from each estate or liquidation catalog without draining your total budget on one mega-catalog.
- **Filters apply to keyword searches only** — a pasted catalog URL already scopes its own auction, so category, location, and status are ignored for URLs.
- **Use "Closing soon" for timing** — set Auction Status to Closing soon to catch lots about to end, ideal for last-minute bidding and closing-price snapshots.
- **Combine keywords and URLs in one run** — cast a wide keyword net and pin specific catalogs at the same time.

### Pricing

**From $1.00 per 1,000 results** — one of the most affordable ways to collect HiBid auction lots at scale. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.12 | $0.115 | $0.11 | $0.10 |
| 1,000 | $1.20 | $1.15 | $1.10 | $1.00 |
| 10,000 | $12.00 | $11.50 | $11.00 | $10.00 |
| 100,000 | $120.00 | $115.00 | $110.00 | $100.00 |

A "result" is one auction lot in your dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor is designed for legitimate auction research, market analysis, and sourcing. You are responsible for complying with applicable laws and HiBid's Terms of Service. Do not use collected data for spam, harassment, or any illegal purpose, and respect the rights of auctioneers and sellers whose listings you collect.

# Actor input Schema

## `searchKeywords` (type: `array`):

Keyword searches run across all HiBid auctions — for example 'coins', 'antique furniture', or 'John Deere tractor'. Add one keyword per line; each produces its own set of lots. Leave empty if you are using Auction URLs instead.

## `auctionUrls` (type: `array`):

Paste HiBid auction (catalog) URLs or individual lot URLs to pull their lots directly. Use this when you already know which auctions you want.

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

Restrict keyword searches to a single HiBid category. Leave as 'Any category' to search everything. Ignored when Auction URLs are used.

## `location` (type: `string`):

City, state, or ZIP code to center a nearby search on (for example 'Dallas, TX' or '75201'). Leave empty to search nationwide.

## `distanceMiles` (type: `integer`):

How far from the Location to include auctions, in miles. Only used when a Location is set.

## `auctionStatus` (type: `string`):

Only include lots from auctions in this state.

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

Maximum total number of lots to return across everything. Set to 0 for unlimited — unlimited runs are capped at 100,000 lots as a safety limit, so a very broad run can never grow without bound or cost. Note: a single keyword search reaches up to about 10,000 lots (HiBid's search limit) — to go beyond that, split into more specific keywords or use Auction URLs, which have no such limit.

## `maxLotsPerAuction` (type: `integer`):

Cap how many lots are pulled from each individual auction or catalog URL you paste under Auction URLs. Set to 0 for no per-auction cap. Useful for sampling large catalogs. This does not apply to keyword searches (use Max Results for those).

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

When enabled, the scraper opens each lot's own page to collect the full description, the complete image gallery, and the category breadcrumb. Slower, but far richer data. Leave off for a fast overview from search results.

## Actor input object example

```json
{
  "searchKeywords": [
    "coins"
  ],
  "auctionUrls": [],
  "distanceMiles": 100,
  "auctionStatus": "open",
  "maxResults": 100
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of scraped lots with key fields.

## `pricing` (type: `string`):

Table of current bids, starting bids, estimate ranges, and lot status.

## `gallery` (type: `string`):

Table of lot thumbnails and full image galleries.

# 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 = {
    "searchKeywords": [
        "coins"
    ],
    "auctionUrls": [],
    "category": "",
    "distanceMiles": 100,
    "auctionStatus": "open",
    "maxResults": 100,
    "maxLotsPerAuction": 0,
    "fetchLotDetails": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/hibid-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 = {
    "searchKeywords": ["coins"],
    "auctionUrls": [],
    "category": "",
    "distanceMiles": 100,
    "auctionStatus": "open",
    "maxResults": 100,
    "maxLotsPerAuction": 0,
    "fetchLotDetails": False,
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/hibid-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 '{
  "searchKeywords": [
    "coins"
  ],
  "auctionUrls": [],
  "category": "",
  "distanceMiles": 100,
  "auctionStatus": "open",
  "maxResults": 100,
  "maxLotsPerAuction": 0,
  "fetchLotDetails": false
}' |
apify call solidcode/hibid-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solidcode/hibid-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "HiBid Scraper",
        "description": "[💰 $1.00 / 1K] Scrape HiBid auction lots — current bids, bid counts, estimates, descriptions, images, categories, auctioneer, location, and close dates. Search by keyword or paste auction & lot URLs.",
        "version": "1.0",
        "x-build-id": "UWGAeTBsWeyebdFEV"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solidcode~hibid-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~hibid-scraper/runs": {
            "post": {
                "operationId": "runs-sync-solidcode-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/solidcode~hibid-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-solidcode-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": {
                    "searchKeywords": {
                        "title": "Search Keywords",
                        "type": "array",
                        "description": "Keyword searches run across all HiBid auctions — for example 'coins', 'antique furniture', or 'John Deere tractor'. Add one keyword per line; each produces its own set of lots. Leave empty if you are using Auction URLs instead.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "auctionUrls": {
                        "title": "Auction URLs",
                        "type": "array",
                        "description": "Paste HiBid auction (catalog) URLs or individual lot URLs to pull their lots directly. Use this when you already know which auctions you want.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "category": {
                        "title": "Category",
                        "enum": [
                            "",
                            "antiques_collectibles",
                            "art",
                            "business_industrial",
                            "cars_vehicles",
                            "coins_currency",
                            "computers_electronics",
                            "construction_farm",
                            "fashion",
                            "furniture",
                            "home_goods_decor",
                            "jewelry_watches_gemstones",
                            "kid_baby_essentials",
                            "lawn_garden",
                            "sporting_goods",
                            "toys"
                        ],
                        "type": "string",
                        "description": "Restrict keyword searches to a single HiBid category. Leave as 'Any category' to search everything. Ignored when Auction URLs are used."
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "City, state, or ZIP code to center a nearby search on (for example 'Dallas, TX' or '75201'). Leave empty to search nationwide."
                    },
                    "distanceMiles": {
                        "title": "Search Radius (miles)",
                        "minimum": 10,
                        "maximum": 500,
                        "type": "integer",
                        "description": "How far from the Location to include auctions, in miles. Only used when a Location is set."
                    },
                    "auctionStatus": {
                        "title": "Auction Status",
                        "enum": [
                            "all",
                            "open",
                            "closing_soon",
                            "upcoming",
                            "closed"
                        ],
                        "type": "string",
                        "description": "Only include lots from auctions in this state."
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum total number of lots to return across everything. Set to 0 for unlimited — unlimited runs are capped at 100,000 lots as a safety limit, so a very broad run can never grow without bound or cost. Note: a single keyword search reaches up to about 10,000 lots (HiBid's search limit) — to go beyond that, split into more specific keywords or use Auction URLs, which have no such limit."
                    },
                    "maxLotsPerAuction": {
                        "title": "Max Lots per Auction",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Cap how many lots are pulled from each individual auction or catalog URL you paste under Auction URLs. Set to 0 for no per-auction cap. Useful for sampling large catalogs. This does not apply to keyword searches (use Max Results for those)."
                    },
                    "fetchLotDetails": {
                        "title": "Fetch Full Lot Details",
                        "type": "boolean",
                        "description": "When enabled, the scraper opens each lot's own page to collect the full description, the complete image gallery, and the category breadcrumb. Slower, but far richer data. Leave off for a fast overview from search results."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
