# AuctionZip Auction & Auctioneer Directory Scraper (`crawlerbros/auctionzip-scraper`) Actor Scrape AuctionZip.com - search live and upcoming auctions by keyword, category or zip code, browse auctions by US state, or pull an auctioneer's current listings. - **URL**: https://apify.com/crawlerbros/auctionzip-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, E-commerce, Developer tools - **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 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 ## AuctionZip Scraper Scrape **AuctionZip.com** — the largest directory of local auction houses in the US. Search live and upcoming auctions by keyword, category or ZIP code, browse auctions near any US state, or pull an auctioneer's current listings by profile URL. Covers AuctionZip's full category taxonomy — antiques, farm & agricultural, automobiles, real estate, coins, jewelry, militaria, and 25+ more. HTTP-only, no login, no API key. ### What this actor does - **Three modes:** `search` (keyword / category / ZIP + radius), `byState` (browse auctions near a US state), `byAuctioneer` (an auctioneer's current listings) - **36 real categories** — AuctionZip's full broad + niche taxonomy, from "Antiques, Household & Collectibles" to "Vintage Guitars" - **All 50 US states + DC** for state-level browsing - **Radius search** — 30 to 500 miles, or nationwide - **Empty fields are omitted** — every record only contains what AuctionZip actually published for that listing ### Output per auction listing - `listingId` — AuctionZip's internal listing ID - `title` — auction title - `description` — auction description / catalog highlights - `auctioneerName` — the auction house or seller running the sale - `auctionDate` — ISO date (`YYYY-MM-DD`) of the auction - `auctionTime` — start time as published (e.g. `09:30AM`) - `city`, `state` — auction location - `categoryTags` — AuctionZip category label(s) attached to the listing - `thumbnailUrl` — listing preview image, when AuctionZip has one on file - `sourceUrl` — canonical AuctionZip listing URL - `searchCategory`, `searchKeyword`, `searchZip` / `searchState`, `searchStateName` — the filter that produced the record - `recordType: "auctionListing"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `byState` / `byAuctioneer` | | `searchQuery` | string | `antique` | Keyword to match in title/description (mode=search, mode=byState) | | `category` | string | `all` | One of AuctionZip's 36 real categories | | `zipCode` | string | – | 5-digit US ZIP code (mode=search) | | `radius` | string | `0` (Anywhere) | Search radius in miles: `30`/`50`/`100`/`150`/`200`/`250`/`500`/`0` | | `state` | string | – | 2-letter US state code (mode=byState) | | `auctioneerUrls` | array | – | AuctionZip auctioneer profile URLs (mode=byAuctioneer) | | `maxItems` | int | `30` | Hard cap on emitted listings (1–500) | | `proxyConfiguration` | object | AUTO | Apify proxy configuration | #### Example: keyword search nationwide ```json { "mode": "search", "searchQuery": "antique", "category": "all", "maxItems": 30 } ```` #### Example: farm equipment auctions near a ZIP code ```json { "mode": "search", "category": "farm", "zipCode": "50309", "radius": "100", "maxItems": 50 } ``` #### Example: browse auctions by state ```json { "mode": "byState", "state": "TX", "category": "all", "maxItems": 25 } ``` #### Example: an auctioneer's current listings ```json { "mode": "byAuctioneer", "auctioneerUrls": ["https://www.auctionzip.com/CA-Auctioneers/253285.html"] } ``` ### Use cases - **Auction discovery** — find upcoming estate, farm, or coin auctions near you - **Auctioneer research** — pull a specific auction house's current listing catalog - **Market monitoring** — track antiques, collectibles, or real-estate auction volume by category - **Real estate & liquidation sourcing** — surface commercial/industrial and real-estate auctions nationwide - **Lead generation** — build a list of active auction houses by state or category ### FAQ **What is the data source?** AuctionZip.com, a public directory of live and online auctions and auction houses across the US. **Do I need an AuctionZip account?** No. All listing data returned by this actor is publicly visible on AuctionZip without logging in. **Why do some listings have no thumbnail?** AuctionZip only shows a preview image when the auctioneer uploaded one; listings without a photo omit `thumbnailUrl` rather than returning a placeholder image. **What does the `byState` mode actually search?** AuctionZip doesn't publish a full per-state listing directory page, so `byState` runs a ZIP + radius search centered on that state's largest metro area — the same mechanism the site's own search box uses. **How current is the data?** Listings reflect what's live on AuctionZip at the time the actor runs — auctions are added and removed by auctioneers continuously. **Is this affiliated with AuctionZip?** No, this is an independent third-party actor that reads AuctionZip's public pages. **Can I filter by category and location at the same time?** Yes — `category`, `zipCode`, and `radius` all combine in `search` mode. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text keyword to match in auction titles/descriptions (mode=search, mode=byState). ## `category` (type: `string`): Restrict to one of AuctionZip's real category taxonomies (mode=search, mode=byState). ## `zipCode` (type: `string`): 5-digit US ZIP code to search around. Leave blank to search nationwide. ## `radius` (type: `string`): Distance from the ZIP code to search within (mode=search). Ignored if no ZIP is given. ## `state` (type: `string`): Browse auctions located near this US state. ## `auctioneerUrls` (type: `array`): AuctionZip auctioneer profile URLs, e.g. `https://www.auctionzip.com/CA-Auctioneers/253285.html`. ## `maxItems` (type: `integer`): Hard cap on emitted auction listings. ## `proxyConfiguration` (type: `object`): AuctionZip is Cloudflare-protected; the free AUTO datacenter proxy group is used to keep requests reliable. ## Actor input object example ```json { "mode": "search", "searchQuery": "antique", "category": "all", "radius": "0", "auctioneerUrls": [], "maxItems": 30, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `listings` (type: `string`): Dataset containing all scraped AuctionZip listings. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "searchQuery": "antique", "category": "all", "radius": "0", "auctioneerUrls": [], "maxItems": 30, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/auctionzip-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "searchQuery": "antique", "category": "all", "radius": "0", "auctioneerUrls": [], "maxItems": 30, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/auctionzip-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", "searchQuery": "antique", "category": "all", "radius": "0", "auctioneerUrls": [], "maxItems": 30, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/auctionzip-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/auctionzip-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AuctionZip Auction & Auctioneer Directory Scraper", "description": "Scrape AuctionZip.com - search live and upcoming auctions by keyword, category or zip code, browse auctions by US state, or pull an auctioneer's current listings.", "version": "1.0", "x-build-id": "ShIKbVXILSUDTnkOi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~auctionzip-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-auctionzip-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~auctionzip-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-auctionzip-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~auctionzip-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-auctionzip-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", "byState", "byAuctioneer" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Keyword", "type": "string", "description": "Free-text keyword to match in auction titles/descriptions (mode=search, mode=byState).", "default": "antique" }, "category": { "title": "Category", "enum": [ "all", "antiques", "farm", "auto", "commercial", "benefit", "equipment", "onlinebidding", "newmerchandise", "storage", "wholesale", "realestateland", "realestatecommercial", "realestateresidential", "realestatefarm", "realestate", "coin", "gun", "civilwar", "furniture", "train", "doll", "toy", "art", "restaurantequipment", "antiquefurniture", "hummels", "policeauctions", "vintageclothing", "vintageguitars", "ephemera", "jewelry", "militaria", "recreation", "liquidation", "sports" ], "type": "string", "description": "Restrict to one of AuctionZip's real category taxonomies (mode=search, mode=byState).", "default": "all" }, "zipCode": { "title": "ZIP code (mode=search)", "type": "string", "description": "5-digit US ZIP code to search around. Leave blank to search nationwide." }, "radius": { "title": "Search radius (miles)", "enum": [ "0", "30", "50", "100", "150", "200", "250", "500" ], "type": "string", "description": "Distance from the ZIP code to search within (mode=search). Ignored if no ZIP is given.", "default": "0" }, "state": { "title": "US State (mode=byState)", "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" ], "type": "string", "description": "Browse auctions located near this US state." }, "auctioneerUrls": { "title": "Auctioneer profile URLs (mode=byAuctioneer)", "type": "array", "description": "AuctionZip auctioneer profile URLs, e.g. `https://www.auctionzip.com/CA-Auctioneers/253285.html`.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted auction listings.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "AuctionZip is Cloudflare-protected; the free AUTO datacenter proxy group is used to keep requests reliable.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```