·
SprievodcaAPIPorovnanie

Najlepšie TCG API v roku 2026 — Kompletný sprievodca pre vývojárov

Komplexné porovnanie TCG API pre vývojárov. Ceny, funkcie, SDK, rate limity pre Pokémon, MTG, Yu-Gi-Oh! a ďalšie zberateľské kartové hry.

Potrebujete cenové dáta pre zberateľské kartové hry. Otvoríte prehliadač, zadáte „TCG API” — a ocitnete sa v mori opustených služieb, OAuth pekla, obmedzení na jedinú hru a produktov, ktoré neboli aktualizované od roku 2023. Niektoré sú mŕtve. Iné sa skrývajú za inštitucionálnymi schvaľovacími procesmi. Niektoré vás zablokujú na hodinu, ak pošlete požiadavky príliš rýchlo.

Tento sprievodca to všetko preseká.

Hodnotili sme všetky hlavné TCG API dostupné v roku 2026: pokrytie hier, čerstvosť dát, kvalitu SDK, komplexnosť autentifikácie, ceny, rate limity, podporu ohodnotených kariet a to, či bude služba aktívna aj o šesť mesiacov. Preskúmali sme čísla, prečítali dokumentáciu, otestovali endpointy.

Záver: jedno API jasne prekonáva ostatné, pričom druhý zdroj výrazne uľahčuje vývoj na jeho základe. Zvyšok sa pohybuje od „výrazne obmedzený” po „aktívne nebezpečný na to, aby ste na ňom závisleli”.

Ak vytvárate sledovač cien, nástroj na správu zbierok, Discord bota, nástroj pre portfólio alebo čokoľvek, čo pracuje s cenami zberateľských kariet naprieč viacerými hrami — toto je porovnávací sprievodca, ktorý by ste mali prečítať pred napísaním čo i len jedného riadku kódu.

Čo robí TCG API skutočne použiteľným?

Nie každý vývojár potrebuje rovnaké veci. Existujú však základné požiadavky, ktoré oddeľujú hračkárske API od tých, s ktorými môžete skutočne vybudovať produkt. Tu je rámec, ktorý sme použili na hodnotenie všetkých služieb v tomto sprievodcovi.

Pokrytie hier

Ak API pokrýva len jednu hru, už ste sa zahnali do kúta. Trh TCG v roku 2026 zahŕňa Pokémon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited, Flesh and Blood a ďalšie. Používatelia prechádzajú medzi hrami. Produkty, ktoré pokrývajú viacero hier, si udržia používateľov dlhšie. API, ktoré vás núti spájať štyri rôzne služby pre štyri hry, nie je API — je to dlh.

Ceny v reálnom čase z viacerých trhov

Ceny kariet sa rýchlo menia. Charizard za 80 dolárov v pondelok môže byť po výsledkoch turnaja v štvrtok 120 dolárov. API, ktoré čerpá z jediného trhu, zavádza jediný bod zlyhania pri cenotvorbe. Zlatý štandard je duálny zdrojový ceny — nezávislé čerpanie z TCGPlayer aj eBay — čo umožňuje referenčné porovnanie, odhaľovanie rozdielov a poskytovanie bohatších dát používateľom.

Ceny podľa stavu a ohodnotené ceny

Near Mint a Lightly Played nie sú tá istá karta. PSA 10 a PSA 7 nie sú rovnaké aktívum. API, ktoré poskytuje jednu „cenu” pre kartu bez rozlíšenia podľa stavu alebo stupňa ohodnotenia, poskytuje neúplné dáta. Ohodnotené karty sa stali obzvlášť veľkým segmentom trhu — stupne BGS, PSA a CGC výrazne ovplyvňujú hodnotu a vývojári vytvárajúci nástroje pre zberateľov a investorov tieto dáta potrebujú.

História cien

Cena v jednom bode je samozrejmá funkcia. To, čo oddeľuje užitočné API od skvelého, sú historické dáta — trendy za 7 dní, 30 dní, 90 dní, 1 rok. Bez histórie nemôžete vytvárať grafy, počítať kĺzavé priemery, identifikovať cenové výkyvy ani ukázať používateľom, či karta rastie alebo klesá na hodnote.

Kvalita SDK a pokrytie jazykov

