TCGplayer Recent Sales API

Endpoint facts

Method

GET

API path

/tcgplayer/sales

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

TCGplayer

Response schema

#/definitions/tcgplayer.salesResponseDoc

How this endpoint behaves

Parameters:

• id (required): the TCGplayer product id (see tcgplayer-search).
• condition (optional): near-mint, lightly-played, moderately-played, heavily-played, damaged or unopened (sealed product).
• variant (optional): the printing, as the label of the product's own product line, matched ignoring case (hyphens and underscores count as spaces). Examples are Normal, Foil, Holofoil, Reverse Holofoil, 1st Edition and Cold Foil; the full list for a line, with TCGplayer's ids, comes from tcgplayer-filters, and every label seen across all lines is listed on that endpoint's page. A label the product's line does not offer returns 400 with the labels it does.
• language (optional): English, Chinese (S), Chinese (T), French, German, Italian, Japanese, Korean, Portuguese, Russian or Spanish, limited to the languages of the product's line (most lines carry English only). A language the line does not offer returns 400 with the languages it does.
• listing_type (optional): all (default), with-photos or without-photos.

Notable response behavior:

• TCGplayer returns the five most recent sales and offers no paging, so there are at most five rows. Use tcgplayer-price-history for a longer trend.
• Filters apply to the five most recent sales that match them, not to the five most recent sales overall, so a filtered call can return sales older than an unfiltered one. A filter nobody has sold under returns an empty sales list.
• A variant or language filter makes one extra call to read the product line's filter values (cached for 15 minutes); the other filters do not. Printing ids belong to one product line, which is why the labels are resolved per product.
• Prices are US dollars. order_date is an RFC 3339 timestamp.
• Buyer and seller identities are not part of the response.
• A product with no recent sales returns an empty sales list.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "product_id": 42382,
    "sales": [
      {
        "condition": "Damaged",
        "variant": "Holofoil",
        "language": "English",
        "quantity": 1,
        "purchase_price": 220,
        "shipping_price": 0,
        "listing_type": "ListingWithoutPhotos",
        "order_date": "2026-10-24T17:53:24.483+00:00"
      },
      {
        "condition": "Heavily Played",
        "variant": "Holofoil",
        "language": "English",
        "quantity": 1,
        "purchase_price": 246.49,
        "shipping_price": 0.99,
        "listing_type": "ListingWithoutPhotos",
        "order_date": "2026-10-24T13:37:33.393+00:00"
      },
      {
        "condition": "Heavily Played",
        "variant": "Holofoil",
        "language": "English",
        "quantity": 1,
        "purchase_price": 240,
        "shipping_price": 0,
        "listing_type": "ListingWithoutPhotos",
        "order_date": "2026-10-24T11:40:27.84+00:00"
      },
      {
        "condition": "Moderately Played",
        "variant": "Holofoil",
        "language": "English",
        "quantity": 1,
        "purchase_price": 399.97,
        "shipping_price": 0,
        "listing_type": "ListingWithoutPhotos",
        "order_date": "2026-10-23T14:24:34.207+00:00"
      },
      {
        "condition": "Lightly Played",
        "variant": "Holofoil",
        "language": "English",
        "quantity": 1,
        "purchase_price": 565,
        "shipping_price": 0,
        "listing_type": "ListingWithPhotos",
        "order_date": "2026-10-23T04:25:53.693+00:00"
      }
    ]
  }
}

Shared guides

Related