tcdb.com APItcdb.com ↗
Access TCDB trading card set listings, base checklists, and insert/parallel data by sport and year. 3 endpoints covering Football, Baseball, Basketball, and Hockey.
curl -X GET 'https://api.parse.bot/scraper/123aeda8-4611-4871-a592-2109a3f6434f/list_sets?year=2025&sport=Baseball' \ -H 'X-API-Key: $PARSE_API_KEY'
List all trading card sets for a specific year and sport. Returns an array of set summaries with set IDs that can be used with get_set_details and get_checklist.
| Param | Type | Description |
|---|---|---|
| year | string | Year to list sets for (e.g. '2025', '2024', '2023'). |
| sport | string | Sport name. Accepted values include Football, Baseball, Basketball, Hockey. |
{
"type": "object",
"fields": {
"sets": "array of set objects, each containing sid, name, url, sport, and year"
},
"sample": {
"data": {
"sets": [
{
"sid": "538963",
"url": "https://www.tcdb.com/ViewSet.cfm/sid/538963/2025-Donruss",
"name": "2025 Donruss",
"year": "2025",
"sport": "Football"
},
{
"sid": "529364",
"url": "https://www.tcdb.com/ViewSet.cfm/sid/529364/2025-Donruss-Elite",
"name": "2025 Donruss Elite",
"year": "2025",
"sport": "Football"
}
]
},
"status": "success"
}
}About the tcdb.com API
The TCDB API gives developers access to trading card set data across major sports through 3 endpoints. Use list_sets to browse sets by year and sport, get_set_details to retrieve base checklists alongside insert and parallel breakdowns, and get_checklist to pull every card in a set with number, player name, team, and special notations like rookie cards and short prints.
Set Discovery
The list_sets endpoint accepts optional year and sport parameters — valid sport values are Football, Baseball, Basketball, and Hockey — and returns an array of set objects. Each object includes a sid (set ID), name, url, sport, and year. That sid flows directly into the other two endpoints, so discovery is the natural starting point for any workflow.
Set Details and Insert/Parallel Checklists
get_set_details accepts a required sid and an optional limit_inserts integer. The response bundles three data structures: a metadata object with a freeform info string describing the set, a base_checklist array of card objects (each with number, name, team, and notations), and an inserts_and_parallels array where each entry carries its own sid, name, and nested cards array. The total_inserts_parallels integer tells you how many insert/parallel sets exist for the set, which matters when limit_inserts is lower than that total.
Full Checklist Retrieval
get_checklist takes a single required sid and returns the complete cards array for that set, with pagination handled automatically. Each card object exposes number, name, team, and notations. Notations capture designations such as rookie cards, short prints, and variations — structured details that are otherwise tedious to collect manually from set checklists.
- Build a personal card collection tracker that syncs set checklists by sport and year using
list_setsandget_checklist. - Identify all rookie card notations in a given set's base checklist for targeted collecting or valuation research.
- Enumerate insert and parallel sets for a specific release to map out the full product breakdown with
get_set_details. - Populate a card database application with structured player, team, and card-number data across multiple sports seasons.
- Compare insert and parallel counts across sets in the same year to analyze product complexity trends.
- Build a checklist completion app that shows which cards a user still needs from a given
sid. - Aggregate short print and variation notations across multiple Football or Baseball sets to flag scarcity for collectors.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TCDB offer an official developer API?+
What does the `notations` field on a card object contain?+
notations field carries designations associated with that specific card, such as rookie card markers, short print indicators, and variation labels. Not every card will have notations — the field reflects only the designations TCDB associates with that entry in its checklist.Can I retrieve card market prices or sale history through this API?+
How does `limit_inserts` affect the `get_set_details` response?+
limit_inserts caps how many insert/parallel checklists are fetched and included in the inserts_and_parallels array. The total_inserts_parallels field in the response always reflects the true total available for that set, so you can detect when the limit cut the list short and decide whether to raise it.Is player search or card-level search by player name supported?+
sid, year, and sport — there is no endpoint that accepts a player name and returns matching cards across sets. You can fork this API on Parse and revise it to add a player-search endpoint if cross-set lookup is needed.