TCGplayer

TCGplayer Price Guide API

The TCGplayer price guide for one set (US marketplace, prices in USD): one row per product per condition and printing, with the product id, name, URL, card number, rarity, market price and low price, for the set's cards or its sealed products, up to 500 rows per page. Take set ids from sets. total_results is given for cards and null for sealed. A set with nothing in the guide is a 404. Costs 1 credit per request.

POST/api/v1/tcgplayer/price-guide

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

set_idintegerrequired

Set id from /api/v1/tcgplayer/sets (604 is Pokemon Base Set). A number or a string of digits.

Example: 604

product_typestring

cards (default) or sealed.

pageinteger

Page, 1-based, up to 100. Defaults to 1.

Example: 1

limitinteger

Rows per page, 1-500. Defaults to 100. One row per card per condition and printing.

Example: 100

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.tcgplayer.price_guide(set_id=604, limit=500)["data"]

nm = [r for r in res["rows"] if r["condition"] == "Near Mint"]
for r in sorted(nm, key=lambda r: r["market_price"] or 0, reverse=True)[:10]:
    print(r["number"], r["name"], r["printing"], r["market_price"])

Response

"set_id": 604,

"set_name": "Base Set",

"game": "Pokemon",

"product_type": "cards",

"page": 1,

"limit": 20,

"total_results": 505,

"count": 20,

"has_more": true,

"response_time": 2355

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.tcgplayer.price_guide(set_id=604, limit=500)["data"] nm = [r for r in res["rows"] if r["condition"] == "Near Mint"] for r in sorted(nm, key=lambda r: r["market_price"] or 0, reverse=True)[:10]: print(r["number"], r["name"], r["printing"], r["market_price"])