TCGplayer

TCGplayer Seller API

One TCGplayer seller by seller key (a listing's seller.key): store name, URL, location, member since, lifetime sales, completed sales rank, rating percent, gold star, Direct, Pro, certified hobby shop and Wizards Play Network flags, US and international shipping, store hours, the games it sells, social links, and the last 365 days of buyer feedback summarized: total, percent positive, count per star, and as described, arrived when expected and good communication. An unknown key is a 404. Costs 1 credit per request.

POST/api/v1/tcgplayer/seller

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 (8 characters, e.g. 58f7acae).

Example: 58f7acae

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

s = client.tcgplayer.seller(seller_key="58f7acae")["data"]

fb = s["feedback"]
print(s["name"], s["city"], s["state"], s["lifetime_sales"], s["gold_star"], s["direct"])
print(fb["total"], "feedback,", fb["percent_positive"], "% positive,", fb["stars"]["one"], "one-star")

Response

"seller_key": "58f7acae",

"seller_id": 498321,

"name": "ARVpro",

"url": "https://www.tcgplayer.com/sellers/ARVpro/58f7acae",

"about": null,

"city": "Tallahassee",

"state": "FL",

"country": "US",

"member_since": "May 2024",

"created_at": "2024-05-15T16:16:18.000Z",

"active": true,

"status": "Live",

"seller_level": 4,

"lifetime_sales": "10000+",

"completed_sales_rank": "10000+",

"rating_percent": 100,

"gold_star": true,

"direct": true,

"pro": true,

"vip": false,

"certified_hobby_shop": false,

"wizards_play_network": false,

"presale_enabled": false,

"ships_us": true,

"ships_international": true,

"logo_url": null,

"banner_url": null,

"social": {},

"response_time": 1354

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") s = client.tcgplayer.seller(seller_key="58f7acae")["data"] fb = s["feedback"] print(s["name"], s["city"], s["state"], s["lifetime_sales"], s["gold_star"], s["direct"]) print(fb["total"], "feedback,", fb["percent_positive"], "% positive,", fb["stars"]["one"], "one-star")