For developers

A trading card API that returns structured data, not a guess.

POST a card photo to one REST endpoint and get back name, set, number, year, rarity and language — across Pokémon, Magic, Yu-Gi-Oh, Lorcana, One Piece, sports and more. Plain HTTP, no SDK required. When the match isn't solid, the response says so instead of forcing a wrong ID.

Cards indexed: 3,339,282+; Cards indexed
Games & sports: 43; Games & sports
Per identify: ~2–3s; Per identify

Get your API key Read the docs

Free tier, no credit card.

identify.sh

Request

curl -X POST https://aicardvault.io/api/v1/identify \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -F front=@card.jpg \
  -F category=pokemon

Response

{
  "ok": true,
  "result": {
    "card": {
      "name": "Charizard ex",
      "set": "Obsidian Flames",
      "number": "125/197",
      "year": "2023",
      "rarity": "Double Rare",
      "language": "en"
    },
    "confidence": 0.94,
    "needsReview": false
  }
}

Same endpoint the scanner and every app on the platform use.

Built for integration, not a demo

The same endpoint that powers the free scanner is what you call from your own backend, marketplace listing flow, or grading pipeline.

One endpoint, every category

TCG and sports/entertainment cards share the same request shape and response contract — no separate integration per game.

~2–3 seconds per identify

Typical round-trip time for a single POST /api/v1/identify call, from upload to structured JSON.

Honest needsReview, not a forced match

Below our confidence floor you get needsReview:true and card:null, with best guesses in an alternates array — never a confidently wrong card.

Plain REST — no SDK required

Standard multipart POST with a bearer token. Call it from any language or no-code tool that can make an HTTP request; there is no proprietary SDK to install.

Want the exhaustive per-game catalog counts first? Browse the card database.

Pricing that scales with real usage

Every plan gets the full multi-game catalog, honest needsReview behavior, and feedback-driven corrections. Rate limits and included volume scale up the tiers.

Free

$0/mo

1,000 identify requests / mo

Starter

$15/mo

6,000 identify requests / mo

Pro

$55/mo

25,000 identify requests / mo

Business

$110/mo

60,000 identify requests / mo

Scale

$225/mo

150,000 identify requests / mo

See full pricing

TCG API FAQ

Is there an SDK?

Not yet — the API is plain REST over HTTPS, so any language or tool that can make an HTTP request and read JSON can integrate it. If that changes, it'll be announced on the changelog.

What does a request actually look like?

A multipart POST to /api/v1/identify with a bearer token and a front-image file (plus an optional category hint). Full field-by-field reference, including error codes, is in the docs.

What happens when the API can't confidently identify a card?

You get a 200 response with needsReview:true and card:null, plus an alternates array of the closest candidates. Your integration stays simple — check needsReview, don't guess on a low-confidence match.

Do I need a credit card to try it?

No. The Free plan includes 1,000 identify requests a month with no credit card required.

Start identifying cards in one request.

Free tier, no credit card. Full docs and error reference when you're ready to integrate.

Get your API key Read the docs