GET/tcgplayer/filtersapiKey1 credit/request
Returns the values the tcgplayer-sales filters accept for one TCGplayer product line: the printings (variants such as Normal, Foil, Holofoil or 1st Edition), the six conditions, the languages and the listing types, each with TCGplayer's id. Printings belong to one product line (Pokemon has Reverse Holofoil, Magic has Foil), while languages are shared. Give product_line (a url_name from tcgplayer-product-lines) or id (a TCGplayer product id, which uses that product's line). An unknown product line returns invalid parameters and an unknown product returns not found.
Optional: product_line, id.
Sampled 26 Oct 2026: 7 items. Filled in every item: id, name. In the sample: name: “Normal” and 6 other values.
Open in Playground
GET/tcgplayer/listingsapiKey1 credit/request
Returns one page of the current seller listings for a TCGplayer product: seller storefront name, rating and sales volume, condition, printing, language, quantity, price, shipping price and seller location. Filter by condition, printing and language, and sort by price or price with shipping.
Required: id. Optional: condition (5 allowed values: near-mint, lightly-played, moderately-played, heavily-played, damaged), printing, language, sort (2 allowed values: price, price-with-shipping), order (2 allowed values: asc, desc), limit, offset.
Sampled 26 Oct 2026: 5 items. Filled in every item: listing_id, seller_name, seller_rating, seller_sales, gold_seller, verified_seller, direct_seller, condition and 9 more. In the sample: condition: Lightly Played (3), Moderately Played (1), Damaged (1); seller_rating: 99.8 to 100, median 100; gold_seller: true in 5 of 5; verified_seller: true in 4 of 5; direct_seller: true in 3 of 5; printing: Normal (4), Foil (1); quantity: 1 to 3, median 2; price: 0.2 to 2.67, median 0.59.
Open in Playground
GET/tcgplayer/price-guideapiKey2 credits/request
Returns TCGplayer's price guide for one set, one row per card, condition and printing: card id, name, collector number, rarity, condition, printing, language, low price, market price and units sold. Page through a whole set (up to 500 rows per call) instead of fetching each card; the set_id comes from tcgplayer-sets.
Required: set_id. Optional: limit, offset.
Open in Playground
GET/tcgplayer/price-historyapiKey1 credit/request
Returns a TCGplayer product's price history over a month, quarter, half year or year, per condition, printing and language: market price, quantity sold, transaction count and low/high sale price for each period, plus the average daily sales volume.
Required: id. Optional: range (4 allowed values: month, quarter, semi-annual, annual).
Open in Playground
GET/tcgplayer/product-linesapiKey1 credit/request
Lists TCGplayer's product lines (games and product families such as Pokemon, Magic: The Gathering, Yu-Gi-Oh!, One Piece and Lorcana): id, name and the url_name that tcgplayer-search and tcgplayer-sets take as product_line.
Takes no parameters.
Sampled 26 Oct 2026: 71 items. Filled in every item: id, name, url_name, direct. In the sample: name: “Magic: The Gathering” and 70 other values; direct: true in 3 of 71; url_name: “magic” and 70 other values.
Open in Playground
GET/tcgplayer/productapiKey2 credits/request
Returns one TCGplayer product in full: name, product line, set, rarity, card number, card text, attributes, the market, lowest and median prices, listing and seller counts, every purchasable condition/variant/language SKU, and TCGplayer's market and buylist price per printing.
Required: id.
Sampled 26 Oct 2026: 110 items. Filled in every item: sku, condition, variant, language. In the sample: condition: Near Mint (22), Lightly Played (22), Moderately Played (22) and 2 more; language: “English” and 10 other values; variant: Normal (55), Foil (55).
Open in Playground
GET/tcgplayer/salesapiKey1 credit/request
Returns the five most recent completed sales of a TCGplayer product: condition, printing, language, quantity, sale price, shipping price and order time. Optionally restrict to one condition (near-mint, lightly-played, moderately-played, heavily-played, damaged or unopened), one printing (variant such as Normal, Foil or Reverse Holofoil), one language (such as English or Japanese) and whether the listing had photos. The printing and language values a product accepts come from tcgplayer-filters; an unlisted value returns invalid parameters. A variant or language filter makes one extra call to read the product line's filter values.
Required: id. Optional: condition (6 allowed values: near-mint, lightly-played, moderately-played, heavily-played, damaged, unopened), variant, language, listing_type (3 allowed values: all, with-photos, without-photos).
Open in Playground
GET/tcgplayer/searchapiKey1 credit/request
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.
Optional: q, product_line, set, product_type, rarity, card_type, min_price, max_price, sort (7 allowed values: market-price, lowest-price, lowest-price-with-shipping, median-price, listings, sales, product-name), order (2 allowed values: asc, desc), limit, offset.
Sampled 26 Oct 2026: 5 items. Filled in every item: product_id, name, url, image_url, product_line, set_name, set_code, sealed and 5 more. Not in every item: rarity (3), number (3), card_types (3), median_price (3). In the sample: market_price: 6.4 to 2,172.24, median 41.37; name: “Charizard - 3/70 (#39 Charizard Stamped)” and 3 other values; url: tcgplayer.com; sealed: true in 0 of 5; card_types: median 1 entry; image_url: product-images.tcgplayer.com; set_name: “Battle Academy” and 3 other values; rarity: “Promo” and 2 other values.
Open in Playground
GET/tcgplayer/setsapiKey1 credit/request
Lists the active sets (expansions) of one TCGplayer product line, newest first: name, the url_name that tcgplayer-search takes as set, abbreviation and release date.
Required: product_line.
Sampled 26 Oct 2026: 220 items. Filled in every item: id, name, url_name, supplemental. Not in every item: abbreviation (216), release_date (201). In the sample: release_date: 1999-01-09 to 2026-11-06; name: “ME06: Delta Reign” and 219 other values; supplemental: true in 15 of 220; url_name: “me06-delta-reign” and 219 other values; abbreviation: “DLR” and 180 other values.
Open in Playground
TCGplayer API endpoints