TCGplayer

TCGplayer Recent Sales API

The 5 most recent sales of one TCGplayer product (US marketplace, prices in USD), optionally only in some conditions: order date, condition, printing, language, quantity, sale price, shipping, total and listing type. TCGplayer shows only the newest 5 sales, so this is not a full sold history; use price-history for sold volume and daily or weekly sale ranges. Costs 1 credit per request.

POST/api/v1/tcgplayer/sales

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

product_idinteger

TCGplayer product id: the number after /product/ in a tcgplayer.com URL, or a search result's product_id. A number or a string of digits. Pass product_id or url.

Example: 219058

urlstring

A tcgplayer.com product URL (/product/<id>/...). Used when product_id is not given.

Example: https://www.tcgplayer.com/product/219058/pokemon-battle-academy-charizard-3-70-39-charizard-stamped

conditionstring[]

Only sales in these conditions: Near Mint, Lightly Played, Moderately Played, Heavily Played, Damaged, Unopened, or NM, LP, MP, HP, DM, U. An array or a comma-separated string.

Example: Near Mint

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.tcgplayer.sales(product_id=219058, condition=["Near Mint"])["data"]

for s in res["sales"]:
    print(s["date"][:10], s["condition"], s["printing"], s["quantity"], s["price"], s["shipping_price"])

Response

"product_id": 219058,

"conditions": [],

"count": 5,

"response_time": 2279

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.tcgplayer.sales(product_id=219058, condition=["Near Mint"])["data"] for s in res["sales"]: print(s["date"][:10], s["condition"], s["printing"], s["quantity"], s["price"], s["shipping_price"])