🃏 Courtyard.io Scraper

🎯 Extract every graded card, sealed pack, comic and coin from Courtyard.io — with live prices, PSA/CGC/BGS grades, fair-market-value estimates and deal scores — in seconds.

Courtyard.io is the fastest-growing marketplace for tokenized physical collectibles: graded Pokémon and sports cards, sealed booster packs, graded comic books, coins and watches, all vaulted and insured. This scraper pulls the entire marketplace — asking prices, last sales, grading details, estimated market values, owner info and high-resolution slab images — into clean, structured data you can analyze, monitor or feed into your own tools.

🚀 What Does It Do?

This scraper automatically searches and browses the Courtyard.io marketplace and collects structured, ready-to-use data on every collectible asset it finds. No manual browsing needed — just set your filters and hit Start.

💡 Two modes of operation:

1. 🔍 Discovery Mode — search by keywords (e.g. "Charizard", "Michael Jordan") and/or filter by category, grading company, grade, language, set, year and price range
2. 📋 Direct URL Mode — paste specific asset URLs (https://courtyard.io/asset/…) and get their full data instantly

👥 Who Is This For?

🏢 Use Case	💬 How It Helps
📊 Card investors & flippers	Spot assets priced under their estimated market value before anyone else — the deal score and price-vs-value fields do the math for you
🔎 Collectors	Track every listing of the cards you hunt — get notified the moment a new copy appears or a price drops
📈 Market analysts	Build price datasets across 300,000+ graded collectibles: grade premiums, population trends, prices by set and year
🤖 App & tool builders	Feed clean marketplace data into price trackers, Discord bots, portfolio dashboards or AI agents
🏪 Card shops & dealers	Benchmark your inventory pricing against a live marketplace with fair-market-value estimates

✨ Features

• 🃏 Full marketplace coverage — graded cards, sealed booster packs, raw cards, comics, coins and watches — 300,000+ assets
• 💰 Complete pricing picture — asking price, estimated market value, confidence level, deal score and price-vs-value percentage on every asset
• 🏅 Grading data — grading company (PSA, CGC, BGS, SGC and more), grade label, numeric grade and certification number
• 🔍 Keyword search — find assets by player, character, set or any phrase, exactly like the site's search
• 🎛️ Smart Filters — category, product type, grader, exact grade or minimum grade, language, set, tags, year range and price range
• 💎 Deal hunting mode — keep only assets priced under a chosen percentage of their estimated value, or sort by best deals
• 📊 Live sales feed — sort by "recently sold" to turn any run into a feed of completed sales
• 👤 Ownership & provenance — owner username, wallet address and owned-since date on every asset
• 🔄 Incremental monitoring — schedule recurring runs that emit only NEW / UPDATED / REAPPEARED assets and pay only for changes (saves 80–95% on daily monitoring)
• 🔔 Instant notifications — get new finds pushed to Telegram, Discord, Slack or any webhook
• ⚡ Fast & Scalable — thousands of assets per minute, and no artificial result caps — the scraper automatically digs past the site's 5,000-per-search ceiling
• 🧹 Deduplication — every asset appears exactly once per run
• 📤 Export Anywhere — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

🎛️ Filters & Options

Option	What It Does
🔍 Search keywords	Find assets by any phrase — player, character, set, promo name
🗂️ Sort by	Recently listed, recently sold (sales feed!), recently added, price low→high / high→low, or best deals
🃏 Categories	Pokémon, Baseball, Basketball, Football, One Piece, Magic The Gathering, Yu-Gi-Oh! and 20+ more
📦 Collections	Graded cards, sealed booster packs, raw cards, comic books, coins, watches
🏅 Grading companies	PSA, CGC, BGS, SGC, PCGS, NGC and more
💯 Exact grades / Minimum grade	Pin exact grade labels or set a numeric floor (e.g. only 9+)
🌍 Card languages	English, Japanese, Chinese, Korean and more
🎴 Sets & Tags	Narrow down to exact sets or marketplace tags (e.g. "Charizard" + "Holo")
📅 Year range	Only assets released between chosen years
💵 Price range (USD)	Lower and upper bounds on the asking price
🛒 Listed for sale only	Include or exclude vaulted assets that aren't currently for sale
💎 Max price vs. value (%)	Deal hunting — keep only assets priced under X% of their estimated value
👤 Owner	Only assets owned by a given username or wallet
🔢 Max Results	Control how many items to extract per run
🔗 Direct URLs	Optionally provide specific asset URLs to scrape

📦 What You Get (Output Fields)

Every asset includes:

Asset Identity

Field	Example
assetId	63c6401c0b8f840c51baabb735d5342f55320e531ac2376b43e193e43b779ff8
title	2017 Black Star Promos #SWSH050 Charizard V - Holo (CGC 8.5 NM-MT+)
url	https://www.courtyard.io/asset/63c6401c…
collection	Graded Cards
category	Pokémon
set	Black Star Promos - Sword & Shield
year	2017
cardNumber	SWSH050
variant	Holo Champion's Path Elite Trainer Box
subject	Charizard V
language	English
imageUrl	https://static.courtyard.io/graded-cards-renders/CGC%203831074181/nft_image.jpg

Grading

Field	Example
grader	CGC
grade	8.5 NM-MT+
gradeNumeric	8.5
certNumber	3831074181

Pricing & Valuation

Field	Example
isListed	true
priceUsd	22.5
priceCurrency	USDC
estimatedValueUsd	18.7
estimatedValueConfidence	5
dealScore	-20.32
priceVsValuePct	120
listingExpiration	2026-07-13T11:37:10Z
lastSaleDate	2026-05-28T22:30:08Z

Ownership & Provenance

Field	Example
ownerUsername	simplecolossus3483
ownerAddress	0x6bb54a0192874DcfbB3780D6081f47B1afd2C0f3
ownedSince	2026-05-28T22:30:08.000Z
chain	polygon
mintedAt	2026-05-28T22:30:08Z
listedAt	2026-07-06T11:37:17Z

📊 Example Output

{
    "assetId": "63c6401c0b8f840c51baabb735d5342f55320e531ac2376b43e193e43b779ff8",
    "title": "2017 Black Star Promos - Sword & Shield #SWSH050 Charizard V - Holo Champion's Path Elite Trainer Box (CGC 8.5 NM-MT+)",
    "url": "https://www.courtyard.io/asset/63c6401c0b8f840c51baabb735d5342f55320e531ac2376b43e193e43b779ff8",
    "collection": "Graded Cards",
    "category": "Pokémon",
    "set": "Black Star Promos - Sword & Shield",
    "year": 2017,
    "cardNumber": "SWSH050",
    "variant": "Holo Champion's Path Elite Trainer Box",
    "subject": "Charizard V",
    "language": "English",
    "grader": "CGC",
    "grade": "8.5 NM-MT+",
    "gradeNumeric": 8.5,
    "certNumber": "3831074181",
    "isListed": true,
    "priceUsd": 22.5,
    "priceCurrency": "USDC",
    "estimatedValueUsd": 18.7,
    "estimatedValueSource": "pricing_model",
    "estimatedValueConfidence": 5,
    "dealScore": -20.32,
    "priceVsValuePct": 120,
    "listingExpiration": "2026-07-13T11:37:10Z",
    "ownerUsername": "simplecolossus3483",
    "ownerAddress": "0x6bb54a0192874DcfbB3780D6081f47B1afd2C0f3",
    "ownedSince": "2026-05-28T22:30:08.000Z",
    "chain": "polygon",
    "imageUrl": "https://static.courtyard.io/graded-cards-renders/CGC%203831074181/nft_image.jpg",
    "tags": ["Pokémon", "Charizard V", "English", "Holo"],
    "listedAt": "2026-07-06T11:37:17Z",
    "lastSaleDate": "2026-05-28T22:30:08Z",
    "scrapedAt": "2026-07-06T12:09:37.022Z"
}

📋 Dataset Views

The Apify Console gives you 5 ready-made table views to quickly browse your results:

View	What It Shows
📊 Overview	Image, title, price, estimated value, grade and category at a glance
💎 Deals	Price vs. estimated value, deal score and confidence — sorted deal hunting
🔄 Monitoring	What changed since the last run — new, updated and reappeared assets
🏅 Grading & Provenance	Certification numbers, owners, wallets and mint dates
📋 Full Details	Every single field — the complete dataset

❓ FAQ

🤔 How is this different from browsing Courtyard.io myself? You get the entire marketplace as structured data in one run — filter, sort and analyze 300,000+ assets in Excel or your own tools instead of clicking through pages. Plus monitoring mode watches it for you around the clock.

🤔 Can I track price drops and new listings automatically? Yes — turn on incremental monitoring and schedule the scraper. Each run emits only what changed (new listings, price changes, sales), and can ping you on Telegram, Discord, Slack or any webhook.

🤔 Can I get sold prices, not just asking prices? Yes — set "Sort by" to Recently sold and every run becomes a feed of the latest completed sales, including the sale date and last price.

🤔 Is there a limit on how many assets I can extract? No — the scraper automatically works past the site's 5,000-per-search ceiling, so even a full-marketplace export is possible.

🤔 Can I export the data? Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

🤔 How often should I run this? For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks — with monitoring mode on, recurring runs cost a fraction of a full scrape.

🤔 Does it work with proxies? It works reliably without any proxy out of the box. If you ever need one, the scraper supports Apify's built-in proxy service with a single toggle.

🛠️ Need Custom Filters or Features?

I'm happy to customize this scraper for your specific needs! 🤝

Whether you need:

• 🎯 Additional filters (specific cert-number lists, seller watchlists, deal-alert thresholds)
• 📊 Extra data fields or custom output formats
• 🔄 Integration with your CRM, Google Sheets, or database
• ⏰ Scheduled scraping with automatic deduplication
• 🌐 Scraping from other collectibles marketplaces alongside Courtyard.io

👉 Don't hesitate to reach out via private message — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

⚖️ Legal & Ethical Use

This scraper collects only publicly available information from Courtyard.io. It does not access private data, bypass authentication, or interfere with the marketplace's operation. Please use the data responsibly and in compliance with applicable laws and platform terms of service.