Endpoint Playground

Try the TCGplayer Price Guide API

Returns TCGplayer's price guide for one set, one row per card, condition and printing: card id, name, collector number, rarity, condition, printing, language, low price, market price and units sold. Page through a whole set (up to 500 rows per call) instead of fetching each card; the set_id comes from tcgplayer-sets.

Request: GET /tcgplayer/price-guide
Cost: 2 credits/request
Auth: apiKey

TCGplayer Price Guide API documentation TCGplayer platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tcgplayer/price-guide?set_id=604' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
set_id	integer	Yes	604	Numeric set id from tcgplayer-sets (the id field)
limit	integer	No		Page size, 1 to 500; defaults to 100
offset	integer	No		Rows to skip; use the previous response's next_offset

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "set_id": 604,
    "set_name": "Base Set",
    "set_abbreviation": "BS",
    "game": "Pokemon",
    "total": 505,
    "limit": 4,
    "offset": 0,
    "next_offset": 4,
    "rows": [
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Damaged",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.25,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Heavily Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.31,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Lightly Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.59,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Moderately Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.41,
        "sales": 0
      }
    ]
  }
}

More TCGplayer endpoints

List the printing, condition and language filters of a TCGplayer product line List the sellers offering a TCGplayer product 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 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

GETapiKey2 credits/requesttcgplayer.priceGuideResponseDocTCGplayer

GET /tcgplayer/price-guide

Get TCGplayer's price guide for a whole set

Response behavior

- Rows come back in a fixed order, so paging with `next_offset` walks the whole set without repeats. `total` is the number of rows in the set, not the number of cards: a card appears once per condition and printing (a card with one printing has five rows, one per condition). - `condition` is one of `Near Mint`, `Lightly Played`, `Moderately Played`, `Heavily Played` or `Damaged`. TCGplayer folds the printing and sometimes a language into that text (for example `Near Mint Holofoil` or `Near Mint Foil - Japanese`); the response splits them into `condition`, `printing` and `language`. `language` is omitted when TCGplayer does not mark one. - `low_price` and `market_price` are US dollars; `sales` is the units sold TCGplayer counts for that row. - Only cards are listed; sealed products are not part of this price guide. Use `product_id` with `tcgplayer-product` for a card's detail. Example response (long values and lists shortened): ```json { "code": 200, "msg": "OK", "data": { "set_id": 604, "set_name": "Base Set", "set_abbreviation": "BS", "game": "Pokemon", "total": 505, "limit": 4, "offset": 0, "next_offset": 4, "rows": [ { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Damaged", "printing": "Normal", "low_price": 0.09, "market_price": 0.25, "sales": 0 }, { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Heavily Played", "printing": "Normal", "low_price": 0.09, "market_price": 0.31, "sales": 0 }, { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Lightly Played", "printing": "Normal", "low_price": 0.09, "market_price": 0.59, "sales": 0 }, { "product_id": 42386, "name": "Abra", "number": "043/102", "rarity": "Common", "condition": "Moderately Played", "printing": "Normal", "low_price": 0.09, "market_price": 0.41, "sales": 0 } ] } } ```

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

set_id

requiredinteger

Numeric set id from tcgplayer-sets (the id field)

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": {
    "set_id": 604,
    "set_name": "Base Set",
    "set_abbreviation": "BS",
    "game": "Pokemon",
    "total": 505,
    "limit": 4,
    "offset": 0,
    "next_offset": 4,
    "rows": [
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Damaged",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.25,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Heavily Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.31,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Lightly Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.59,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Moderately Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.41,
        "sales": 0
      }
    ]
  }
}

Endpoint Playground

Try the TCGplayer Price Guide API

Request: GET /tcgplayer/price-guide
Cost: 2 credits/request
Auth: apiKey

TCGplayer Price Guide API documentation TCGplayer platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tcgplayer/price-guide?set_id=604' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
set_id	integer	Yes	604	Numeric set id from tcgplayer-sets (the id field)
limit	integer	No		Page size, 1 to 500; defaults to 100
offset	integer	No		Rows to skip; use the previous response's next_offset

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "set_id": 604,
    "set_name": "Base Set",
    "set_abbreviation": "BS",
    "game": "Pokemon",
    "total": 505,
    "limit": 4,
    "offset": 0,
    "next_offset": 4,
    "rows": [
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Damaged",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.25,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Heavily Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.31,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Lightly Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.59,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Moderately Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.41,
        "sales": 0
      }
    ]
  }
}

More TCGplayer endpoints

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

GETapiKey2 credits/requesttcgplayer.priceGuideResponseDocTCGplayer

GET /tcgplayer/price-guide

Get TCGplayer's price guide for a whole set

Response behavior

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

set_id

requiredinteger

Numeric set id from tcgplayer-sets (the id field)

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": {
    "set_id": 604,
    "set_name": "Base Set",
    "set_abbreviation": "BS",
    "game": "Pokemon",
    "total": 505,
    "limit": 4,
    "offset": 0,
    "next_offset": 4,
    "rows": [
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Damaged",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.25,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Heavily Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.31,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Lightly Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.59,
        "sales": 0
      },
      {
        "product_id": 42386,
        "name": "Abra",
        "number": "043/102",
        "rarity": "Common",
        "condition": "Moderately Played",
        "printing": "Normal",
        "low_price": 0.09,
        "market_price": 0.41,
        "sales": 0
      }
    ]
  }
}