TCGplayer

TCGplayer Product API

One TCGplayer product (US marketplace, prices in USD) by product id or tcgplayer.com URL: name, URL, images at 200, 400 and 1000 px, game, set, card number, rarity, product type, release date, market, median and lowest price, listing and seller counts, card text, flavor text and the game's card attributes (Pokemon HP, stage, energy type, attacks, weakness, retreat cost; Magic color, mana value, type line, power, toughness; Yu-Gi-Oh! attribute, monster type, level, ATK, DEF). Every SKU, one per condition x printing x language, comes with its market price, the lowest and highest recent sale price and the number of sales behind the market price. An unknown id is a 404. Costs 1 credit per request.

POST/api/v1/tcgplayer/product

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

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.tcgplayer.product(product_id=219058)["data"]

print(p["name"], p["set_name"], p["number"], "market", p["market_price"])
for s in p["skus"]:
    print(s["condition"], s["printing"], s["language"], s["market_price"],
          s["lowest_sale_price"], "-", s["highest_sale_price"], f'({s["sale_count"]} sales)')

Response

"product_id": 219058,

"name": "Charizard - 3/70 (#39 Charizard Stamped)",

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

"game": "Pokemon",

"game_id": 3,

"set_name": "Battle Academy",

"set_code": "BTA",

"set_id": 2686,

"number": "003/070",

"rarity": "Promo",

"product_type": "Cards",

"product_type_id": 1,

"sealed": false,

"foil_only": false,

"normal_only": true,

"release_date": "2020-07-31",

"market_price": 7.09,

"median_price": 8.44,

"lowest_price": 4,

"lowest_price_with_shipping": 4.9,

"listing_count": 64,

"seller_count": 61,

"description": "Ability — Resolute Flame This Pokémon's attacks do 30 more damage to your opponent's Active Pokémon for each of their Pokémon-GX and Pokémon-EX in play.",

"flavor_text": "NO. 006 Flame Pokémon HT: 5'07" WT: 199.5 lbs. Its wings can carry this Pokémon close to an altitude of 4,600 feet. It blows out fire at very high temperatures.",

"note": null,

"sku_count": 5,

"response_time": 4826

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.tcgplayer.product(product_id=219058)["data"] print(p["name"], p["set_name"], p["number"], "market", p["market_price"]) for s in p["skus"]: print(s["condition"], s["printing"], s["language"], s["market_price"], s["lowest_sale_price"], "-", s["highest_sale_price"], f'({s["sale_count"]} sales)')