OpenAPI špecifikácia je potrebná, ale nie postačujúca. Oficiálne, udržiavané SDK v jazykoch, ktoré vývojári skutočne používajú — JavaScript/TypeScript, Python, Go, Rust, PHP — znamenajú rozdiel medzi víkendovou integráciou a týždenným čítaním zdrojového kódu. Wrappery udržiavané komunitou sú dlh: zastarávajú, vynechávajú nové endpointy a nemajú povinnosť udržiavať kompatibilitu.

Jednoduchosť autentifikácie

OAuth 2.0 authorization code flow. OAuth 1.0 s HMAC-SHA1 podpismi. Tieto autentifikačné schémy mali zmysel pre aplikácie trhovísk orientované na používateľov. Pre vývojára, ktorý chce volať cenový endpoint, nemajú zmysel. Moderné API by malo autentifikovať jednou hlavičkou: X-API-Key: your-key. To je všetko.

Bezplatný plán a transparentné ceny

Ak nemôžete testovať API bez podania žiadosti, čakania na schválenie a vyjednávania podmienok — nebolo postavené pre vývojárov, bolo postavené pre podnikovú predajnú jednotku. Skutočne vývojársky priateľské API má bezplatný plán so skutočnými dátami, jasné verejné ceny a možnosť začať bez kreditnej karty.

Predvídateľné rate limity

Rate limity samotné nie sú problémom. Nepredvídateľné rate limity — alebo ešte horšie, hodinové blokovanie IP pri prekročení soft limitov — problémom sú. Potrebujete hlavičky odpovedí, ktoré vám presne povedia, kde sa nachádzate, aby ste mohli implementovať backoff logiku bez hádania.

Č. 1: TCG Price Lookup API — jasný víťaz

Nie je tu žiadny tesný druhý. TCG Price Lookup je najkompletnejšie, najvývojársky priateľnejšie a dátami najbohatšie TCG API dostupné v roku 2026. Víťazí vo všetkých dimenziách nášho hodnotiaceho rámca. Poďme sa pozrieť podrobnejšie.

Pokrytie hier: 8 hier, viac ako 300 000 kariet

TCG Price Lookup pokrýva Pokémon, Pokémon japonskú verziu, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited a Flesh and Blood — 8 hier s jedným API kľúčom, jedným SDK a jednou autentifikačnou hlavičkou. Toto je celý hlavný TCG trh vtesnaný do jednej štruktúry endpointov.

Všetky ostatné API v tomto porovnaní pokrývajú jednu hru. Niekedy dve. TCG Price Lookup pokrýva osem s indexovanými viac ako 300 000 kartami.

Duálny zdrojový ceny: TCGPlayer + eBay

Väčšina cenových API čerpá z jedného zdroja a nazýva to „reálny čas”. TCG Price Lookup čerpá z TCGPlayer aj eBay nezávisle. To je dôležité z niekoľkých dôvodov:

  • Krížová validácia trhu — Ak TCGPlayer ukazuje 45 dolárov a eBay 80 dolárov, niečo zaujímavé sa deje. Tento signál má hodnotu.
  • Odolnosť voči chybám — Ak jeden trh má dátovú medzeru alebo oneskorenie, cenové dáta stále zostávajú.
  • Predajné ceny eBay odrážajú skutočné transakčné ceny, nie len ceny ponúk. To je zásadne odlišný — a často presnejší — signál.

Ceny podľa stavu: od Near Mint po Damaged

Každá karta v databáze obsahuje ceny podľa stavu: Near Mint, Lightly Played, Moderately Played, Heavily Played, Damaged. Toto nie je voliteľná funkcia — je zabudovaná do základného dátového modelu. Každá odpoveď obsahuje kompletné spektrum stavov.

Ceny ohodnotených kariet: PSA, BGS, CGC stupne 1–10

Tu sa TCG Price Lookup skutočne odlišuje od konkurencie. Ceny ohodnotených kariet pre PSA, BGS a CGC v stupňoch 1–10 sú zahrnuté v API. Vytvárate seriózny sledovač portfólia pre zberateľov? Nástroj na arbitráž pri ohodnocovaní? Investičný dashboard? Tieto dáta nie sú inde dostupné cez API. Len tu.

História cien: 7 dní, 30 dní, 90 dní, 1 rok

