Card Ladder Graded Card Price Index Scraper

Scrape trending graded-card prices from Card Ladder — the card-investing industry's leading price index for sports and trading-card game collectibles.

What it does

Pulls Card Ladder's public "Ladder" price guide — the current top-trending cards per category — with real last-sale prices, Card Ladder's own current index value, population counts, and 30-day price movement. Covers all 11 categories Card Ladder tracks: Basketball, Baseball, Football, Hockey, Soccer, Pokemon, One Piece, Marvel, Wrestling, UFC, and Multi-Sport.

Input

Field	Type	Description
categories	array	Which category ladders to scrape. Leave empty to scrape all 11 categories.
maxItems	integer	Maximum number of card records to scrape across the selected categories.
resumeCursor	string	Cursor from a previous run's Output. Supply it to continue a large crawl without re-fetching — you are not re-charged for records already received.

Valid category values: Basketball, Baseball, Football, Hockey, Soccer, Pokemon, OnePiece, Marvel, Wrestling, UFC, MultiSport

Output

Each record represents one card at a specific grade:

{
  "card_name": "2016 Pokemon Japanese XY-P Promos Poncho-Wearing Pikachu #230/XY-P",
  "grade": "PSA 10",
  "card_url": "https://www.cardladder.com/ladder/card/2016-pokemon-japanese-xy-p-promos-poncho-wearing-pikachu-full-art-230-xy-p-psa-10",
  "last_sale_usd": 18600,
  "pct_change_30d": 14.46,
  "population": 2292,
  "index_value": 14640,
  "sales_volume": 15
}

• card_name — full card identity: year, set, player/character, and card number.
• grade — the grading company + grade for this specific listing (e.g. PSA 10, BGS 9.5), or Raw for ungraded cards.
• last_sale_usd — the most recent recorded public sale price for this card/grade.
• index_value — Card Ladder's own current price index value for this card/grade. This can differ from last_sale_usd — it reflects Card Ladder's smoothed valuation rather than a single data point.
• pct_change_30d — percent price change over the trailing 30 days.
• sales_volume — number of recorded public sales within Card Ladder's free 3-month sales window.
• population — grading-company population count for this card/grade. null for ungraded (Raw) cards, which have no population count to report.

Card Ladder's 6-month / 1-year / 2-year / all-time price-change figures are gated to paid subscribers and are not available to this actor — only the 30-day change is included.

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a run stops before finishing — because it hit maxItems, a spend cap, or was aborted — start a new run with the same input plus that resumeCursor to continue from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly the 10 most recent runs.
• resumeCursor is opaque — supply it unmodified.

Example inputs

Scrape all categories (default):

{
  "maxItems": 100
}

Scrape only Pokemon and Basketball trending cards:

{
  "categories": ["Pokemon", "Basketball"],
  "maxItems": 50
}

Resume a previous run:

{
  "categories": ["Pokemon", "Basketball"],
  "maxItems": 50,
  "resumeCursor": "<paste the resumeCursor from the previous run's Output>"
}

Notes

• Card Ladder's per-category ladder page surfaces a curated top-trending list (around 20 cards per category per run) rather than its full catalog — there is no publicly reachable pagination beyond that list.
• population is null for ungraded (Raw) card rows — Card Ladder does not report a population count for raw cards.