Gibt es eine API zur Kartenerkennung für Magic, Lorcana, Yu-Gi-Oh! und One Piece?

Ein Endpunkt, ein zusätzliches Feld

Es ist derselbe Endpunkt wie für Pokémon: POST an https://europe-west1-neosatoshi.cloudfunctions.net/detectApi mit Authorization: Bearer <key> und dem Bild als Base64 (image) oder als öffentlicher https-Link (image_url). Ohne "tcg" wird das Bild als Pokémon gelesen, gib also das Spiel mit:

{ "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, englische und deutsche Karten.
• "lorcana": Disney Lorcana, englische, deutsche, französische und italienische Karten.
• "yugioh": Yu-Gi-Oh! TCG, englische, deutsche, französische, italienische, spanische und portugiesische Karten.
• "onepiece": One Piece, englische und japanische Karten.

Schick bei diesen vier Spielen eine Karte pro Foto; nur bei Pokémon werden mehrere Karten in einem Foto erkannt. Diese Anfrage läuft so, wie sie ist, mit unserem Lorcana-Beispielscan und dem öffentlichen Demo-Schlüssel:

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

• Nur englische und deutsche Karten. Karten in anderen Sprachen ergeben keine Karte und kosten keinen Karten-Scan.
• Die Karte wird aus ihrem gedruckten Text bestimmt. name ist der englische Name, auch bei deutschen Karten; localized_name enthält den gedruckten deutschen Namen.
• Der Druck kommt aus Set-Code und Sammlernummer, wo die Karte sie hat, und print_source sagt, wie er gefunden wurde. Karten vor dem Kartenrahmen von 2014 haben keinen aufgedruckten Set-Code, der Druck lässt sich also nicht lesen: Dann ist print_unconfirmed true, es gibt absichtlich keinen Preis, und alternatives listet bis zu 12 Drucke, die neuesten zuerst, jeder mit eigenen Preisen, zur Auswahl durch deinen Nutzer.
• oracle_id ist die Karte über alle Drucke hinweg, card_id ein einzelner Druck. Sammlernummern sind Strings wie "123★" oder "2a", lies sie also nie als Ganzzahl ein.
• Foil-Preise sind getrennt: prices.cardmarket (Nicht-Foil) und prices.cardmarket_foil in EUR, dazu TCGplayer-Marktpreise für Nicht-Foil und Foil in USD. Die Ausführung wird nicht aus dem Foto gelesen, lass also deinen Nutzer wählen; finishes nennt die vorhandenen Ausführungen, und foil_only markiert Drucke ohne Nicht-Foil-Version.
• Tokens und Art Cards sind nicht im Katalog.
• Gemessen: eine mittlere Genauigkeit (Median) von 97,6 % in unserer internen Auswertung (Oktober 2026).

Warum der Druck bei Magic-Preisen so viel ausmacht: welchen Druck einer Magic-Karte du hast.

Disney Lorcana

• Englische, deutsche, französische und italienische Karten.
• name ist der Titel und version der Untertitel; full_name verbindet beides und ist der Name, den du anzeigst. name_en und full_name_en enthalten den englischen Namen, auch bei deutschen, französischen und italienischen Karten.
• color ist die Tinte: Amber, Amethyst, Emerald, Ruby, Sapphire oder Steel.
• Foil- und Nicht-Foil-Preise von Cardmarket: prices.cardmarket ist der Nicht-Foil-Preis, prices.cardmarket_foil der Foil-Preis. is_foil ist true bei Drucken, die es nur als Foil gibt (Enchanted, Epic, Iconic und die meisten Promos); bei Drucken in beiden Ausführungen ist es false, und dein Nutzer entscheidet. Ein fehlender Preis ist null, nie 0.
• art_unconfirmed markiert einen mehrdeutigen Druck, zum Beispiel die normale Karte gegenüber ihrer Enchanted-Version; alternatives listet die anderen.

Mehr zur Foil-Frage für Verkäufer: Lorcana-Foil-Karten listen und bepreisen.

Yu-Gi-Oh!

• TCG-Drucke auf Englisch, Deutsch, Französisch, Italienisch, Spanisch und Portugiesisch. Japanische und koreanische OCG-Karten werden nicht unterstützt.
• Der gedruckte Set-Code, zum Beispiel ROTA-DE024, bestimmt Set und Sprache und kommt in set.code zurück. name ist der englische Name, localized_name der Name in der Sprache der Karte und card_id der 8-stellige Passcode.
• rarity und edition: "first", "unlimited" oder "limited", von der Karte gelesen.
• Gibt es einen Set-Code in mehreren Seltenheiten, ist rarity_unconfirmed true: Die günstigste kommt zuerst, die anderen stehen in alternatives, denn nur die Foil-Ausführung unterscheidet sie.
• Gibt es zu einem Code und einer Seltenheit mehrere Drucke (Original und Reprint, alternatives Artwork), ist version_unconfirmed true, und price_versions listet jeden mit eigenem Preis.
• Preise: Cardmarket in EUR (trend, low, avg7, avg30, für jede Edition gleich, weil Cardmarket Editionen nicht trennt) und TCGplayer in USD pro Edition (by_edition). Ein fehlender Preis ist null, nie 0.
• Gemessen: auf 315 echten Fotos aus eBay-Angeboten (Oktober 2026) die richtige Karte bei 99,3 % davon.

Hintergrund zu Codes und Editionen: Yu-Gi-Oh!-Set-Codes und TCG gegenüber OCG.

One Piece

• Englische und japanische Karten.
• card_id ist die auf der Karte gedruckte Sammler-ID, zum Beispiel OP01-003. Dazu kommen color, type, Seltenheit, Cardmarket-Produkt-ID und Cardmarket-Preise in EUR.

Dieselben Regeln für alle vier Spiele

• Ein Karten-Scan pro erkannter Karte. Ein Foto ohne Karte gibt HTTP 422 zurück und kostet nichts.
• Ist ein Druck nicht sicher, lässt die API den Preis leer und listet die Optionen, statt zu raten. Zeig solche Karten deinem Nutzer zur Auswahl.
• Der Zustand wird nie beurteilt. Den setzt dein Nutzer.
• Synchron: etwa 5 Sekunden für eine warme Anfrage, 10 bis 15 Sekunden für eine kalte. Setz das Timeout im Client auf 120 Sekunden.

Häufige Fragen

Liest die API japanische Yu-Gi-Oh!- oder japanische Magic-Karten?

Nein. Yu-Gi-Oh! umfasst TCG-Drucke in sechs europäischen Sprachen, nicht das japanische oder koreanische OCG. Magic umfasst englische und deutsche Karten; Karten in anderen Sprachen ergeben keine Karte und kosten nichts.

Kann ich mehrere Magic- oder Lorcana-Karten in einem Foto schicken?

Nein, bei Magic, Lorcana, Yu-Gi-Oh! und One Piece gilt eine Karte pro Foto. Mehrere Karten pro Foto, auch Ordnerseiten, gehen bei Pokémon: siehe die API zur Pokémon-Kartenerkennung.

Woher weiss ich, ob eine Magic- oder Lorcana-Karte Foil ist?

Das Foto verrät die Ausführung nicht zuverlässig, deshalb liefert die API beide Preise und überlässt dir die Entscheidung. Bei Magic sagen finishes und foil_only, welche Ausführungen es gibt; bei Lorcana ist is_foil true bei Drucken, die es nur als Foil gibt.

Welches Spiel ist der Standard?

Pokémon. Eine Anfrage ohne "tcg" wird als Pokémon gelesen, schick das Feld bei den anderen vier Spielen also immer mit.