# StorageTreasures Auctions Scraper (`crawlerbros/storagetreasures-auctions-scraper`) Actor

Scrape StorageTreasures.com self-storage unit auctions - browse active or upcoming lien/charity/manager-special auctions nationwide, filter by state, city, zip, category, unit size or keyword, look up specific auctions or facilities by ID, and track in-person live auction events.

- **URL**: https://apify.com/crawlerbros/storagetreasures-auctions-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, Real estate, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 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

## StorageTreasures Auctions Scraper

Scrape **StorageTreasures.com** — the largest self-storage unit auction marketplace in the US. Browse active and upcoming lien, manager-special, and charity auctions nationwide, filter by state, city, ZIP code, unit-content category, or keyword, look up a specific auction or facility by ID, or track in-person live auction events. No login, no cookies, no paid proxy required.

### What this actor does

- **Four modes:** `search` (browse & filter), `byAuctionIds` (direct lookup), `byFacilityId` (all units at one storage facility), `liveAuctions` (in-person auction events)
- **Filters:** auction status, auction type, unit-content category, keyword, state, city, ZIP code, current bid range, unit width/length range
- **Sorting:** ending soon, ending latest, newly listed, highest/lowest bid, most bids, most viewed, largest/smallest unit
- **Rich unit data:** pricing (current bid, minimum bid, reserve price, cleaning deposit, sales tax), bidding stats, unit size and contents description, photos
- **Facility & location data:** address, city/state/ZIP, GPS coordinates, payment options, and (via `byFacilityId`) phone, website, and business hours
- **Empty fields are omitted** — every record only contains fields that had real data

### Output per auction (mode = `search`, `byAuctionIds`, `byFacilityId`)

- `auctionId`, `auctionUrl`
- `status` (e.g. `Active`), `auctionType` (`Lien Unit` / `Non-Lien Unit / Manager Special` / `Charity Unit`), `auctionTypeId`
- `facilityId`, `facilityName`, `facilityUrl`
- `address`, `city`, `state`, `zipcode`, `country`, `latitude`, `longitude`
- `unitWidth`, `unitLength`, `unitVolume`, `unitSize`, `unitNumber`
- `unitContents` — seller's summary of what's inside
- `unitAdditionalNotes` — extended notes / auction house rules
- `categoryIds[]`, `categoryNames[]` — tagged item categories (furniture, tools, electronics, etc.)
- `currentBidAmount`, `initialBidAmount`, `minimumBidAmount`, `reservePriceAmount`, `cleaningDepositAmount`
- `salesTaxPercent`, `cleanoutTimeHours`, `paymentOptions`, `currencyCode`
- `totalBids`, `totalViews`, `uniqueViews`, `softClose`
- `postDateUtc`, `activeDateUtc`, `expireDateUtc`
- `isUpcoming`, `isExpired`, `daysRemaining`, `hoursRemaining`, `minutesRemaining`
- `imageThumbUrl`, `imageLargeUrl`, `imageGiantUrl`, `imageUrls[]` (full photo gallery, `byAuctionIds` only)
- `facilityPhone`, `facilityWebsite`, `facilityAccountName`, `facilityTimezone`, `facilityHours[]` (`byFacilityId` only)
- `facilityFeatures[]` — facility amenities (e.g. climate control, drive-up access, security cameras) (`byFacilityId` only)
- `facilityCharityStorage`, `facilityNoTax`, `facilityAddressVerified` (`byFacilityId` only)
- `recordType: "auction"`, `scrapedAt`

### Output per live auction event (mode = `liveAuctions`)

