Crawlsmith

Courtyard.io Scraper

Scrape Courtyard.io — the tokenized collectibles marketplace. Graded Pokémon & sports cards, packs, comics and coins with prices, PSA/CGC/BGS grades, fair-market-value estimates, deal scores and owner data. Filter by category, grader, grade, price and year, and run cheap incremental monitoring.

What it does

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 uses it

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

Input

38 options. Required ones are marked.

Option What it does
Search keywords What to search for (e.g. "Charizard", "Michael Jordan", "1st Edition").
Sort by Ordering of results.
Categories Limit results to one or more categories (sport / game / franchise).
Collections Limit results to one or more product types.
Grading companies Only assets graded by these companies.
Exact grades Only assets with these exact grade labels (e.g. "10 GEM MT", "9.5", "8.5 NM-MT+").
Minimum grade Keep only assets graded at least this number (1–10).
Card languages Only cards printed in these languages.
Sets Only assets from these exact sets (e.g. "Base Set", "Black Star Promos - Sword & Shield").
Tags Narrow results by marketplace tags — every tag must match (e.g. "Charizard" + "Holo").
Year from Earliest release year (0 = no limit).
Year to Latest release year (0 = no limit).
Minimum price (USD) Lower bound of the asking price, in US dollars.
Maximum price (USD) Upper bound of the asking price, in US dollars (0 = no limit).

Plus 24 more options. Full input reference on Apify.

Output fields

35 fields, grouped the way the dataset views show them. Export to JSON, CSV, Excel or pull them through the API.

Overview

  • Image
  • Title
  • Price (USD)
  • Est. value (USD)
  • Grader
  • Grade
  • Category
  • Year
  • URL

Deals

  • Title
  • Price (USD)
  • Est. value (USD)
  • Price vs. value %
  • Deal score
  • Confidence
  • Last sale
  • URL

Monitoring

  • Change
  • Title
  • Price (USD)
  • Est. value (USD)
  • First seen
  • Last seen
  • Repost
  • URL

Grading & Provenance

  • Title
  • Grader
  • Grade
  • Cert #
  • Owner
  • Wallet
  • Owned since
  • Minted
  • URL

Full Details

  • assetId
  • title
  • collection
  • category
  • set
  • year
  • cardNumber
  • variant
  • subject
  • language
  • grader
  • grade
  • gradeNumeric
  • certNumber
  • isListed
  • priceUsd
  • priceCurrency
  • estimatedValueUsd
  • priceVsValuePct
  • dealScore
  • ownerUsername
  • ownerAddress
  • chain
  • imageUrl
  • listedAt
  • lastSaleDate
  • url
  • scrapedAt

Example output

One record, shortened. Real runs return one row like this per result.

{
  "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"
  ],
  "listedAt": "2026-07-06T11:37:17Z",
  "lastSaleDate": "2026-05-28T22:30:08Z",
  "scrapedAt": "2026-07-06T12:09:37.022Z"
}

How to run it

  1. 1. Open the scraper on Apify and sign in (free plan works).
  2. 2. Fill in the input: search terms, URLs or filters, and a result limit.
  3. 3. Run it, then download JSON, CSV or Excel, or pull the dataset through the API.
  4. 4. Schedule it to get fresh data daily or weekly.

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.

What happens when my search finds nothing? +

The run still succeeds and the dataset gets one informational record per search or asset URL (noResults: true) explaining why — e.g. the filters were too narrow, or the post-filters removed everything. If the problem is on the site's side instead (every request errors, or even an unfiltered marketplace browse returns nothing), the run is marked FAILED with the reason, so a scheduled run never "succeeds" silently with an empty dataset.

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 something this scraper does not do?

Extra fields, a different filter, a recurring feed into your database or a one-off bulk export.

Ask for a custom version

Related scrapers