V2 API Documentation
Streamlined endpoints with a chainable workflow. Go from games to expansions to cards to prices in just a few API calls.
How the V2 API Works
Follow the chain: each endpoint returns the IDs needed for the next step.
List Games
/api/v2/gamesGet all supported games and their categoryId values.
Get Expansions
/api/v2/expansions/:categoryIdUse the categoryId to fetch all expansions and their groupId values.
Get Cards
/api/v2/cards/:groupIdUse the groupId to fetch all cards and their productId values.
Get Data
/api/v2/prices/:productIdUse the productId to fetch prices, listings, sales history, or historic prices.
V2 API Endpoints
All endpoints return JSON. Authentication via x-api-key header.
/api/v2/gamesGet all supported trading card games with their category IDs.
/api/v2/expansions/:categoryIdGet all expansions (sets) for a specific game by its category ID.
/api/v2/cards/:groupIdGet all cards in an expansion by its group ID. Includes card images.
/api/v2/prices/:productIdGet pricing data for a specific card by its product ID.
/api/v2/livelistings/:productIdGet real-time marketplace listings for a specific card.
/api/v2/sales-history/:productIdGet recent sales history with statistics and price trend analysis.
/api/v2/historic-prices/:productIdGet historical price data for a card over time.
Example Responses
Clean, consistent JSON responses across all endpoints.
{
"success": true,
"count": 42,
"data": [
{
"categoryId": 3,
"name": "Magic",
"displayName": "Magic: The Gathering",
"image": ""
},
{
"categoryId": 2,
"name": "YuGiOh",
"displayName": "Yu-Gi-Oh!",
"image": ""
}
]
}{
"success": true,
"count": 150,
"data": [
{
"productId": 12345,
"name": "Charizard ex",
"image": "https://...",
"rarity": "Double Rare",
"number": "006",
"cleanName": "Charizard ex"
}
]
}What Can You Build?
The V2 API provides everything you need for powerful TCG applications.
Collection Trackers
Build apps that let users browse games, find their cards, and track portfolio value over time.
Price Comparison Tools
Compare prices across variants and conditions using the chained data flow.
Market Analytics
Analyze sales history and historic prices to identify market trends and opportunities.
Store Inventory
Power your card shop with structured game data, real-time prices, and live marketplace listings.
Frequently Asked Questions
Common questions about the V2 API.
What is the V2 API?
The V2 API is TCGAPIs' latest API version providing a streamlined, chainable workflow: games → expansions → cards → prices. It offers 7 endpoints covering game data, card catalogs, pricing, live listings, sales history, and historic prices.
What plan do I need for the V2 API?
The /games endpoint is free and public. Expansions and cards require a Hobby plan or higher. Prices, sales history, and historic prices require a Business plan. Live listings require an Unlimited plan.
How does the V2 API differ from V1?
V2 provides a more intuitive chained workflow, cleaner response formats, and additional endpoints like historic prices and sales history with built-in statistics. V2 also includes image URLs for cards.
How do I chain V2 API calls?
Start with /games to get categoryId values, then use /expansions/:categoryId to get groupId values, then /cards/:groupId to get productId values, and finally /prices/:productId for pricing data.
Which trading card games are supported?
We support 40+ TCGs including Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Flesh and Blood, One Piece, Disney Lorcana, Star Wars Unlimited, and many more.
Related API Features
Explore other API endpoints to complement your V2 integration.
Ready to Use the V2 API?
Get started with our free tier and browse game data. Upgrade for full access to cards, pricing, and market data.