Endpoint Playground

Try the TCGplayer Product Search API

Searches TCGplayer's catalog of trading-card and collectible products (Pokemon, Magic, Yu-Gi-Oh!, One Piece, Lorcana and about 70 other product lines) and returns one page of matches: product id, name, set, rarity, card number, market, lowest and median prices, listing count, links and filter facets. Filter by product line, set, product type, rarity, card type and price range, and sort by price, listings, sales or name.

What a live request returned

26 Oct 2026: 5 products; 13 fields had a value in every checked item and 4 varied between items.

Observed request: GET /tcgplayer/search?q=charizard&product_line=pokemon&limit=5
Fields with a value in every checked item: product_id, name, url, image_url, product_line, set_name, set_code, sealed

Sample value profiles: market_price: 6.4 to 2,172.24, median 41.37; name: “Charizard - 3/70 (#39 Charizard Stamped)” and 3 other values; url: tcgplayer.com.

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

TCGplayer Product Search API documentation TCGplayer platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tcgplayer/search?sort=market-price&order=asc' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	No		Search text, up to 100 characters; optional when product_line is set
product_line	string	No		Product line url_name from tcgplayer-product-lines, for example pokemon, magic, yugioh
set	string	No		Set url_name from tcgplayer-sets; needs product_line
product_type	string	No		Exact product type label such as Cards or Booster Box; see facets.product_types
rarity	string	No		Exact rarity label such as Holo Rare; see facets.rarities
card_type	string	No		Exact card type label such as Pokemon; see facets.card_types
min_price	number	No		Minimum market price in US dollars
max_price	number	No		Maximum market price in US dollars
sort	string	No	market-price	Sort field; omit for relevance
order	string	No	asc	Sort direction, needs sort; default desc (asc for product-name)
limit	integer	No		Page size, 1 to 50; defaults to 24
offset	integer	No		Results to skip; offset plus limit must be 9999 or less

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "charizard",
    "total": 2,
    "limit": 3,
    "offset": 0,
    "products": [
      {
        "product_id": 42382,
        "name": "Charizard",
        "url": "https://www.tcgplayer.com/product/42382",
        "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/42382.jpg",
        "product_line": "Pokemon",
        "set_name": "Base Set",
        "set_code": "BS",
        "rarity": "Holo Rare",
        "number": "004/102",
        "card_types": [
          "Pokemon"
        ],
        "sealed": false,
        "foil_only": true,
        "market_price": 954.65,
        "lowest_price": 207.29,
        "lowest_price_with_shipping": 207.3,
        "total_listings": 138
      },
      {
        "product_id": 657516,
        "name": "Charizard (Black Dot Error)",
        "url": "https://www.tcgplayer.com/product/657516",
        "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/657516.jpg",
        "product_line": "Pokemon",
        "set_name": "Base Set",
        "set_code": "BS",
        "rarity": "Holo Rare",
        "number": "004/102",
        "card_types": [
          "Pokemon"
        ],
        "sealed": false,
        "foil_only": true,
        "lowest_price": 549.99,
        "lowest_price_with_shipping": 549.99,
        "total_listings": 6
      }
    ],
    "facets": {
      "product_lines": [
        {
          "value": "Pokemon",
          "url_value": "pokemon",
          "count": 2
        }
      ],
      "sets": [
        {
          "value": "SWSH: Crown Zenith",
          "url_value": "swsh-crown-zenith",
          "count": 7
        },
        {
          "value": "Base Set",
          "url_value": "base-set",
          "count": 2
        }
      ],
      "rarities": [
        {
          "value": "Holo Rare",
          "count": 2
        }
      ],
      "card_types": [
        {
          "value": "Pokemon",
          "count": 2
        }
      ],
      "energy_types": [
        {
          "value": "Fire",
          "count": 2
        }
      ],
      "product_types": [
        {
          "value": "Cards",
          "count": 2
        }
      ]
    }
  }
}

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 Get a TCGplayer product's most recent sales 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.searchResponseDocTCGplayer

GET /tcgplayer/search

Search TCGplayer trading-card products

Response behavior

