TCGplayer Product Listings API

Endpoint facts

Method

GET

API path

/tcgplayer/listings

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

TCGplayer

Response schema

#/definitions/tcgplayer.listingsResponseDoc

How this endpoint behaves

Parameters:

• id (required): the TCGplayer product id (see tcgplayer-search).
• condition (optional): near-mint, lightly-played, moderately-played, heavily-played or damaged.
• printing, language (optional): exact labels such as Foil or English. The labels present for the product are returned in facets.
• sort (optional): price or price-with-shipping. Omit it for TCGplayer's own order.
• order (optional, needs sort): asc (default) or desc.
• limit (optional): page size, 1 to 50; defaults to 24.
• offset (optional): listings to skip; offset plus limit must be 9999 or less.

Notable response behavior:

• seller_name is the seller's public TCGplayer storefront name. seller_sales is a count as text, and 10000+ for the largest sellers.
• Prices are US dollars; price is per item and shipping_price is that listing's shipping.
• next_offset is omitted on the last page.
• An unknown product id returns 404.

Example response (long values and lists shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "product_id": 42382,
    "total": 18,
    "limit": 3,
    "offset": 0,
    "next_offset": 3,
    "listings": [
      {
        "listing_id": 4749605,
        "seller_name": "jlittleton",
        "seller_rating": 100,
        "seller_sales": "15",
        "gold_seller": false,
        "verified_seller": false,
        "direct_seller": false,
        "condition": "Near Mint",
        "printing": "Holofoil",
        "language": "English",
        "quantity": 1,
        "price": 1098,
        "shipping_price": 4.99,
        "listing_type": "custom"
      },
      {
        "listing_id": 4743494,
        "seller_name": "Comic Buying Center",
        "seller_rating": 100,
        "seller_sales": "3543",
        "gold_seller": true,
        "verified_seller": true,
        "direct_seller": false,
        "condition": "Near Mint",
        "printing": "Holofoil",
        "language": "English",
        "quantity": 1,
        "price": 1100,
        "shipping_price": 3,
        "listing_type": "custom",
        "seller_city": "LIBERTYVILLE",
        "seller_state": "IL",
        "seller_country": "US"
      },
      {
        "listing_id": 4740111,
        "seller_name": "PokeGirlCC",
        "seller_rating": 100,
        "seller_sales": "1085",
        "gold_seller": true,
        "verified_seller": false,
        "direct_seller": false,
        "condition": "Near Mint",
        "printing": "Holofoil",
        "language": "English",
        "quantity": 1,
        "price": 1199.99,
        "shipping_price": 2.49,
        "listing_type": "custom",
        "seller_city": "Riverview",
        "seller_state": "FL",
        "seller_country": "US"
      }
    ],
    "facets": {
      "conditions": [
        {
          "value": "Near Mint",
          "count": 18
        }
      ],
      "printings": [
        {
          "value": "Holofoil",
          "count": 18
        }
      ],
      "languages": [
        {
          "value": "English",
          "count": 18
        }
      ]
    }
  }
}

Sampled response

Request, 26 Oct 2026

GET /tcgplayer/listings?id=243172&limit=5

Items in listings

5

Fields filled in every checked item

17

Shared guides

Related