TCGplayer listings

Live TCGplayer offers in USD for Pokémon cards and sealed products, cursor-paginated.

TCGplayer Live Listings

GET/v1/cards/:id/listings/tcgplayer1 credit per item returned

Retrieve live TCGplayer marketplace offers for a specific card — current asking prices in USD, not completed sales. Includes seller reputation (rating, sales count, Gold/Direct/Verified badges) and shipping cost. Supports cursor-based pagination. updated_at is not a freshness signal. It moves only when a listing's own price, quantity or seller details change, so a listing that has been live and unchanged for a month keeps a month-old value however recently we confirmed it. Read snapshot_at for freshness: it is when the product's listings were last confirmed against TCGplayer, identical for every row in a response because a snapshot replaces a product's listings wholesale. Listings refresh daily, so a snapshot_at well over a day old means that product's last fetch did not succeed and you are seeing the previous snapshot. It is null if no successful snapshot has been recorded since the field was introduced. We collect from a US vantage point with no shipping-destination filter, so a snapshot can contain offers TCGplayer's own site hides from you when you browse it from outside the US.

Parameters

idstringrequired

The unique card ID.

conditionstring

Condition filter (e.g. "Near Mint", "Lightly Played", "Moderately Played").

languagestring

Listing language filter (e.g. "English", "German", "Japanese"). This is the language of the marketplace offer, not of the card.

printingstring

Printing/variant filter (e.g. "Holofoil", "Normal", "Reverse Holofoil").

min_pricenumber

Minimum offer price (USD).

max_pricenumber

Maximum offer price (USD).

sortstring

Sort order. One of "price_asc", "price_desc". Defaults to price_asc.

limitnumber

Number of listings to return per page (max 20). Defaults to 20.

cursorstring

Pagination cursor returned from a previous response.

Try it

API key

id *

condition

language

printing

min_price

max_price

sort

limit

cursor

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}/listings/tcgplayer

Response

{
  "data": [
    {
      "id": 7890,
      "listing_id": 1234567890,
      "printing": "Holofoil",
      "condition": "Near Mint",
      "language": "English",
      "price": 279.99,
      "shipping_price": 0,
      "seller_name": "TopTierCards",
      "seller_id": "a1b2c3d4",
      "seller_rating": 99.8,
      "seller_sales": "50,000+",
      "quantity": 3,
      "listing_type": "standard",
      "direct_seller": true,
      "gold_seller": true,
      "verified_seller": true,
      "custom_title": "PSA-ready, pack fresh",
      "updated_at": "2026-06-10T14:22:00+00:00",
      "snapshot_at": "2026-09-03T02:41:12Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "Nzg5MA==",
    "count": 20
  }
}

TCGplayer Sealed Listings

GET/v1/sealed/:id/listings/tcgplayer1 credit per item returned

Retrieve live TCGplayer marketplace offers for a specific sealed product — current asking prices in USD, not completed sales. Same response shape, filters, and cursor pagination as the card endpoint. Sealed offers normally carry condition "Unopened" with an empty printing, so those two filters rarely narrow anything here. snapshot_at applies here exactly as it does on the card endpoint: read it for freshness rather than updated_at.