Graded Card Census Scraper

Look up graded trading card population data — single cards or entire sets. Get the full grade breakdown (Auth through Gem Mint 10) for every card in a set with a single request.

Disclaimer: This tool is not affiliated with, endorsed by, or sponsored by PSA or Collectors Universe. "PSA" is a registered trademark of Collectors Universe, Inc. and is used here solely for identification purposes.

Features

• Bulk set lookup: Get population data for ALL cards in a set at once (e.g., all 397 cards in Surging Sparks)
• Set search: Find sets by name — just enter "Surging Sparks" and get full population data
• Cert lookup: Enter a certification number to get card details and population report
• Spec ID lookup: Direct population lookup by spec ID
• Full grade breakdown: Auth, grades 1-10, half grades (1.5, 2.5, etc.), and qualifier counts

Input

Field	Type	Description
setUrl	string	Set population page URL for bulk lookup
setName	string	Search for a set by name (e.g., "Surging Sparks", "2023 Topps Chrome")
certNumber	string	Certification number for single card lookup
specID	integer	Spec ID for direct population lookup
apiToken	string	Optional API token (only needed for cert/specID lookups)

Provide one of: setUrl, setName, certNumber, or specID.

Examples

Bulk Set Lookup (recommended)

Get all cards in a set by URL:

{
  "setUrl": "https://www.psacard.com/pop/tcg-cards/2024/pokemon-ssp-en-surging-sparks/285178"
}

Search by set name:

{
  "setName": "Surging Sparks"
}

Single Card Lookup

{
  "certNumber": "12345678"
}

Output

Bulk Set Results

Each card in the set is returned as a separate item:

{
  "specID": 12168745,
  "cardNumber": "240",
  "subject": "Hydreigon EX",
  "variety": "Special Illustration Rare",
  "setName": "2024 Pokemon Ssp EN-Surging Sparks",
  "year": "2024",
  "psaPop": {
    "total": 8849,
    "auth": 1,
    "grade1": 0,
    "grade2": 0,
    "grade3": 1,
    "grade4": 5,
    "grade5": 23,
    "grade6": 29,
    "grade7": 61,
    "grade8": 785,
    "grade8_5": 20,
    "grade9": 4610,
    "grade10": 3334
  },
  "halfGradeTotal": 20,
  "qualifiedGradeTotal": 0
}

Single Card Results

Includes additional cert-specific fields: grade, brand, category, label type, and population-higher counts.

Use Cases

• Card investors: Analyze the full population of a set to find scarce cards
• eBay sellers: Add census data to listings in bulk
• Price guide sites: Build population databases for entire card sets
• Collection tracking: Compare your collection against full set population data
• Market research: Track grading volume trends across sets

Related Scrapers

More marketplace scrapers and data tools by lulzasaur:

• TCGPlayer Scraper — Trading card prices
• Reverb Scraper — Music gear marketplace
• OfferUp Scraper — Local marketplace listings
• Craigslist Scraper — Classifieds and for-sale posts
• Goodreads Scraper — Book ratings and reviews
• Grailed Scraper — Luxury fashion resale
• StubHub Scraper — Event ticket prices
• Redfin Scraper — Real estate listings and prices