Heritage Auctions Scraper — Lots, Bids & Archive

Disclaimer: Unofficial tool — not affiliated with, sponsored by, or endorsed by Heritage Auctions or its affiliates. Data is read from publicly accessible search and lot pages only. No login. You are responsible for complying with applicable law (including GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

Heritage Auctions scraper for live lots and archive cards across coins, comics, sports, currency, art, and other departments. Each row has the lot title, auction number, grade when the card shows it, the public current bid, and an image. It works as a Heritage Auctions API alternative from Python, Node.js, or MCP. Archive “Sold For” lines that require sign-in stay empty and are marked priceVisibility: sign-in.

Collectibles suite

Actor	Role
Goldin Auctions Scraper	High-end sports and TCG live lots and sold comps
Fanatics Collect Scraper	Weekly and Premier auctions, Buy Now, sold comps
Heritage Auctions Scraper ◄── you are here	Heritage live bids and archive cards
eBay Sold Listings Scraper	Marketplace completed sales
Whatnot Listings Scraper	Live-commerce listings and shops
PriceCharting Scraper	Guide prices for games, TCG, and comics

Suite next step: Heritage archive cards often hide the hammer behind sign-in. For a realized price on the same title, run Goldin Auctions Scraper, then eBay Sold Listings Scraper for marketplace volume.

When to use

• Pull Heritage live bids for coins, comics, or sports cards before a session closes
• List archive lots (title, grade, sale date, image) when the public card is enough
• Open a handful of lot URLs for the public description and buyer’s premium percent
• Feed a pricing sheet that also uses Goldin and eBay sold comps

When not to use: realized Heritage hammers that the site shows only after sign-in. This Actor does not log in. Goldin or eBay sold is the next step for a public hammer.

Key features

• Live and archive — keyword search or a Heritage search URL
• Departments — coins, currency, sports, comics, jewelry, fine art, entertainment, historical, or all
• Public bid — currentBid when the card prints a dollar amount
• Sign-in prices marked — priceVisibility is sign-in instead of a guessed hammer
• Grade — service and grade from the card (NGC, PCGS, and similar)
• Optional lot page — description and buyer’s premium percent when fetchDetails is on

Input

Field	Description
searchQueries	Keywords. Each query is walked until maxItems
startUrls	Heritage search URLs or lot URLs
mode	live or archive
category	Department host used for keyword search
maxItems	Cap (1–200, default 25)
maxPages	Pages per search (default 1, about 25 lots)
fetchDetails	Open each lot page for description and premium. Default off
proxyConfiguration	US residential. Required for a real result page

Example — live coin bids

{
  "searchQueries": ["morgan dollar"],
  "mode": "live",
  "category": "coins",
  "maxItems": 25,
  "maxPages": 1
}

Example — sports archive cards

{
  "searchQueries": ["mickey mantle"],
  "mode": "archive",
  "category": "sports",
  "maxItems": 25
}

Output

Field	Meaning
lotId	{auctionId}-{lotNumber}
title	Lot title
auctionId / lotNumber	Sale and lot
currentBid	Public dollar amount, or null
priceVisibility	public, sign-in, or unknown
grade / service	From the card when present
saleLabel	Time left or the ended date
imageUrl	Thumbnail
url	Canonical lot URL
description	Only when a lot page was opened
buyersPremiumPct	Only when a lot page states it

{
  "lotId": "60575-54064",
  "auctionId": "60575",
  "lotNumber": "54064",
  "title": "2024 $1 Morgan Dollar, Advance Release, MS70 NGC.",
  "category": "Modern Commemoratives",
  "service": "NGC",
  "grade": "MS70",
  "currentBid": 55,
  "minimumBid": 60,
  "priceVisibility": "public",
  "currency": "USD",
  "status": "Live Auction in",
  "url": "https://coins.ha.com/itm/modern-commemoratives/2024-1-morgan-dollar-advance-release-ms70-ngc-pcgs-957343-/a/60575-54064.s"
}

Use cases

• A coin desk checks Heritage current bids on Morgan dollars before the session
• A card shop lists archive Mantle lots (grade, date, image) and prices the hammer from eBay sold
• A comic buyer drops specific lot URLs and keeps the public description

Integration examples

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/heritage-auctions-scraper').call({
  searchQueries: ['morgan dollar'],
  mode: 'live',
  category: 'coins',
  maxItems: 25,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 3));

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("crawloop/heritage-auctions-scraper").call(run_input={
    "searchQueries": ["mickey mantle"],
    "mode": "archive",
    "category": "sports",
    "maxItems": 25,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], item.get("currentBid"), item.get("priceVisibility"))

cURL

curl "https://api.apify.com/v2/acts/crawloop~heritage-auctions-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["morgan dollar"],"mode":"live","category":"coins","maxItems":20}'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call this Actor by name.

Example prompts:

• "Run Heritage Auctions Scraper in live mode for 'morgan dollar' in coins and return title, grade, and current bid"
• "List Heritage sports archive cards for 'mickey mantle' and flag rows whose price requires sign-in"
• "After Heritage live bids, run Goldin Auctions Scraper sold mode for the same titles"

FAQ

Is this a Heritage Auctions API alternative?
Yes for public search cards and public lot pages. There is no login and no partner API key.

Why is currentBid null on archive lots?
The public archive card often prints “Sold For” as a sign-in link. priceVisibility is sign-in. The Actor does not guess the hammer.

Does it need a proxy?
Yes. Use Apify Residential in the US. A datacenter IP gets a block page and zero rows.

What does fetchDetails add?
One extra page per lot: the public description and the buyer’s premium percent when the lot page states it. Leave it off for a faster bid list.