Is there a card recognition API for Magic, Lorcana, Yu-Gi-Oh! and One Piece?

One endpoint, one extra field

It is the same endpoint as for Pokémon: POST https://europe-west1-neosatoshi.cloudfunctions.net/detectApi with Authorization: Bearer <key> and the image as base64 (image) or as a public https link (image_url). Without "tcg" the image is read as Pokémon, so add the game:

{ "image": "<base64 JPEG or PNG>", "tcg": "magic" }
{ "image": "<base64 JPEG or PNG>", "tcg": "lorcana" }
{ "image": "<base64 JPEG or PNG>", "tcg": "yugioh" }
{ "image_url": "https://example.com/op01-003.jpg", "tcg": "onepiece" }

• "magic": Magic: The Gathering, English and German cards.
• "lorcana": Disney Lorcana, English, German, French and Italian cards.
• "yugioh": Yu-Gi-Oh! TCG, English, German, French, Italian, Spanish and Portuguese cards.
• "onepiece": One Piece, English and Japanese cards.

Send one card per photo for these four games; only Pokémon reads several cards in one photo. This request runs as is, with our Lorcana example scan and the public demo key:

curl -X POST https://europe-west1-neosatoshi.cloudfunctions.net/detectApi \
  -H "Authorization: Bearer nsk_live_9c253fbed995042a98280ad13e5c47d3c4a59c9b4f0f7274" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://neosatoshi.com/static/images/example_api_lorcana.jpg", "tcg": "lorcana"}'

Magic: The Gathering

• English and German cards only. Cards in other languages return no card and cost no card scan.
• The card is identified from its printed text. name is the English name, also for German cards; localized_name holds the printed German name.
• The printing comes from the set code and collector number where the card has one, and print_source says how it was found. Cards from before the 2014 frame have no set code printed on them, so the printing cannot be read: then print_unconfirmed is true, there is no price on purpose, and alternatives lists up to 12 printings, newest first, each with its own prices, for your user to pick.
• oracle_id is the card across all its printings, card_id one printing. Collector numbers are strings such as "123★" or "2a", so never parse them as integers.
• Foil prices are separate: prices.cardmarket (non-foil) and prices.cardmarket_foil in EUR, plus TCGplayer market and foil prices in USD. The finish is not read from the photo, so let your user choose; finishes lists the finishes that exist and foil_only marks printings without a non-foil version.
• Tokens and art cards are not in the catalog.
• Measured: median accuracy of 97.6% in our internal evaluation (October 2026).

Why the printing matters so much for Magic prices: how to tell which printing of a Magic card you have.

Disney Lorcana

• English, German, French and Italian cards.
• name is the title and version the subtitle; full_name joins both and is the name to show. name_en and full_name_en carry the English name, also for German, French and Italian cards.
• color is the ink: Amber, Amethyst, Emerald, Ruby, Sapphire or Steel.
• Foil and non-foil Cardmarket prices: prices.cardmarket is the non-foil price, prices.cardmarket_foil the foil price. is_foil is true for foil-only printings (Enchanted, Epic, Iconic and most promos); for printings that exist in both finishes it is false and your user decides. A missing price is null, never 0.
• art_unconfirmed marks an ambiguous printing, for example the regular card against its Enchanted version; alternatives lists the others.

More on the foil question for sellers: how to list and price Lorcana foil cards.

Yu-Gi-Oh!

• TCG prints in English, German, French, Italian, Spanish and Portuguese. Japanese and Korean OCG cards are not supported.
• The printed set code, for example ROTA-DE024, decides set and language and comes back in set.code. name is the English name, localized_name the name in the card's language and card_id the 8-digit passcode.
• rarity and edition: "first", "unlimited" or "limited", read from the card.
• When one set code exists in several rarities, rarity_unconfirmed is true: the cheapest comes first and the others are in alternatives, because only the foil tells them apart.
• When one code and rarity has several prints (original and reprint, alternate art), version_unconfirmed is true and price_versions lists each one with its own price.
• Prices: Cardmarket in EUR (trend, low, avg7, avg30, the same for every edition, because Cardmarket does not split editions) and TCGplayer in USD per edition (by_edition). A missing price is null, never 0.
• Measured: on 315 real eBay listing photos (October 2026), the correct card in 99.3% of them.

Background on codes and editions: Yu-Gi-Oh! set codes and TCG vs OCG.

One Piece

• English and Japanese cards.
• card_id is the collector id printed on the card, for example OP01-003. The card also comes with color, type, rarity, Cardmarket product ID and Cardmarket prices in EUR.

The same rules for all four games

• One card scan per detected card. A photo without a card returns HTTP 422 and costs nothing.
• When a printing is not certain, the API leaves the price empty and lists the options instead of guessing. Show those cards to your user as "please pick".
• Condition is never judged. Let your user set it.
• Synchronous: about 5 seconds for a warm request, 10 to 15 seconds for a cold one. Set a client timeout of 120 seconds.

Frequently asked questions

Does the API read Japanese Yu-Gi-Oh! or Japanese Magic cards?

No. Yu-Gi-Oh! covers TCG prints in six European languages, not the Japanese or Korean OCG. Magic covers English and German cards; cards in other languages return no card and cost nothing.

Can I send several Magic or Lorcana cards in one photo?

No, one card per photo for Magic, Lorcana, Yu-Gi-Oh! and One Piece. Several cards per photo, including binder pages, work for Pokémon: see the Pokémon card recognition API.

How do I know whether a Magic or Lorcana card is foil?

The photo does not tell the finish reliably, so the API returns both prices and lets you decide. For Magic, finishes and foil_only say which finishes exist; for Lorcana, is_foil is true for foil-only printings.

Which game is the default?

Pokémon. A request without "tcg" is read as Pokémon, so always send the field for the other four games.