Kompletná história cien cez štyri časové okná — 7 dní, 30 dní, 90 dní, 1 rok — pre každú kartu. Vytvárajte grafy trendov. Počítajte kĺzavé priemery. Upozorňujte používateľov, keď karta prudko vzrastie. Zobrazujte zhodnotenie medziročne. Bez historických dát nič z toho nie je možné — a TCG Price Lookup má všetko.

5 oficiálnych SDK — postavené a udržiavané tímom API

Toto nie je „je tu komunitný wrapper, ktorý nebol naposledy aktualizovaný pred 14 mesiacmi”. TCG Price Lookup poskytuje 5 oficiálnych SDK v jazykoch, ktoré vývojári skutočne používajú:

Všetky SDK spracúvajú automatické chunkovanie hromadných požiadaviek (max 20 ID na požiadavku, automatické chunkovanie), typované chyby, parsovanie hlavičiek rate limitu a kompletné TypeScript typy/typové nápovede.

Jednoduchá autentifikácia: jedna hlavička

curl https://api.tcgpricelookup.com/v1/search?q=charizard \
  -H "X-API-Key: tpl_live_xxxxxxxxxxxx"

To je všetko. Žiadne OAuth tance. Žiadne HMAC podpisy. Žiadne vypršanie tokenov, ktoré treba obnovovať. Jeden kľúč, jedna hlavička, pracujete.

Bezplatný plán: 200 požiadaviek denne, žiadna kreditná karta

Zaregistrujete sa, overíte e-mail, získate API kľúč. Celý proces trvá menej ako dve minúty. Bezplatný plán poskytuje 200 požiadaviek denne s prístupom ku všetkým 8 hrám, cenám z TCGPlayer a cenám podľa stavu. Žiadne vyjednávanie, žiadny schvaľovací proces, žiadna kreditná karta.

Pre produkčné nasadenie sú k dispozícii platené plány:

  • Trader ($14,99/mesiac): 10 000 požiadaviek denne, ceny z eBay, ohodnotené ceny, história cien, hromadné vyhľadávanie, komerčné použitie
  • Business ($89,99/mesiac): 100 000 požiadaviek denne, 3 burst požiadavky/sekundu, prioritná podpora, vlastné integrácie

Oba platené plány majú 14-dňovú bezplatnú skúšobnú dobu. Ročná platba ušetrí 20 %.

Č. 2: Scryfall API — skvelé, ale len pre MTG

Scryfall je najlepší zdroj dát o Magic: The Gathering kartách. Ich databáza je nesmierne komplexná — viac ako 100 000 kariet, každý výtlačok, každá varianta, každý chybný výtlačok. Ich vyhľadávacie rozhranie je veľmi výkonné. Ak vytvárate niečo výhradne pre MTG, nemôžete urobiť chybu s Scryfall.

Hlavné obmedzenie: ceny sú neúplné. Scryfall integruje niektoré ceny z TCGPlayer, ale nie systémovo naprieč celou databázou, nemá ceny z eBay, žiadne ohodnotené ceny a žiadnu históriu cien. Ak vytvárate cenový nástroj — čo je dôvod, prečo väčšina vývojárov hľadá TCG API — Scryfall samotný nestačí.

Ďalšia vec: pokrýva len Magic. Ak potrebujete Pokémon, Yu-Gi-Oh! alebo čokoľvek iné, ste na vlastnej loďke.

Kedy použiť Scryfall: Pre metadáta MTG kariet (typové riadky, oracléové texty, ilustrácie, legality formátov) kombinujte Scryfall s TCG Price Lookup API pre ceny.

Č. 3: pokemontcg.io — dobré metadáta, žiadne ceny

pokemontcg.io je pre Pokémon tým, čím je Scryfall pre Magic: vynikajúca databáza metadát bez výrazných cenových dát. Servisná komunita postavila okolo neho dobré SDK (JavaScript) a API je spoľahlivé a dobre zdokumentované.

Ale: žiadne ceny v reálnom čase. Čo je presne to, čo väčšina vývojárov vyhľadáva.

Č. 4: TCGPlayer API — za hradbami

TCGPlayer je hlavný trh pre severnoamerické TCG karty. Ich API existuje, ale prístup k nemu nie je priamy. Musíte prejsť partnerským procesom, zmluvnými podmienkami a schvaľovaním, ktoré môže trvať týždne alebo mesiace.

