Endpoint Playground

Try the TCGplayer Recent Sales API

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.

Request: GET /tcgplayer/sales
Cost: 1 credit/request
Auth: apiKey

TCGplayer Recent Sales API documentation TCGplayer platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tcgplayer/sales?id=42382&condition=near-mint&listing_type=all' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	integer	Yes	42382	TCGplayer product id from tcgplayer-search
condition	string	No	near-mint	Condition filter
variant	string	No		Printing label of the product's product line, such as Normal, Foil, Holofoil or Reverse Holofoil; see tcgplayer-filters
language	string	No		Language label: English, Chinese (S), Chinese (T), French, German, Italian, Japanese, Korean, Portuguese, Russian or Spanish, limited to the languages of the product's line; see tcgplayer-filters
listing_type	string	No	all	Listing type filter; default all

Example JSON response

{
  "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"
      }
    ]
  }
}

More TCGplayer endpoints

List the printing, condition and language filters of a TCGplayer product line List the sellers offering a TCGplayer product Get TCGplayer's price guide for a whole set Get a TCGplayer product's price history Get a TCGplayer product's detail and price points List TCGplayer product lines Search TCGplayer trading-card products List the sets of a TCGplayer product line

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requesttcgplayer.salesResponseDocTCGplayer

GET /tcgplayer/sales

Get a TCGplayer product's most recent sales

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): ```json { "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" } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredinteger

TCGplayer product id from tcgplayer-search

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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"
      }
    ]
  }
}

Try the TCGplayer Recent Sales API

Request: GET /tcgplayer/sales
Cost: 1 credit/request
Auth: apiKey

TCGplayer Recent Sales API documentation TCGplayer platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tcgplayer/sales?id=42382&condition=near-mint&listing_type=all' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	integer	Yes	42382	TCGplayer product id from tcgplayer-search
condition	string	No	near-mint	Condition filter
variant	string	No		Printing label of the product's product line, such as Normal, Foil, Holofoil or Reverse Holofoil; see tcgplayer-filters
language	string	No		Language label: English, Chinese (S), Chinese (T), French, German, Italian, Japanese, Korean, Portuguese, Russian or Spanish, limited to the languages of the product's line; see tcgplayer-filters
listing_type	string	No	all	Listing type filter; default all

Example JSON response

{
  "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"
      }
    ]
  }
}

Get a TCGplayer product's most recent sales

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "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" } ] } }