- `next_offset` is the offset of the next page and is omitted on the last page or when the next same-size page would pass the 9999 window. - Prices are US dollars. `market_price`, `lowest_price`, `lowest_price_with_shipping` and `median_price` are omitted for products with no recent sales or listings. - `facets` lists the product lines, sets, rarities, card types, energy types and product types present in the results, with counts. `sets[].url_value` is the value to pass as `set`. - Result order can shift slightly between calls because TCGplayer ranks by live sales, so page through with a single sort rather than relying on a stable relevance order. - `url` and `image_url` are tcgplayer.com links; images are not downloaded. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "query": "charizard", "total": 2, "limit": 3, "offset": 0, "products": [ { "product_id": 42382, "name": "Charizard", "url": "https://www.tcgplayer.com/product/42382", "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/42382.jpg", "product_line": "Pokemon", "set_name": "Base Set", "set_code": "BS", "rarity": "Holo Rare", "number": "004/102", "card_types": [ "Pokemon" ], "sealed": false, "foil_only": true, "market_price": 954.65, "lowest_price": 207.29, "lowest_price_with_shipping": 207.3, "total_listings": 138 }, { "product_id": 657516, "name": "Charizard (Black Dot Error)", "url": "https://www.tcgplayer.com/product/657516", "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/657516.jpg", "product_line": "Pokemon", "set_name": "Base Set", "set_code": "BS", "rarity": "Holo Rare", "number": "004/102", "card_types": [ "Pokemon" ], "sealed": false, "foil_only": true, "lowest_price": 549.99, "lowest_price_with_shipping": 549.99, "total_listings": 6 } ], "facets": { "product_lines": [ { "value": "Pokemon", "url_value": "pokemon", "count": 2 } ], "sets": [ { "value": "SWSH: Crown Zenith", "url_value": "swsh-crown-zenith", "count": 7 }, { "value": "Base Set", "url_value": "base-set", "count": 2 } ], "rarities": [ { "value": "Holo Rare", "count": 2 } ], "card_types": [ { "value": "Pokemon", "count": 2 } ], "energy_types": [ { "value": "Fire", "count": 2 } ], "product_types": [ { "value": "Cards", "count": 2 } ] } } } ```

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

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": {
    "query": "charizard",
    "total": 2,
    "limit": 3,
    "offset": 0,
    "products": [
      {
        "product_id": 42382,
        "name": "Charizard",
        "url": "https://www.tcgplayer.com/product/42382",
        "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/42382.jpg",
        "product_line": "Pokemon",
        "set_name": "Base Set",
        "set_code": "BS",
        "rarity": "Holo Rare",
        "number": "004/102",
        "card_types": [
          "Pokemon"
        ],
        "sealed": false,
        "foil_only": true,
        "market_price": 954.65,
        "lowest_price": 207.29,
        "lowest_price_with_shipping": 207.3,
        "total_listings": 138
      },
      {
        "product_id": 657516,
        "name": "Charizard (Black Dot Error)",
        "url": "https://www.tcgplayer.com/product/657516",
        "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/657516.jpg",
        "product_line": "Pokemon",
        "set_name": "Base Set",
        "set_code": "BS",
        "rarity": "Holo Rare",
        "number": "004/102",
        "card_types": [
          "Pokemon"
        ],
        "sealed": false,
        "foil_only": true,
        "lowest_price": 549.99,
        "lowest_price_with_shipping": 549.99,
        "total_listings": 6
      }
    ],
    "facets": {
      "product_lines": [
        {
          "value": "Pokemon",
          "url_value": "pokemon",
          "count": 2
        }
      ],
      "sets": [
        {
          "value": "SWSH: Crown Zenith",
          "url_value": "swsh-crown-zenith",
          "count": 7
        },
        {
          "value": "Base Set",
          "url_value": "base-set",
          "count": 2
        }
      ],
      "rarities": [
        {
          "value": "Holo Rare",
          "count": 2
        }
      ],
      "card_types": [
        {
          "value": "Pokemon",
          "count": 2
        }
      ],
      "energy_types": [
        {
          "value": "Fire",
          "count": 2
        }
      ],
      "product_types": [
        {
          "value": "Cards",
          "count": 2
        }
      ]
    }
  }
}

Try the TCGplayer Product Search API

What a live request returned

26 Oct 2026: 5 products; 13 fields had a value in every checked item and 4 varied between items.

Observed request: GET /tcgplayer/search?q=charizard&product_line=pokemon&limit=5
Fields with a value in every checked item: product_id, name, url, image_url, product_line, set_name, set_code, sealed

Sample value profiles: market_price: 6.4 to 2,172.24, median 41.37; name: “Charizard - 3/70 (#39 Charizard Stamped)” and 3 other values; url: tcgplayer.com.

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

TCGplayer Product Search API documentation TCGplayer platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tcgplayer/search?sort=market-price&order=asc' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	No		Search text, up to 100 characters; optional when product_line is set
product_line	string	No		Product line url_name from tcgplayer-product-lines, for example pokemon, magic, yugioh
set	string	No		Set url_name from tcgplayer-sets; needs product_line
product_type	string	No		Exact product type label such as Cards or Booster Box; see facets.product_types
rarity	string	No		Exact rarity label such as Holo Rare; see facets.rarities
card_type	string	No		Exact card type label such as Pokemon; see facets.card_types
min_price	number	No		Minimum market price in US dollars
max_price	number	No		Maximum market price in US dollars
sort	string	No	market-price	Sort field; omit for relevance
order	string	No	asc	Sort direction, needs sort; default desc (asc for product-name)
limit	integer	No		Page size, 1 to 50; defaults to 24
offset	integer	No		Results to skip; offset plus limit must be 9999 or less

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "charizard",
    "total": 2,
    "limit": 3,
    "offset": 0,
    "products": [
      {
        "product_id": 42382,
        "name": "Charizard",
        "url": "https://www.tcgplayer.com/product/42382",
        "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/42382.jpg",
        "product_line": "Pokemon",
        "set_name": "Base Set",
        "set_code": "BS",
        "rarity": "Holo Rare",
        "number": "004/102",
        "card_types": [
          "Pokemon"
        ],
        "sealed": false,
        "foil_only": true,
        "market_price": 954.65,
        "lowest_price": 207.29,
        "lowest_price_with_shipping": 207.3,
        "total_listings": 138
      },
      {
        "product_id": 657516,
        "name": "Charizard (Black Dot Error)",
        "url": "https://www.tcgplayer.com/product/657516",
        "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/657516.jpg",
        "product_line": "Pokemon",
        "set_name": "Base Set",
        "set_code": "BS",
        "rarity": "Holo Rare",
        "number": "004/102",
        "card_types": [
          "Pokemon"
        ],
        "sealed": false,
        "foil_only": true,
        "lowest_price": 549.99,
        "lowest_price_with_shipping": 549.99,
        "total_listings": 6
      }
    ],
    "facets": {
      "product_lines": [
        {
          "value": "Pokemon",
          "url_value": "pokemon",
          "count": 2
        }
      ],
      "sets": [
        {
          "value": "SWSH: Crown Zenith",
          "url_value": "swsh-crown-zenith",
          "count": 7
        },
        {
          "value": "Base Set",
          "url_value": "base-set",
          "count": 2
        }
      ],
      "rarities": [
        {
          "value": "Holo Rare",
          "count": 2
        }
      ],
      "card_types": [
        {
          "value": "Pokemon",
          "count": 2
        }
      ],
      "energy_types": [
        {
          "value": "Fire",
          "count": 2
        }
      ],
      "product_types": [
        {
          "value": "Cards",
          "count": 2
        }
      ]
    }
  }
}

Search TCGplayer trading-card products

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": { "query": "charizard", "total": 2, "limit": 3, "offset": 0, "products": [ { "product_id": 42382, "name": "Charizard", "url": "https://www.tcgplayer.com/product/42382", "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/42382.jpg", "product_line": "Pokemon", "set_name": "Base Set", "set_code": "BS", "rarity": "Holo Rare", "number": "004/102", "card_types": [ "Pokemon" ], "sealed": false, "foil_only": true, "market_price": 954.65, "lowest_price": 207.29, "lowest_price_with_shipping": 207.3, "total_listings": 138 }, { "product_id": 657516, "name": "Charizard (Black Dot Error)", "url": "https://www.tcgplayer.com/product/657516", "image_url": "https://product-images.tcgplayer.com/fit-in/437x437/657516.jpg", "product_line": "Pokemon", "set_name": "Base Set", "set_code": "BS", "rarity": "Holo Rare", "number": "004/102", "card_types": [ "Pokemon" ], "sealed": false, "foil_only": true, "lowest_price": 549.99, "lowest_price_with_shipping": 549.99, "total_listings": 6 } ], "facets": { "product_lines": [ { "value": "Pokemon", "url_value": "pokemon", "count": 2 } ], "sets": [ { "value": "SWSH: Crown Zenith", "url_value": "swsh-crown-zenith", "count": 7 }, { "value": "Base Set", "url_value": "base-set", "count": 2 } ], "rarities": [ { "value": "Holo Rare", "count": 2 } ], "card_types": [ { "value": "Pokemon", "count": 2 } ], "energy_types": [ { "value": "Fire", "count": 2 } ], "product_types": [ { "value": "Cards", "count": 2 } ] } } }