tcgplayer_search
Search TCGplayer’s trading-card catalog by product line, set, rarity, type, or price range to retrieve product IDs, market and listing prices, links, and filter facets.
Instructions
Search TCGplayer trading-card products. Searches TCGplayer's catalog of trading-card and collectible products (Pokemon, Magic, Yu-Gi-Oh!, One Piece, Lorcana and about 70 other product lines) and returns one page of matches: product id, name, set, rarity, card number, market, lowest and median prices, listing count, links and filter facets. Filter by product line, set, product type, rarity, card type and price range, and sort by price, listings, sales or name.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search text, up to 100 characters; optional when product_line is set | |
| set | No | Set url_name from tcgplayer-sets; needs product_line | |
| sort | No | Sort field; omit for relevance | |
| limit | No | Page size, 1 to 50; defaults to 24 | |
| order | No | Sort direction, needs sort; default desc (asc for product-name) | |
| offset | No | Results to skip; offset plus limit must be 9999 or less | |
| rarity | No | Exact rarity label such as Holo Rare; see facets.rarities | |
| card_type | No | Exact card type label such as Pokemon; see facets.card_types | |
| max_price | No | Maximum market price in US dollars | |
| min_price | No | Minimum market price in US dollars | |
| product_line | No | Product line url_name from tcgplayer-product-lines, for example pokemon, magic, yugioh | |
| product_type | No | Exact product type label such as Cards or Booster Box; see facets.product_types |