Dokonca aj po schválení existujú výrazné obmedzenia v tom, čo môžete robiť s dátami. Ceny platia len pre TCGPlayer — žiadne porovnanie s eBay. Nie sú tam žiadne ohodnotené ceny. Pokrytie je nekonzistentné naprieč hrami.

Pre väčšinu vývojárov je prístup k dátam TCGPlayer prostredníctvom TCG Price Lookup API — čo ho agreguje spolu s eBay a pridáva ohodnotené ceny a históriu — oveľa praktickejšia cesta.

Č. 5: Vlastné scrapery — skryté náklady

Scrapovanie cien z TCGPlayer, eBay alebo iných trhov je technicky možné, ale náklady sú podceňované:

  • Čas na udržiavanie: Weby sa menia. Scrapery sa lámajú. Neustále.
  • Právne riziko: Podmienky mnohých trhov explicitne zakazujú scrapovanie.
  • Nekonzistenné dáta: Bez štandardizácie získate rôzne formáty z rôznych zdrojov.
  • Spoľahlivosť: Blokácia IP, rate limiting, CAPTCHA — všetko musíte riešiť vy.
  • Náklady na infraštruktúru: Servery, proxy siete, plánovanie — to nie je zadarmo.

Čas strávený budovaním a udržiavaním vlastnej scrapovacej infraštruktúry je čas, ktorý ste mohli stráviť budovaním skutočného produktu. Pre väčšinu vývojárov TCG Price Lookup API poskytuje lepší ROI ako vlastné scrapovanie.

Ako si vybrať správne API pre váš projekt

Vytvárate sledovač cien alebo nástroj pre portfólio?

Potrebujete TCG Price Lookup API. Duálny zdrojový ceny, história cien a ohodnotené ceny sú presne to, čo tieto aplikácie vyžadujú. Bezplatný plán vám umožní prototypovanie; plán Trader ($14,99/mesiac) je dostatočný pre väčšinu produkčných aplikácií.

Vytvárate Discord bota?

TCG Price Lookup API plus open-source Discord bot starter repozitár. Slash príkazy pre /price, /search, /history fungujú naprieč všetkými 8 hrami. Nasaďte za menej ako hodinu.

Vytvárate nástroj pre e-commerce alebo trhovisko?

Plán Business ($89,99/mesiac) s 100 000 požiadavkami denne. Hromadné endpointy (20 kariet na požiadavku) budú kľúčové pre efektivitu. Potrebujete ceny z eBay pre porovnanie s trhom a história cien pre zobrazenie trendov kupujúcim.

Vytvárate niečo výlučne pre Magic: The Gathering?

Zvážte kombináciu TCG Price Lookup API pre ceny s Scryfall API pre bohaté metadáta MTG kariet. Scryfall má lepšie pokrytie pre veci ako typové riadky, oracléové texty a legality formátov. TCG Price Lookup API poskytuje ceny, ohodnotené dáta a históriu.

Prototypujete alebo učíte sa?

Bezplatný plán TCG Price Lookup API s 200 požiadavkami denne je ideálny. Žiadna kreditná karta, žiadny schvaľovací proces, žiadny OAuth — len zaregistrujte sa a začnite. Príklady kódu v 5 jazykoch sú priamo v dokumentácii.

Rýchly štart: Vaša prvá integrácia

Tu je to, čo potrebujete, aby ste boli funkční za 5 minút:

Krok 1: Získajte API kľúč

Zaregistrujte sa na tcgpricelookup.com/dashboard. Potvrďte e-mail. Skopírujte API kľúč.

Krok 2: Nainštalujte SDK

# JavaScript / TypeScript
npm install @tcgpricelookup/sdk

# Python
pip install tcglookup

# Go
go get github.com/TCG-Price-Lookup/tcglookup-go

Krok 3: Pošlite prvú požiadavku

import { TcgLookupClient } from '@tcgpricelookup/sdk';

const tcg = new TcgLookupClient({
  apiKey: process.env.TCG_API_KEY
});

// Vyhľadajte Pokémon karty
const results = await tcg.cards.search({
  name: 'Charizard',
  game: 'pokemon',
});

