Pokemon Card API: The Complete Developer Guide (2026)

The three kinds of Pokemon card API

Most "what's the best Pokemon card API" confusion comes from mixing up three jobs:

• Catalog data - what cards exist: sets, numbers, rarities, attacks, images. The input is a structured query ("give me every card in Base Set").
• Price data - what cards sell for. The input is a card identifier, the output is market values.
• Image understanding - what card is in this photo, what condition is it in, what is it worth. The input is a picture from a camera or scanner.

No single API does all three well, and the best products usually combine two: a catalog API for browse-and-search, plus an image API for the camera flow, or a catalog API plus a price API for collection valuation.

Every option at a glance

Provider details accurate to the best of our knowledge as of June 2026; check each provider's docs for current plans and terms. Looking specifically for a TCGplayer replacement? See our TCGplayer API alternatives guide.

Catalog APIs: pokemontcg.io, Scrydex, and TCGdex

pokemontcg.io is the API a generation of Pokemon projects was built on: free, well-documented, with set and card data plus card images. It still works, but the team behind it has shifted its energy to Scrydex, a commercial multi-TCG rebuild with broader coverage and market price points on card records - new production projects should probably start there.

TCGdex is the open-source alternative: no API key, REST and GraphQL, and card data in a dozen-plus languages, which matters if you serve collectors outside the English-speaking market. It's catalog-focused, so pair it with a price API for anything money-related.

All three share one limitation by design: you have to already know which card you're asking about. They answer "give me data for Charizard 4/102"; they can't answer "what card is this?"

Price APIs: JustTCG and PriceCharting

JustTCG tracks market prices across Pokemon, Magic, Yu-Gi-Oh! and other games, by printing and condition, behind a clean self-serve key. PriceCharting bases its numbers on actual sold listings and is one of the few sources that prices graded slabs (PSA/BGS/CGC) separately from raw copies - useful for grading-ROI math. Both are pricing layers: you bring the card identifiers, they bring the numbers.

Image-based: when your input is a photo

Every API above needs a card identifier. An image-based API starts one step earlier - with the photo itself. Full disclosure: this category is our product, so weigh this section accordingly.

The CardGrader.AI API takes a card photo (Pokemon, sports, and other TCGs) and runs the modules you choose:

• identify - name, set, number, rarity/parallel, print run. This is the "card scanner API" / "card recognition API" job: photo in, structured card data out.
• grade - a predicted professional-style (PSA-scale) condition grade with centering, corners, edges, and surface sub-grades plus a written justification. Useful as a pre-screen before paying for real grading.
• market - raw and graded USD value estimates built from real sold sales, with a per-grade value spread.
• full - all of it in one pass.

Getting started is one curl call - no signup form, which also makes it usable by AI agents (there's an MCP server at cardgrader.ai/mcp that agents can self-onboard through):

# 1. Register (returns an API key + free trial credits)
curl -X POST https://cardgrader.ai/v1/agents \
  -H "Content-Type: application/json" \
  -d '{ "name": "my-pokemon-app", "contactEmail": "you@example.com" }'

# 2. Scan a card (front + back photos, pick your modules)
curl -X POST https://cardgrader.ai/v1/scans \
  -H "Authorization: Bearer cgk_..." \
  -H "Content-Type: application/json" \
  -d '{ "frontImageUrl": "https://example.com/front.jpg",
        "backImageUrl": "https://example.com/back.jpg",
        "modules": ["identify"] }'

# 3. Poll the result (typically 30-120 seconds)
curl https://cardgrader.ai/v1/scans/12345 -H "Authorization: Bearer cgk_..."

Honest constraints: scans are queue-backed (submit and poll, not synchronous), each scan costs credits after the trial (current pricing is at /api-docs and GET /v1/pricing), and both front and back photos are required because grading and identification analyze both sides.

Which Pokemon card API should you pick?

• Deck builder or set browser: Scrydex (supported, modern) or TCGdex (free, open source).
• Collection value tracker: a catalog API + JustTCG or PriceCharting.
• Scanner app, listing tool, or anything camera-first: CardGrader.AI for the photo-to-data step; add a catalog API if you also need full set browsing.
• Grading pre-screen / "should I grade this?" tools: CardGrader.AI grade + market - the per-grade value spread is the ROI math.
• AI agent workflows: the MCP server at cardgrader.ai/mcp; agents register themselves and pay per scan.

Frequently asked questions

Is there a free Pokemon card API?

Yes - pokemontcg.io (free key) and TCGdex (no key at all) for catalog data. CardGrader.AI includes free trial credits for image-based identification, and the browser-based value checker is free with no key.

Is there a Pokemon card API that works from a photo?

That's the image-based category: CardGrader.AI identifies a card from front and back photos and can also grade its condition and estimate its value in the same call. Catalog APIs can't do this - they need you to already know the card.

What's the best Pokemon card database API?

For a pure card database, Scrydex (commercial, supported) or TCGdex (open source, multilingual). pokemontcg.io remains fine for hobby use.

Can an API tell me what grade my Pokemon card would get?

No API can promise what PSA or BGS will assign, but CardGrader.AI's grade module returns an AI-predicted professional-style grade with sub-grades - collectors use it to decide whether a card is worth submitting. See our PSA API guide for the full grading-data picture.

Which API covers sports cards too?

The catalog APIs here are Pokemon/TCG-centric. CardGrader.AI identifies and grades sports cards (including parallels and print runs); PriceCharting and JustTCG cover some sports categories on the pricing side.