Catalog API Documentation
Browse and search card data by name. Query games, expansions, and cards using human-readable names instead of numeric IDs.
Name-Based Card Data
Search and browse card catalogs using game names, expansion names, and card names.
Name-Based Search
Query by human-readable names instead of numeric IDs. Perfect for search bars and autocomplete.
Hierarchical Browsing
Drill down from games to expansions to cards with simple query parameters.
Rich Card Details
Get comprehensive card data including images, rarity, product IDs, and optional pricing in one call.
Plan-Gated Data
Card details endpoint returns pricing data on Business+ and live listings on Unlimited plans.
40+ Games
Complete catalog data for Pokemon, MTG, Yu-Gi-Oh!, and dozens more TCGs.
Flexible Lookups
Look up card details by name or directly by productId for maximum flexibility.
Catalog API Endpoints
All endpoints require authentication via x-api-key header.
/api/v1/catalog/gamesGet a list of all distinct game names in the catalog.
/api/v1/catalog/expansionsGet all expansion names for a specific game.
/api/v1/catalog/cardsGet all card names for a specific game and expansion.
/api/v1/catalog/card-detailsGet detailed card information by name or product ID. Includes pricing (Business+) and listings (Unlimited).
Example Responses
Human-readable queries, structured JSON responses.
{
"success": true,
"count": 125,
"data": [
"Surging Sparks",
"Stellar Crown",
"Shrouded Fable",
"Twilight Masquerade",
"Temporal Forces",
"Paldean Fates",
"..."
]
}{
"success": true,
"data": {
"productId": 564230,
"name": "Charizard ex",
"gameName": "Pokemon",
"expansionName": "Surging Sparks",
"image": "https://...",
"groupId": 23456,
"prices": { ... },
"listings": { ... }
}
}What Can You Build?
The Catalog API is ideal for user-facing search and browse experiences.
Search Interfaces
Build search bars and autocomplete that let users find cards by name, game, and expansion.
Card Databases
Create browsable card databases organized by game and expansion.
Deck Builders
Power deck building tools with name-based card lookups and detailed card information.
Price Checkers
Let users type a card name and instantly see current market prices.
Frequently Asked Questions
Common questions about the Catalog API.
What is the Catalog API?
The Catalog API provides name-based endpoints to browse and search trading card game data. Query by game name, expansion name, and card name instead of numeric IDs.
How does the Catalog API differ from the V2 API?
The Catalog API is name-based: you query by game name, expansion name, and card name. The V2 API is ID-based: you chain requests using categoryId, groupId, and productId. Use Catalog for search/browse UIs and V2 for structured data pipelines.
What data does the card-details endpoint return?
The card-details endpoint returns comprehensive card data including name, game, expansion, product ID, image URL, and optionally pricing data (Business+) and live listings (Unlimited) depending on your plan.
Can I look up cards by product ID?
Yes, the /catalog/card-details endpoint supports both name-based lookups (name + game + expansion) and direct product ID lookups (?productId=12345).
Related API Features
Explore other API endpoints for a complete integration.
Ready to Search the Catalog?
Get started with a Hobby plan and browse card data by name across 40+ trading card games.