# Heritage Auctions Scraper (`crawlerbros/heritage-auctions-scraper`) Actor Scrape Heritage Auctions (ha.com) - the world's largest collectibles auctioneer. Search live auction lots by keyword across coins, comics, fine art and sports collectibles, or browse a department directly, with price and auction-date filters. - **URL**: https://apify.com/crawlerbros/heritage-auctions-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 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 ## Heritage Auctions Scraper Scrape **Heritage Auctions** (ha.com) — the world's largest collectibles auctioneer, covering coins, currency, comics & comic art, fine art, sports collectibles, entertainment & music memorabilia, jewelry & timepieces, and historical Americana. Search live auction lots by keyword, browse a department directly, or pull each department's all-time top realized prices. No login, no API key. ### What this actor does - **Three modes:** `search` (keyword, optionally scoped to one department), `browseDepartment` (department listing, no keyword), `topRealizedPrices` (all-time top realized prices per department) - **Eight departments:** Coins, Currency & Paper Money, Comics & Comic Art, Fine Art, Sports Collectibles, Entertainment & Music Memorabilia, Jewelry & Timepieces, Historical & Americana - **Filters:** price range (USD), auction date range - **Grading detail:** grading service (PCGS/NGC/etc.) and grade, when the lot is certified - **Empty fields are omitted** ### Output per lot - `lotId` — Heritage's internal lot identifier - `auctionNumber`, `lotNumber` — the auction/sale and lot number - `title` — full lot description - `subcategory` — department sub-category (e.g. `Colonials`), when shown - `gradingService`, `grade`, `certNumber` — third-party grading info, when present - `status` — auction state (e.g. `Current Auctions`, `Sold / Prices Realized`) - `priceLabel`, `priceUSD` — the price label (`Current Bid` or `Realized`) and its dollar value - `minimumBidUSD` — minimum next-bid amount, when shown (live lots only) - `auctionDate` — the auction's date (`YYYY-MM-DD`), when shown - `imageUrl`, `imageUrlLarge` - `department` - `sourceUrl` — canonical lot page URL - `auctionUrl` — link to the full auction listing (live lots) - `recordType: "lot"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `browseDepartment` / `topRealizedPrices` | | `searchQuery` | string | `lincoln` | Free-text keyword (mode=search only) | | `department` | string | – | `coins` / `comics` / `art` / `sports` / `currency` / `entertainment` / `jewelry` / `historical` — required for `browseDepartment`, optional filter for `search` and `topRealizedPrices` (all departments if omitted) | | `minPriceUSD` / `maxPriceUSD` | number | – | Price range in USD (current bid, or realized price for `topRealizedPrices`) | | `saleDateFrom` / `saleDateTo` | string | – | Auction date range (`YYYY-MM-DD`), live lots only | | `maxItems` | int | `20` | Hard cap on emitted records (1–500) | | `proxyConfiguration` | object | AUTO | Apify proxy config (free AUTO/datacenter group is sufficient) | #### Example: keyword search in one department ```json { "mode": "search", "searchQuery": "lincoln", "department": "coins", "maxItems": 30 } ```` #### Example: keyword search across all departments ```json { "mode": "search", "searchQuery": "spider-man", "maxItems": 40 } ``` #### Example: browse a department with a price/date filter ```json { "mode": "browseDepartment", "department": "sports", "minPriceUSD": 100, "maxPriceUSD": 5000, "saleDateFrom": "2026-01-01", "maxItems": 25 } ``` #### Example: top all-time realized prices ```json { "mode": "topRealizedPrices", "department": "art" } ``` ### Use cases - **Collectors** — track specific coins, comics, art pieces, or sports memorabilia across upcoming auctions - **Price research** — gauge current bidding activity by keyword or department - **Market monitoring** — watch a department's live catalog for new listings within a budget - **Appraisal support** — cross-reference grading service and grade against current market interest - **Record-sale tracking** — pull each department's all-time highest realized prices for market context - **Content sites** — build "collectibles to watch" or "record-breaking sales" roundups from live and historical data ### Data source / limitations This actor reads Heritage Auctions' public, loginless department search pages (e.g. `coins.ha.com`, `comics.ha.com`) and the "Hall of Fame — Best Prices Realized" page per department. Live modes (`search`, `browseDepartment`) surface current auction listings (current bid, minimum next bid, auction date). `topRealizedPrices` surfaces each department's fixed, curated list of its all-time highest realized sales (verified: not keyword-filterable and not paginated beyond what the page itself shows — it's a leaderboard, not a general historical archive search). A broader searchable archive of every past sale is not exposed by Heritage's public site and is not covered by this actor. Heritage's site is protected by DataDome. The actor uses browser-fingerprint-matching HTTP requests (no headless browser needed), warms up each department session with a homepage visit before requesting search pages (verified necessary — a cold request straight to the search endpoint is blocked even with a matching browser fingerprint), and retries with session rotation on rate-limited responses. Sustained very-high-volume scraping from a single IP can still be throttled mid-run; Apify's proxy rotation between departments/sessions mitigates this. ### FAQ **Is this affiliated with Heritage Auctions?** No — this is an independent, third-party actor that reads publicly available auction listing pages. **Do I need an account, cookies, or API key?** No. All modes work anonymously. **Can I search realized/sold prices from past auctions by keyword?** Only within `topRealizedPrices`' fixed leaderboard, which is not keyword-searchable — it's each department's curated all-time top sales list. A general keyword search covers live/current listings (`search` mode). **Why do some lots have no `grade` or `gradingService`?** Not every lot is third-party graded (e.g. raw coins, many comics/art/sports/entertainment items); those fields are simply omitted rather than shown as empty. **Why do some lots have no `auctionDate`?** Some listing types (e.g. certain entertainment/memorabilia lots) show only a countdown ("2 days left") rather than a calendar date on the listing card; the field is omitted rather than guessed. **What does `priceLabel` mean?** It reflects whatever the site itself labels the shown price as — `Current Bid` for live lots, `Realized` for `topRealizedPrices` — so you can tell sale formats apart. **How fresh is the data?** Real-time for `search`/`browseDepartment` — every run reads the live site, so bid amounts reflect the moment of the run. `topRealizedPrices` reflects Heritage's own curated leaderboard, updated by Heritage as new record sales occur. **Why does `department` default to searching all departments?** Heritage runs each department as its own sub-site; leaving `department` empty fans the same request out across all eight to maximize recall. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text keyword search (mode=search), e.g. `lincoln`, `spider-man`, `mickey mantle`. ## `department` (type: `string`): Heritage Auctions department/category. Required for mode=browseDepartment; optional filter for mode=search and mode=topRealizedPrices (all departments if omitted). ## `minPriceUSD` (type: `number`): Drop lots priced below this (USD). Applies to current bid for search/browseDepartment, or realized price for topRealizedPrices. ## `maxPriceUSD` (type: `number`): Drop lots priced above this (USD). Applies to current bid for search/browseDepartment, or realized price for topRealizedPrices. ## `saleDateFrom` (type: `string`): Drop lots whose auction date is before this date. ## `saleDateTo` (type: `string`): Drop lots whose auction date is after this date. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## `proxyConfiguration` (type: `object`): Apify proxy (free AUTO/datacenter group is sufficient). ## Actor input object example ```json { "mode": "search", "searchQuery": "lincoln", "department": "", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `lots` (type: `string`): Dataset containing all scraped Heritage Auctions lots. # 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": "lincoln", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/heritage-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "searchQuery": "lincoln", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/heritage-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", "searchQuery": "lincoln", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/heritage-auctions-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/heritage-auctions-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Heritage Auctions Scraper", "description": "Scrape Heritage Auctions (ha.com) - the world's largest collectibles auctioneer. Search live auction lots by keyword across coins, comics, fine art and sports collectibles, or browse a department directly, with price and auction-date filters.", "version": "1.0", "x-build-id": "DmWCc7jVLH7Cs2bUG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~heritage-auctions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-heritage-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~heritage-auctions-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-heritage-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~heritage-auctions-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-heritage-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", "browseDepartment", "topRealizedPrices" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text keyword search (mode=search), e.g. `lincoln`, `spider-man`, `mickey mantle`.", "default": "lincoln" }, "department": { "title": "Department", "enum": [ "", "coins", "comics", "art", "sports", "currency", "entertainment", "jewelry", "historical" ], "type": "string", "description": "Heritage Auctions department/category. Required for mode=browseDepartment; optional filter for mode=search and mode=topRealizedPrices (all departments if omitted).", "default": "" }, "minPriceUSD": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000000, "type": "number", "description": "Drop lots priced below this (USD). Applies to current bid for search/browseDepartment, or realized price for topRealizedPrices." }, "maxPriceUSD": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000000, "type": "number", "description": "Drop lots priced above this (USD). Applies to current bid for search/browseDepartment, or realized price for topRealizedPrices." }, "saleDateFrom": { "title": "Sale date from (YYYY-MM-DD)", "type": "string", "description": "Drop lots whose auction date is before this date." }, "saleDateTo": { "title": "Sale date to (YYYY-MM-DD)", "type": "string", "description": "Drop lots whose auction date is after this date." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy (free AUTO/datacenter group is sufficient).", "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 } } } } } } } } } } ```