Trading Card Recognition API
Instant card identification for 50+ trading card games. Send an image, get instant product matches. Build card scanning features in minutes.
How Card Recognition Works
Three simple steps to identify any trading card
Upload Image
Send your card image to our API endpoint via multipart form upload
Image Analysis
Our system analyzes the image and matches it against our database
Get Results
Receive the top 10 matching product IDs with confidence scores
// Send a card image for recognition
const formData = new FormData();
formData.append('image', imageFile); // Your card image file
formData.append('limit', '10'); // Optional: number of results (default 10)
const response = await fetch('https://api.tcgapis.com/api/v1/recognize', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY'
},
body: formData
});
const data = await response.json();
// Response: Matching products with confidence scores
{
"success": true,
"results": [
{
"score": 98.5,
"filepath": "pokemon/base-set/charizard.jpg",
"metadata": { "image_id": "12345", "product_id": "67890" }
},
// ... more matches
],
"usage": {
"used": 150,
"limit": 1000,
"remaining": 850
}
}Try Card Recognition Now
Upload a trading card image and see our recognition in action. 5 free tries per day.
Drop your card image here or click to browse
Supports JPEG, PNG, GIF, WebP (max 10MB)
Need more than 5 tries? Sign up for full API access.
Get API Access50+ Trading Card Games Supported
Our system recognizes cards from all major TCGs and many niche games
Included With All Plans
Card recognition comes bundled with your API subscription at no extra cost. Hobby includes 1,000 calls, Business includes 5,000 calls, and Unlimited includes 50,000 recognition requests.
View PricingWhat Can You Build?
Power your applications with instant card identification
Mobile Card Scanning Apps
Build mobile apps that let users scan cards with their camera to instantly identify and price check their collection.
Inventory Management
Speed up card intake and cataloging by scanning cards instead of manually searching your database.
Point of Sale Integration
Enable instant card lookup at checkout counters, reducing wait times and pricing errors.
Collection Apps
Let collectors quickly add cards to their digital collection by snapping a photo instead of searching.
Frequently Asked Questions
Everything you need to know about the Card Recognition API
What is the Card Recognition API?
The Card Recognition API identifies trading cards from images using our proprietary recognition technology. Upload an image file and receive the top 10 matching product IDs with confidence scores, enabling developers to build card scanning and identification features into their applications.
Which trading card games are supported?
Our Card Recognition API supports all 50+ trading card games in our database including Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Flesh and Blood, One Piece TCG, Disney Lorcana, and many more.
How accurate is the card recognition?
Our recognition system is built on millions of trading card images and provides highly accurate identification. The API returns the top 10 matches with confidence scores, ensuring you can handle edge cases gracefully.
How many recognition requests are included?
Card recognition is included with all plans: Hobby plan includes 1,000 recognition calls per month, Business plan includes 5,000 calls, and Unlimited plan includes 50,000 recognition requests.
What image formats are supported?
The API accepts image uploads via multipart/form-data in common formats including JPEG, PNG, GIF, and WebP. Maximum file size is 10MB. For best results, use clear, well-lit photos of the card front with minimal background clutter.
Start Building Today
Add card recognition to your app in minutes. Sign up and start scanning cards immediately.