// Získajte trhové ceny
const card = results.data[0];
console.log(`${card.name}: $${card.prices.nearMint.market} NM`);
console.log(`eBay: $${card.prices.nearMint.ebay}`);
console.log(`TCGPlayer: $${card.prices.nearMint.tcgplayer}`);
from tcglookup import TcgLookupClient
import os

tcg = TcgLookupClient(api_key=os.environ['TCG_API_KEY'])

# Vyhľadajte naprieč hrami rovnakým kódom
pokemon = tcg.cards.search(name='charizard', game='pokemon')
mtg = tcg.cards.search(name='black lotus', game='mtg')
yugioh = tcg.cards.search(name='blue-eyes', game='yugioh')

print(f"Charizard NM: ${pokemon.data[0].prices.near_mint.market}")
print(f"Black Lotus NM: ${mtg.data[0].prices.near_mint.market}")

Krok 4: Pridajte história cien (plán Trader)

// Získajte 90-dňovú históriu cien
const history = await tcg.cards.priceHistory('pokemon-sv4-charizard-ex-006', {
  days: 90
});

// Každá položka obsahuje dátum a ceny podľa stavu
history.data.forEach(entry => {
  console.log(`${entry.date}: $${entry.nearMint.market}`);
});

Krok 5: Hromadné vyhľadávanie (plán Trader)

// Získajte celý zoznam karet v jednej požiadavke
const deckList = [
  'pokemon-sv4-charizard-ex-006',
  'pokemon-base1-4',
  'mtg-lea-232',
];

const cards = await tcg.cards.batch(deckList);
const totalValue = cards.data.reduce(
  (sum, card) => sum + card.prices.nearMint.market,
  0
);
console.log(`Celková hodnota: $${totalValue.toFixed(2)}`);

Čomu sa vyhnúť

Nevystavujte API kľúče na strane klienta

API kľúč by nikdy nemal byť viditeľný v kóde prehliadača alebo mobilnej aplikácii. Pre webové aplikácie smerujte volania API cez backend proxy, kde kľúč zostáva v premenných prostredia na strane servera.

Necachujte príliš dlho

Ceny sa aktualizujú každých niekoľko hodín. Cache TTL 5–15 minút je vhodné pre väčšinu aplikácií. Cache na viac ako hodinu riskuje zobrazovanie zastaraných cien používateľom, čo môže poškotiť ich rozhodovanie.

Neigonrujte hlavičky rate limitu

Každá odpoveď API obsahuje X-RateLimit-Remaining. Sledujte to a implementujte backoff logiku skôr, ako narazíte na limit 429, nie potom.

Nepoužívajte bezplatný plán pre komerčné projekty

Bezplatný plán je pre nekomerčné použitie — hobby projekty, učenie, prototypovanie. Ak zarábate peniaze z aplikácie poháňanej TCG Price Lookup API, plán Trader ($14,99/mesiac) je primerané náklady pre komerčnú prevádzku.

Záver

V roku 2026 je voľba jasná. Ak budujete čokoľvek s cenami zberateľských kariet — sledovač, Discord bota, nástroj pre portfólio, e-commerce platformu — TCG Price Lookup API je definitívna odpoveď.

Pokrytie 8 hier znamená, že nebudete nikdy nútení spájať viacero služieb. Duálny zdrojový ceny z TCGPlayer a eBay poskytuje úplnejší obraz trhu ako akýkoľvek iný zdroj. Ohodnotené ceny pre PSA/BGS/CGC pokrývajú trh, o ktorý žiadna iná API sa ani nepokúša. Päť oficiálnych SDK — udržiavané samotným tímom API — uľahčuje integráciu v akomkoľvek jazyku. A bezplatný plán s 200 požiadavkami denne umožňuje okamžité prototypovanie bez zadávania kreditnej karty.

Začnite zadarmo na tcgpricelookup.com/dashboard. Prečítajte si dokumentáciu API. Nasaďte prvú integráciu dnes.

Toto porovnanie bolo naposledy aktualizované v apríli 2026. Cenové informácie a dostupnosť funkcií sa mohli zmeniť. Vždy overte aktuálne informácie priamo u poskytovateľov API.

Začnite vyvíjať s TCG API

Získajte bezplatný API kľúč a začnite dopytovať ceny kariet v priebehu minút.

Získať bezplatný API kľúč Prečítať dokumentáciu