- `liveAuctionId`, `facilityId`, `facilityName`, `facilityUrl`
- `address`, `city`, `state`, `zipcode`, `latitude`, `longitude`, `phone`
- `paymentOptions`, `currencyCode`, `unitCount`, `isActive`
- `postDateUtc`, `expireDateUtc`
- `recordType: "liveAuction"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search` / `byAuctionIds` / `byFacilityId` / `liveAuctions` |
| `auctionStatus` | string | `active` | `active` or `upcoming` (mode=search) |
| `auctionIds` | array | – | Auction IDs to look up (mode=byAuctionIds) |
| `facilityId` | string | – | Facility ID (mode=byFacilityId) |
| `keyword` | string | – | Free-text search against unit contents (mode=search) |
| `auctionTypes` | array | – | Restrict to Lien / Non-Lien / Charity units (mode=search) |
| `categories` | array | – | Restrict to one or more item categories (mode=search) |
| `state` | string | – | Restrict to a single US state / territory |
| `city` | string | – | Restrict to a single city (exact match) |
| `zipcode` | string | – | Restrict to a single ZIP code |
| `minCurrentBid` / `maxCurrentBid` | int | – | Current bid range in USD |
| `minUnitWidth` / `maxUnitWidth` | int | – | Unit width range in feet |
| `minUnitLength` / `maxUnitLength` | int | – | Unit length range in feet |
| `sortBy` | string | `endingSoon` | Sort order (see enum for full list) |
| `maxItems` | int | `20` | Hard cap on emitted records (1–5000) |

#### Example: browse active auctions in Texas, ending soon

