Heritage Auctions Sports Archive Scraper - Past Lots & Grades
Pricing
from $1.60 / 1,000 record scrapeds
Heritage Auctions Sports Archive Scraper - Past Lots & Grades
Scrape the Heritage Auctions sports past-results archive (sports.ha.com): lot titles, full descriptions, PSA/BGS/SGC/CGC grades, year, era, bid counts, sale dates and images. Search by player or keyword, or give lot URLs. Sale prices are members-only on Heritage and are not included.
Pricing
from $1.60 / 1,000 record scrapeds
Rating
0.0
(0)
Developer
BowTiedRaccoon
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
Scrape the Heritage Auctions sports past-results archive (sports.ha.com): lot titles, full descriptions, grading service and grade (PSA/BGS/SGC/CGC), year and era, category, bid counts, sale dates and images for sports cards and memorabilia. Search by player or keyword, or give specific lot URLs.
Sale prices are not included. Heritage shows the realized price, hammer price and estimates to signed-in members only, and this actor reads what a visitor sees without signing in.
What you get
Each result record contains:
| Field | Description |
|---|---|
lot_id | Heritage lot id: auction id and lot number joined by a dash |
lot_url | Lot page URL on sports.ha.com |
lot_number | Lot number within the auction |
auction_id | Heritage auction (sale) number |
auction_name | Auction name, e.g. "2024 August 23 - 25 Summer Platinum Night Sports Auction" |
title | Lot title as listed |
description | Full lot description |
category | Heritage category, e.g. "Baseball Cards" or "Boxing Collectibles" |
subcategory | Heritage sub-category, e.g. "Singles (1980-Now)" or "Uniforms" |
sport | Sport taken from the category, e.g. "Baseball" |
era | Era judged from the year in the title: pre-war / vintage / modern |
year | Year from the lot title |
card_number | Card number from the lot title, when it has one |
grader | Grading service named in the title: PSA / BGS / SGC / CGC / CSG / HGA / GAI, or raw |
grade | Grade as written in the title, e.g. "Gem Mint 10" |
grade_numeric | Numeric part of the grade, when the grade has one |
autograph | true if the title says the lot is signed or autographed |
memorabilia | true if the title describes game-used, worn or other memorabilia |
bid_count | Bids plus registered phone bidders on the lot |
buyers_premium_pct | Buyer's premium percentage of the auction |
sold_at | Sale date (YYYY-MM-DD) |
image_urls | Lot image URLs |
Fields that depend on the title (card_number, grader, grade, grade_numeric) are empty for lots whose title does not name them, such as memorabilia and ungraded items.
Input
| Parameter | Type | Description |
|---|---|---|
searchQueries | array | Keywords to search the archive for, e.g. ["mickey mantle"]. Each query is walked page by page until Max Items is met. |
lotUrls | array | Specific lot pages to fetch. Use together with, or instead of, Search Queries. |
sport | string | Keep only one sport: baseball, basketball, football, hockey, boxing, golf, soccer, olympics. Leave blank for all. |
era | string | Keep only one era: pre-war (before 1948), vintage (1948-1980), modern (1981 onward). Leave blank for all. |
maxItems | integer | Maximum lots to return. 0 = unlimited. Default: 200 |
Provide at least one of searchQueries or lotUrls.
Example: search for a player
Example: only modern hockey lots
Example: fetch specific lots
Notes
- Raise the run's memory to fetch faster: a larger run reads several lots at once.
- The era is a label derived from the year in the lot title, so a lot with no year in its title has no era.
- Lots Heritage has removed are skipped.
