Choose the data you need
TCGAPIs provides separate catalog, price, sales-history and listing endpoints. The v2 contract was reviewed on 7 November 2026; the signup-credit offer was updated on 9 November 2026. The documentation is the reference for endpoint fields and the calls each request takes.
Every monthly plan can call every endpoint. The plans differ in their monthly allowance and in how many calls a request takes:
- Hobby has 20,000 general API calls per month. Catalog, price and history requests take 1 call, SKU prices and listings 5.
- Business has 50,000 general calls per month. Prices and history take 1 call, SKU prices and listings 5.
- Unlimited has no general API or recognition cap, and every request takes 1 call.
New accounts receive 100 free credits for all customer data API endpoints. Credits pay for requests: 1 credit for a catalog lookup or a card scan, 2 for a price or certificate lookup, 5 for live listings. After your free credits are used, buy a credit pack (from £10, no subscription) or choose a monthly plan. See pricing for the current plan definitions and credit packs.
Discover a game
The games endpoint is public:
curl 'https://api.tcgapis.com/api/v2/games?limit=100'The result is an object containing success, pagination fields and a data array. It is not a bare array. Pokemon's category ID is 3; other games have their own category IDs.
Request sets and cards
Keep your API key on your server and send it in x-api-key. A JWT Bearer token is for signed-in website routes, not these data requests.
const headers = { 'x-api-key': process.env.TCGAPIS_KEY };
async function get(path) {
const response = await fetch('https://api.tcgapis.com/api/v2' + path, { headers });
const body = await response.json();
if (!response.ok || !body.success) throw new Error(body.error || 'API request failed');
return body;
}
const expansions = await get('/expansions/3?limit=25&offset=0');
console.log(expansions.data); // Array of expansion records
const groupId = expansions.data[0]?.groupId;
if (!groupId) throw new Error('No expansion returned');
const cards = await get('/cards/' + groupId + '?limit=25&offset=0');
cards.data.forEach(card => console.log(card.productId, card.name));Use count, total, offset and limit to retrieve further pages. The first result is an example for browsing, not a recommendation or verified printing selection. Inspect the set, card and printing before using the product ID.
Read product prices
Product prices cost 2 credits per request; on a monthly plan they take 1 call. Use an ID you have verified from the catalog:
const productId = Number(process.env.TCGAPIS_PRODUCT_ID);
if (!Number.isSafeInteger(productId) || productId <= 0) throw new Error('Set a verified product ID');
const prices = await get('/prices/' + productId);
console.log(prices.data.prices); // Object keyed by printing, such as Normal or Foil
console.log(prices.data.last_updated); // May be missing or nullDo not read prices.marketPrice or assume every field has a value. Each printing has its own price record, and missing values are unavailable, not zero. TCGPlayer product prices are USD; other sources have their own currencies.
Handle errors and freshness
Handle authentication errors, allowance and credit limits, missing records and temporary upstream failures separately. A monthly allowance with too few calls left for a request returns HTTP 429 with code: INSUFFICIENT_ALLOWANCE. Do not retry unchanged invalid credentials or missing products indefinitely. Respect Retry-After when returned, and keep your application requests within the plan allowance.
There is no universal freshness guarantee across datasets. Use record timestamps when supplied, distinguish your retrieval time from the source update time, and disclose missing data in your UI.
Start from a photo
The card recognition demo takes a photo and a game and returns ranked product candidates. A match score is not a calibrated probability. Confirm the chosen identity before using its product ID for prices.
Hobby includes 1,000 recognition calls per month, Business 15,000, and Unlimited has no recognition cap. The public demo has a separate limit of 10 successful requests per IP per day.
Get Your API Key
Explore catalog records across 60+ trading card games, with price, listing and sales-history data where available.
Start Building