```json
{
  "mode": "search",
  "auctionStatus": "active",
  "state": "TX",
  "sortBy": "endingSoon",
  "maxItems": 50
}
````

#### Example: keyword search for vehicle-related units, highest bid first

```json
{
  "mode": "search",
  "keyword": "vehicle",
  "sortBy": "highestBid",
  "maxItems": 30
}
```

#### Example: look up specific auctions by ID

```json
{
  "mode": "byAuctionIds",
  "auctionIds": ["6433218", "6423881"]
}
```

#### Example: all current auctions at one facility

```json
{
  "mode": "byFacilityId",
  "facilityId": "117100"
}
```

#### Example: upcoming (coming-soon) furniture auctions under $50

```json
{
  "mode": "search",
  "auctionStatus": "upcoming",
  "categories": ["15"],
  "maxCurrentBid": 50,
  "maxItems": 50
}
```

### Use cases

- **Auction resellers / bargain hunters** — monitor new and ending-soon auctions across states without checking the site manually
- **Market research** — analyze bid prices, bidding activity, and unit categories by region
- **Facility comparison** — pull every open auction at a specific storage facility
- **Lead generation for liquidators** — filter by category (electronics, tools, vehicles) to find relevant inventory
- **Price tracking** — track how current bids move toward reserve price over time
- **Local auction discovery** — combine `state`/`city`/`zipcode` filters to build a regional watchlist

### Data source & limitations

This actor reads StorageTreasures' own publicly browsable auction data — the same data an anonymous visitor sees when browsing the site without an account. No login, cookies, or paid proxy are used or required to run this actor.

**Auction photo and page links are served from a US-restricted CDN.** StorageTreasures serves its website and auction photos through a CDN that only allows traffic from the United States. If you fetch `auctionUrl`, `facilityUrl`, or any `image*Url` field from outside the US (including some non-US Apify proxy exits), you may see an access-denied response — this is a restriction enforced entirely by StorageTreasures' own infrastructure, not by this actor. Viewing these URLs from within the US resolves normally. If you consistently need access from outside the US, route your own requests to these URLs through a US-based proxy or VPN.

**Location filters (`state`, `city`, `zipcode`) are applied to the full result set, not sent as a server-side search.** StorageTreasures' auction feed does not expose location as a server-side query parameter, so the actor fetches auction pages and filters by location locally. For common states/cities this resolves in a handful of requests; for very sparsely represented locations combined with a low `maxItems`, the actor may need to page through a larger portion of the nationwide feed before finding enough matches (it always stops cleanly once the full active/upcoming feed has been exhausted, never continuing indefinitely).

**Bidding, account, and watchlist features are out of scope.** This actor only reads listing data. Placing a bid, saving a search, joining a watchlist, or receiving notifications all require a StorageTreasures account and are unrelated to what this actor does.

### FAQ

**Is this affiliated with StorageTreasures?** No. This is an independent, third-party actor that reads StorageTreasures' own publicly browsable auction listings. It is not affiliated with, endorsed by, or supported by StorageTreasures or OpenTech Alliance.

**Do I need an account or to log in?** No. Browsing auction listings on StorageTreasures does not require an account — StorageTreasures' own help center confirms an account is only needed to place a bid. This actor only reads public listing data; it never bids.

**What's the difference between "active" and "upcoming" auctions?** Active auctions are open for bidding right now. Upcoming ("coming soon") auctions have been posted by the facility but bidding has not opened yet — useful for building a watchlist ahead of time.

**What's the difference between Lien, Non-Lien/Manager Special, and Charity units?** Lien units are auctioned because a tenant defaulted on rent. Non-Lien/Manager Special units are cleared out by facility managers for other reasons (abandonment, cleanup). Charity units donate proceeds to a cause.

**Why do some auctions have very few output fields?** Every field is only included when the facility actually populated it. A blank "additional notes" section or missing photo means the facility didn't provide one — the actor never fabricates placeholder values.

**Why is `imageUrls[]` (full gallery) only available via `byAuctionIds`?** The browse/search listing feed only returns one representative photo per unit; the full photo gallery is only returned when looking up a specific auction ID directly.

**Can I get a facility's phone number, website, or hours?** Yes — use `mode: "byFacilityId"` with the facility's ID. The browse/search modes only include the facility's name, address, and payment options.

**How fresh is the data?** Real-time — every run reads live data directly from the current listings; auction prices, bid counts, and countdowns reflect the moment the actor ran.

**Are auction end times in my local time zone?** All timestamps (`postDateUtc`, `activeDateUtc`, `expireDateUtc`) are returned in UTC (ISO-8601). Convert to your local time zone as needed.

**Does this actor place bids for me?** No. This actor only reads and returns publicly available listing data. Placing bids requires a StorageTreasures account, payment method, and using StorageTreasures' own website directly.

# Actor input Schema

## `mode` (type: `string`):

What to fetch.

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

Active auctions are currently open for bidding. Upcoming ("coming soon") auctions have been posted but bidding has not opened yet.

## `auctionIds` (type: `array`):

Numeric StorageTreasures auction IDs, e.g. `6433218`. Found in each auction's URL.

## `facilityId` (type: `string`):

Numeric StorageTreasures facility ID, e.g. `117100`. Found in the facility page URL (`/facilities/homepage/{id}`).

## `keyword` (type: `string`):

Free-text search against each unit's listed contents description (e.g. `furniture`, `tools`, `vehicle`).

## `auctionTypes` (type: `array`):

Restrict to one or more auction types. Leave empty for all types.

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

Restrict to units whose contents were tagged with one or more of these categories. Leave empty for all categories.

## `state` (type: `string`):

Restrict results to a single US state / territory.

## `city` (type: `string`):

Restrict results to a single city name (case-insensitive exact match, e.g. `Dallas`).

## `zipcode` (type: `string`):

Restrict results to a 5-digit US ZIP code (matches ZIP+4 listings too).

## `minCurrentBid` (type: `integer`):

Drop auctions whose current bid is below this amount.

## `maxCurrentBid` (type: `integer`):

Drop auctions whose current bid is above this amount.

## `minUnitWidth` (type: `integer`):

Drop units narrower than this width in feet.

## `maxUnitWidth` (type: `integer`):

Drop units wider than this width in feet.

## `minUnitLength` (type: `integer`):

Drop units shorter than this length in feet.

## `maxUnitLength` (type: `integer`):

Drop units longer than this length in feet.

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

Server-side sort order applied before filtering and pagination.

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

Hard cap on emitted records.

## Actor input object example

```json
{
  "mode": "search",
  "auctionStatus": "active",
  "auctionIds": [],
  "auctionTypes": [],
  "categories": [],
  "sortBy": "endingSoon",
  "maxItems": 20
}
```

# Actor output Schema

## `auctions` (type: `string`):

Dataset containing all scraped auctions / facilities / live auction events.

# 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 = {
    "mode": "search",
    "auctionStatus": "active",
    "auctionIds": [],
    "auctionTypes": [],
    "categories": [],
    "sortBy": "endingSoon",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/storagetreasures-auctions-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 = {
    "mode": "search",
    "auctionStatus": "active",
    "auctionIds": [],
    "auctionTypes": [],
    "categories": [],
    "sortBy": "endingSoon",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/storagetreasures-auctions-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 '{
  "mode": "search",
  "auctionStatus": "active",
  "auctionIds": [],
  "auctionTypes": [],
  "categories": [],
  "sortBy": "endingSoon",
  "maxItems": 20
}' |
apify call crawlerbros/storagetreasures-auctions-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "StorageTreasures Auctions Scraper",
        "description": "Scrape StorageTreasures.com self-storage unit auctions - browse active or upcoming lien/charity/manager-special auctions nationwide, filter by state, city, zip, category, unit size or keyword, look up specific auctions or facilities by ID, and track in-person live auction events.",
        "version": "1.0",
        "x-build-id": "RYxeBIzg6JronUDa5"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~storagetreasures-auctions-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-storagetreasures-auctions-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/crawlerbros~storagetreasures-auctions-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-storagetreasures-auctions-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/crawlerbros~storagetreasures-auctions-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-storagetreasures-auctions-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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "byAuctionIds",
                            "byFacilityId",
                            "liveAuctions"
                        ],
                        "type": "string",
                        "description": "What to fetch.",
                        "default": "search"
                    },
                    "auctionStatus": {
                        "title": "Auction status (mode=search)",
                        "enum": [
                            "active",
                            "upcoming"
                        ],
                        "type": "string",
                        "description": "Active auctions are currently open for bidding. Upcoming (\"coming soon\") auctions have been posted but bidding has not opened yet.",
                        "default": "active"
                    },
                    "auctionIds": {
                        "title": "Auction IDs (mode=byAuctionIds)",
                        "type": "array",
                        "description": "Numeric StorageTreasures auction IDs, e.g. `6433218`. Found in each auction's URL.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "facilityId": {
                        "title": "Facility ID (mode=byFacilityId)",
                        "type": "string",
                        "description": "Numeric StorageTreasures facility ID, e.g. `117100`. Found in the facility page URL (`/facilities/homepage/{id}`)."
                    },
                    "keyword": {
                        "title": "Keyword (mode=search)",
                        "type": "string",
                        "description": "Free-text search against each unit's listed contents description (e.g. `furniture`, `tools`, `vehicle`)."
                    },
                    "auctionTypes": {
                        "title": "Auction types (mode=search)",
                        "type": "array",
                        "description": "Restrict to one or more auction types. Leave empty for all types.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "1",
                                "2",
                                "3"
                            ],
                            "enumTitles": [
                                "Lien Unit",
                                "Non-Lien Unit / Manager Special",
                                "Charity Unit"
                            ]
                        },
                        "default": []
                    },
                    "categories": {
                        "title": "Unit content categories (mode=search)",
                        "type": "array",
                        "description": "Restrict to units whose contents were tagged with one or more of these categories. Leave empty for all categories.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "1",
                                "12",
                                "2",
                                "3",
                                "4",
                                "5",
                                "6",
                                "7",
                                "8",
                                "9",
                                "10",
                                "11",
                                "13",
                                "14",
                                "15",
                                "16",
                                "17",
                                "18",
                                "19",
                                "20",
                                "21",
                                "22",
                                "23",
                                "24",
                                "25",
                                "26",
                                "27",
                                "28",
                                "29",
                                "30"
                            ],
                            "enumTitles": [
                                "Appliances",
                                "Arms",
                                "Books",
                                "Boxes",
                                "Cabinets & Shelves",
                                "Clothing & Shoes",
                                "Collectibles",
                                "Computers",
                                "Dishes & Kitchenware",
                                "Documents & Files",
                                "Electronics",
                                "Food & Beverages",
                                "Health & Wellness",
                                "Heavy Equipment",
                                "Household Furniture",
                                "Jewelry",
                                "Lamps",
                                "Mattress & Bedding",
                                "Memorabilia",
                                "Mirrors",
                                "Motor Vehicles & Parts",
                                "Movies, Music & Books",
                                "New Merchandise",
                                "Office Equipment",
                                "Old Stuff",
                                "Personal Effects",
                                "Sports & Outdoors",
                                "Tools & Supplies",
                                "Toys, Baby & Games",
                                "Wall Art"
                            ]
                        },
                        "default": []
                    },
                    "state": {
                        "title": "State (mode=search)",
                        "enum": [
                            "AL",
                            "AK",
                            "AZ",
                            "AR",
                            "CA",
                            "CO",
                            "CT",
                            "DE",
                            "DC",
                            "FL",
                            "GA",
                            "HI",
                            "ID",
                            "IL",
                            "IN",
                            "IA",
                            "KS",
                            "KY",
                            "LA",
                            "ME",
                            "MD",
                            "MA",
                            "MI",
                            "MN",
                            "MS",
                            "MO",
                            "MT",
                            "NE",
                            "NV",
                            "NH",
                            "NJ",
                            "NM",
                            "NY",
                            "NC",
                            "ND",
                            "OH",
                            "OK",
                            "OR",
                            "PA",
                            "RI",
                            "SC",
                            "SD",
                            "TN",
                            "TX",
                            "UT",
                            "VT",
                            "VA",
                            "WA",
                            "WV",
                            "WI",
                            "WY",
                            "PR"
                        ],
                        "type": "string",
                        "description": "Restrict results to a single US state / territory."
                    },
                    "city": {
                        "title": "City (mode=search)",
                        "type": "string",
                        "description": "Restrict results to a single city name (case-insensitive exact match, e.g. `Dallas`)."
                    },
                    "zipcode": {
                        "title": "ZIP code (mode=search)",
                        "type": "string",
                        "description": "Restrict results to a 5-digit US ZIP code (matches ZIP+4 listings too)."
                    },
                    "minCurrentBid": {
                        "title": "Min current bid (USD)",
                        "minimum": 0,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Drop auctions whose current bid is below this amount."
                    },
                    "maxCurrentBid": {
                        "title": "Max current bid (USD)",
                        "minimum": 0,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Drop auctions whose current bid is above this amount."
                    },
                    "minUnitWidth": {
                        "title": "Min unit width (ft)",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Drop units narrower than this width in feet."
                    },
                    "maxUnitWidth": {
                        "title": "Max unit width (ft)",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Drop units wider than this width in feet."
                    },
                    "minUnitLength": {
                        "title": "Min unit length (ft)",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Drop units shorter than this length in feet."
                    },
                    "maxUnitLength": {
                        "title": "Max unit length (ft)",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Drop units longer than this length in feet."
                    },
                    "sortBy": {
                        "title": "Sort by (mode=search)",
                        "enum": [
                            "endingSoon",
                            "endingLatest",
                            "newlyListed",
                            "highestBid",
                            "lowestBid",
                            "mostBids",
                            "mostViewed",
                            "largestUnit",
                            "smallestUnit"
                        ],
                        "type": "string",
                        "description": "Server-side sort order applied before filtering and pagination.",
                        "default": "endingSoon"
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Hard cap on emitted records.",
                        "default": 20
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
