Search the card catalog
Full-text search across the TCGPlayer/Collectr catalog — cards and sealed product from Pokémon, Magic, One Piece, Lorcana, YuGiOh and more. Filter by category, cards vs sealed, language or set, and page with offset. Returns clean card summaries with market pricing and the finish × grade combinations that have a price; every hit is addressable by its tcgplayer_id.
Costs 2 credits per request.
Authorization
ApiKeyAuth API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.
In: header
Query Parameters
Free-text search term (card name).
1 <= lengthRestrict to a category by id ("3") or name ("Pokemon") — see /tcgplayer/categories.
Restrict to one set (group id).
^\d+$Only single cards, or only sealed product.
Value in
- "cards"
- "sealed"
Card language: English, Japanese or Chinese.
Value in
- "en"
- "jp"
- "cn"
Max results returned (upstream pages are 50).
1 <= value <= 5020Skip this many results — pass the previous page's next_offset.
0 <= value0Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/tcgplayer/search?q=charizard"{ "query": "string", "count": 0, "offset": 0, "next_offset": 0, "results": [ { "tcgplayer_id": "659612", "name": "Mega Charizard X ex", "category": "Pokemon", "category_id": "3", "set": "Mega Evolution Promos", "set_id": "24451", "card_number": "023", "rarity": "Promo", "sub_type": "Holofoil", "is_card": true, "image": "https://tcgplayer-cdn.tcgplayer.com/product/659612_in_1000x1000.jpg", "market_price": 37.63, "price_change": 0.03, "price_change_pct": 0.08, "url": "https://www.tcgplayer.com/product/659612/", "previous_market_price": 37.6, "set_slug": "ex-dragon", "available_variants": [ { "sub_type": "Holofoil", "grade_id": "12", "label": "PSA 10" } ] } ]}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}