extractr docs
TCGPlayer

List cards in a set

GET
/tcgplayer/get_variants

Every product in a set (group) by set_id — singles and sealed — with market pricing, paged with offset. Use the set_id from any card summary; set-level analytics are at /tcgplayer/set_analytics.

Costs 2 credits per request.

Authorization

ApiKeyAuth
X-API-Key<token>

API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.

In: header

Query Parameters

set_id*string
Match^\d+$
type?string

Only single cards, or only sealed product.

Value in

  • "cards"
  • "sealed"
limit?integer

Max products returned (fetched upstream in pages of 50).

Range1 <= value <= 100
Default30
offset?|

Skip this many products — pass the previous page's next_offset.

Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tcgplayer/get_variants?set_id=1376"
{  "set_id": "string",  "set": "EX Dragon",  "category": "Pokemon",  "abbreviation": "DR",  "set_slug": "ex-dragon",  "count": 0,  "offset": 0,  "next_offset": 0,  "variants": [    {      "tcgplayer_id": "659612",      "name": "Mega Charizard X ex",      "category": "Pokemon",      "category_id": "3",      "set": "Mega Evolution Promos",      "set_id": "24451",      "card_number": "023",      "rarity": "Promo",      "sub_type": "Holofoil",      "is_card": true,      "image": "https://tcgplayer-cdn.tcgplayer.com/product/659612_in_1000x1000.jpg",      "market_price": 37.63,      "price_change": 0.03,      "price_change_pct": 0.08,      "url": "https://www.tcgplayer.com/product/659612/",      "previous_market_price": 37.6,      "set_slug": "ex-dragon",      "available_variants": [        {          "sub_type": "Holofoil",          "grade_id": "12",          "label": "PSA 10"        }      ]    }  ]}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}