TCGplayer

TCGplayer Seller Products API

The products one TCGplayer seller has listed (US marketplace, prices in USD), optionally only those matching keywords or one game, up to 50 per page, sorted like search. Each product has the same fields as search, with the seller's own listings of it (price, shipping, condition, printing, language, quantity) in place of the featured listings. Also returns total_results, has_more and the facets. Costs 1 credit per request.

POST/api/v1/tcgplayer/seller-products

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

seller_keystringrequired

TCGplayer seller key, a listing's seller.key (e.g. 58f7acae).

Example: 58f7acae

querystring

Only the seller's products matching these keywords, up to 200 characters.

Example: charizard

gamestring

Only this game, by url_name from /api/v1/tcgplayer/games.

Example: pokemon

sortstring

relevance (default), best_match, best_selling, name_asc, price_asc or price_desc (by market price). relevance and best_match rankings shift between calls; on page 2 and later, products already on the previous page are removed and counted in duplicates_removed, so a price or name sort pages more predictably.

pageinteger

Results page, 1-based, up to 200. Defaults to 1.

Example: 1

limitinteger

Products per page, 1-50. Defaults to 24.

Example: 24

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.tcgplayer.seller_products(seller_key="58f7acae", query="charizard", sort="price_asc")["data"]

for p in res["products"]:
    mine = p["listings"][0]
    print(p["name"], "market", p["market_price"], "seller", mine["price"], mine["condition"], mine["quantity"])

Response

"seller_key": "58f7acae",

"query": null,

"game": "pokemon",

"set": null,

"rarity": null,

"product_type": null,

"total_results": 1547,

"page": 1,

"limit": 10,

"sort": "relevance",

"count": 10,

"has_more": true,

"duplicates_removed": 0,

"response_time": 3873

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.tcgplayer.seller_products(seller_key="58f7acae", query="charizard", sort="price_asc")["data"] for p in res["products"]: mine = p["listings"][0] print(p["name"], "market", p["market_price"], "seller", mine["price"], mine["condition"], mine["quantity"])