Skip to content
TTCGAPIs
Listing Snapshot API

TCGPlayer Live Listings API

Try with 100 free credits across all customer data endpoints. No payment card required. Credits pay for requests: 1 credit for a catalog lookup, 2 for a price or certificate lookup, 5 for live listings or prices by condition (SKU prices). After your free credits are used, buy a credit pack (from £10, no subscription) or choose a monthly plan. Plan tiers on this page name the monthly plan that includes each endpoint.

Access current seller listings from TCGPlayer's marketplace. Inspect available listing snapshots with source-supplied prices, quantities and seller details.

What are TCGPlayer Live Listings?

Listing snapshots contain cards reported as available by the source. The current live fetch requests up to 50 English-language listings in a US shipping context; cached or stored fallback data may differ. Unlike aggregate price guides, returned listing records can show:

✓Available source listing prices
✓Reported listing quantities
✓Who is selling the card
✓Card condition per listing

This endpoint returns available TCGPlayer seller-listing records. Compare fields and source timestamps when evaluating providers.

Data Points

What Data Do You Get?

Listing fields depend on the source response and the selected product. Some products have no available listings.

Listing Price

Current asking price set by the seller

Quantity Available

Number of copies the seller has in stock

Card Condition

NM, LP, MP, HP, or Damaged status

Seller Information

Seller name and rating data

Shipping Details

Reported shipping cost where supplied

Variant Details

Reported printing and condition fields

Developer Ready

Seller Listing Data

Request the available listing snapshot for a product. Results can be cached for up to an hour; a stored snapshot may be returned when the source cannot be reached.

Live Listings Response
// Run on your server. Keep the key out of client-side code.
const headers = { 'x-api-key': process.env.TCGAPIS_KEY };
async function get(path) {
  const response = await fetch('https://api.tcgapis.com/api/v2' + path, { headers });
  const body = await response.json();
  if (!response.ok || !body.success) throw new Error(body.error || 'Request failed');
  return body;
}

const found = await get('/search?q=Charizard&game=3&limit=10');
console.log(found.data); // Inspect candidates before choosing the intended set/printing
const productId = found.data[0]?.productId;
if (!productId) throw new Error('No matching product found');

// Credits (5 per request) or Unlimited. These are for-sale asking prices, not completed sales.
const listings = await get('/livelistings/' + productId);
console.log(listings.data); // Inspect the returned snapshot, including fallback records
console.log(listings.data.allListings ?? {}); // condition -> printing -> standard/custom
console.log(listings.data.cheapestByConditionAndPrinting ?? {});
// Responses can be cached for up to an hour; stored data may be returned on source failure.
Use Cases

Powerful Use Cases

Live listing data enables applications that weren't possible before.

Price Monitoring

Track available source listing prices. Get alerts when cards hit your target price or when new listings appear.

Arbitrage Opportunities

Find pricing discrepancies between sellers. Identify underpriced listings before they sell.

Inventory Management

Compare your prices against competitors. Ensure your listings are competitively priced.

Market Analysis

Analyze listing trends and seller behavior. Understand market depth and liquidity.

Data coverage

Listing Fields and Availability

These capabilities depend on the product and source snapshot. Check the returned record before using it.

Feature
TCGAPIs
Availability
Current seller listings
✓
Where reported by the source
Individual listing prices
✓
Where reported by the source
Seller information
✓
Where reported by the source
Quantity per listing
✓
Where reported by the source
Shipping details
✓
Where reported by the source
Price range and average of returned listings
✓
Where reported by the source

Frequently asked questions

What are TCGPlayer live listings?

Live listings are the actual cards currently for sale on TCGPlayer's marketplace. Unlike aggregated market prices, listing snapshots expose available source prices, quantities and condition information. They may be cached or unavailable for a product.

What data is included in each listing?

Processed source listings can include price, quantity, condition, printing, seller name and rating, and reported shipping cost. Data is grouped by condition and printing; fallback snapshots can differ in available fields.

How often are live listings updated?

The endpoint requests a source snapshot, can reuse a cache for up to an hour, and can fall back to stored data if the source fails. Check timestamps when present.

Can I use live listings for price monitoring?

Yes, listing snapshots can support price monitoring, inventory tools and market analysis. You can track available source listing prices and identify pricing opportunities.

Do other APIs provide live listings data?

TCGAPIs provides individual TCGPlayer listing records in addition to aggregate product prices. Compare documented fields and freshness when evaluating providers.

Ready for Seller Listing Snapshots?

Use available TCGPlayer listing snapshots with documented fields, source limitations, at 5 credits per request or with the Unlimited plan.