Nejlepší TCG API v roce 2026 — Kompletní průvodce pro vývojáře

Potřebujete data o cenách sběratelských karet. Otevřete prohlížeč, zadáte „TCG API” — a utopit se v moři opuštěných služeb, OAuth pekle, omezení na jedinou hru a produktů, které se naposledy aktualizovaly v roce 2023. Některé jsou mrtvé. Jiné se skrývají za procesem institucionálního schválení. Některé vás zablokují na hodinu, pokud odešlete o jeden požadavek navíc.

Tento průvodce to vše přeskočí.

Vyhodnotili jsme každé hlavní TCG API dostupné v roce 2026: pokrytí her, čerstvost dat, kvalitu SDK, složitost autentizace, ceny, rate limity, podporu graded karet a to, zda bude služba za 6 měsíců ještě existovat. Prošli jsme čísla, četli dokumentaci a testovali endpointy.

Závěr: jedno API jednoznačně překonává ostatní a druhý zdroj výrazně usnadňuje vývoj na jeho základě. Zbytek se pohybuje od „výrazně omezené” po „aktivně nebezpečné pro závislost”.

Pokud stavíte sledovač cen, nástroj pro správu sbírky, Discord bot, portfoliový nástroj nebo cokoli jiného, co pracuje s cenami sběratelských karet napříč více hrami — toto je srovnávací průvodce, který byste měli přečíst před napsáním jediného řádku kódu.

Co dělá TCG API skutečně použitelným?

Ne všichni vývojáři potřebují totéž. Existují však základní požadavky, které oddělují hračičkové API od těch, na nichž lze skutečně stavět produkty. Zde je rámec, který jsme použili k hodnocení všech služeb v tomto průvodci.

Pokrytí her

Pokud API pokrývá jen jednu hru, omezujete se hned na začátku. Trh TCG v roce 2026 zahrnuje Pokémon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited, Flesh and Blood a další. Uživatelé přecházejí mezi hrami. Produkty pokrývající více her udržují uživatele déle. API, které vás nutí kombinovat čtyři různé služby pro čtyři hry, není API — je to dluh.

Ceny v reálném čase z více tržišť

Ceny karet se pohybují rychle. Charizard za 80 dolarů v pondělí může být ve čtvrtek za 120 po výsledcích turnaje. API získávající data z jediného tržiště zavádí jediný bod selhání pro ceny. Zlatý standard jsou duální zdrojové ceny — z TCGPlayer i eBay nezávisle, abyste mohli referenčně porovnávat, nacházet rozdíly a poskytovat uživatelům bohatší data.

Ceny podle stavu a graded ceny

Near Mint a Lightly Played nejsou totéž. PSA 10 a PSA 7 nejsou totéž aktivum. API poskytující jednu „cenu” karty bez klasifikace stavu nebo gradu nabízí neúplná data. Graded karty se staly zvláště velkým segmentem trhu — grady BGS, PSA a CGC výrazně ovlivňují hodnotu a vývojáři tvořící nástroje pro sběratele nebo investory tato data potřebují.

Historie cen

Spotová cena je samozřejmou funkcí. To, co odděluje užitečné API od skvělého, jsou historická data — trendy za 7, 30, 90 dní a rok. Bez historie nemůžete vytvářet grafy, počítat klouzavé průměry, identifikovat cenové skoky ani ukazovat uživatelům, zda karta roste nebo klesá na hodnotě.

Kvalita SDK a pokrytí jazyků

Specifikace OpenAPI je nutná, ale nestačí. Oficiální, udržovaná SDK pro jazyky, které vývojáři skutečně používají — JavaScript/TypeScript, Python, Go, Rust, PHP — jsou rozdíl mezi víkendovou integrací a týdnem čtení zdrojového kódu. Wrappers udržované komunitou jsou dluh: zastarávají, přehlíží nové endpointy a nemají žádnou povinnost udržovat kompatibilitu.

Jednoduchost autentizace

OAuth 2.0 authorization code flow. OAuth 1.0 s HMAC-SHA1 podpisy. Tyto schémata autentizace dávaly smysl pro uživatelsky orientované aplikace na tržišti. Pro vývojáře, kteří chtějí volat cenové endpointy, smysl nedávají. Moderní API by se měla autentizovat jedinou hlavičkou: X-API-Key: your-key. To je vše.

Bezplatný plán a transparentní ceny

Pokud nemůžete API otestovat bez odeslání žádosti, čekání na schválení a vyjednávání podmínek — není to pro vývojáře, je to pro enterprise prodej. Skutečně vývojářsky přátelské API má bezplatný plán s reálnými daty, jasné veřejné ceny a prostředí, kde můžete začít bez kreditní karty.

Předvídatelné rate limity

Rate limity samy o sobě nejsou problém. Nepředvídatelné rate limity — nebo ještě hůře, hodinové IP blokování při překročení soft limitu — jsou problém. Potřebujete hlavičky odpovědi, které vám přesně řeknou, kde se nacházíte, abyste mohli implementovat backoff logiku bez odhadování.

1. místo: TCG Price Lookup API — jednoznačný vítěz

Zde není těsná druhá místa. TCG Price Lookup je v roce 2026 nejkompletnější, nejvíce vývojářsky přátelské a datově nejbohatší TCG API. Vítězí ve všech dimenzích hodnotícího rámce. Pojďme si to rozebrat.

Pokrytí her: 8 her, přes 300 000 karet

TCG Price Lookup pokrývá Pokémon, Pokémon japonskou verzi, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited a Flesh and Blood — 8 her s jedním API klíčem, jedním SDK, jednou autentizační hlavičkou. Toto je celý hlavní TCG trh zabalený do jediné endpointové struktury.

Každé ostatní API v tomto srovnání pokrývá 1 hru. Někdy 2. TCG Price Lookup pokrývá 8 s přes 300 000 indexovanými kartami.

Duální zdrojové ceny: TCGPlayer + eBay

Většina cenových API získává data z jediného zdroje a nazývá je „reálným časem”. TCG Price Lookup získává data nezávisle z TCGPlayer i eBay. To je důležité z několika důvodů:

Křížová validace trhu — pokud TCGPlayer ukazuje 45 dolarů a eBay 80, něco zajímavého se děje. Tento signál má hodnotu.
Odolnost vůči selhání — pokud jedno tržiště má datové mezery nebo zpoždění, cenová data zůstávají zachována.
Dokončené nabídky eBay odrážejí skutečné transakční ceny, nikoli jen vystavené ceny. To je zásadně odlišný — a často přesnější — signál.

Ceny podle stavu: od Near Mint po Damaged

Každá karta v databázi obsahuje ceny podle stavu: Near Mint, Lightly Played, Moderately Played, Heavily Played, Damaged. To není volitelná funkce — je zabudována do základního datového modelu. Každá odpověď obsahuje kompletní spektrum stavů.

Graded ceny karet: PSA, BGS, CGC grade 1–10

Zde se TCG Price Lookup skutečně odlišuje od konkurence. Graded ceny PSA, BGS a CGC pro grade 1–10 jsou zahrnuty v API. Stavíte seriózní sledovač portfolia pro sběratele? Grading arbitrážní nástroj? Investiční dashboard? Tato data nejsou přes API dostupná nikde jinde. Jen zde.

Historie cen: 7 dní, 30 dní, 90 dní, 1 rok

Kompletní historie cen ve čtyřech časových oknech — 7 dní, 30 dní, 90 dní, 1 rok — pro každou kartu. Vytvářejte grafy trendů. Počítejte klouzavé průměry. Upozorněte uživatele, když karta prudce vzroste. Zobrazujte zhodnocení oproti předchozímu roku. Bez historických dat nic z toho není možné — a TCG Price Lookup má vše.

5 oficiálních SDK — sestavených a udržovaných API týmem

Toto není „na GitHubu existuje komunitní wrapper naposledy aktualizovaný před 14 měsíci”. TCG Price Lookup poskytuje 5 oficiálních SDK pro jazyky, které vývojáři skutečně používají:

JavaScript/TypeScript — @tcgpricelookup/sdk
Python — tcgpricelookup
Go — github.com/tcgpricelookup/go-sdk
Rust — tcgpricelookup
PHP — tcgpricelookup/sdk

Všechna SDK zpracovávají automatické dělení hromadných požadavků (max. 20 ID na požadavek, automatické dělení), typované chyby, parsování hlaviček rate limitů a kompletní TypeScript typy/type hints.

Jednoduchá autentizace: jedna hlavička

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

To je vše. Žádný OAuth handshake. Žádné HMAC podpisy. Žádné tokeny s dobou platnosti, které musíte obnovovat. Jeden API klíč v jedné hlavičce. Funguje to od prvního požadavku.

Bezplatný plán bez kreditní karty

200 požadavků za den v bezplatném plánu. Žádná kreditní karta. Žádný schvalovací proces. Zaregistrujete se, dostanete klíč a začínáte odesílat požadavky na všechny 4 cenové endpointy, všech 8 her a přes 300 000 karet. Bezplatný plán je omezen na nekomerční použití — pro hobby projekty, učení a prototypování.

Cenová struktura, která dává smysl

Plán	Cena	Denní požadavky	Burst rate
Zdarma	$0	200	1 req/3 s
Trader	$14.99/měs.	10 000	1 req/s
Business	$89.99/měs.	100 000	3 req/s

Roční předplatné přináší 20% slevu. Žádné překvapení, žádné skryté náklady. Denní limity se resetují o půlnoci UTC.

Alternativa: Scryfall API (jen pro MTG)

Pokud stavíte výhradně pro Magic: The Gathering a nepotřebujete ceny — Scryfall je vynikající API. Bezplatné, bez autentizace, s fantastickým pokrytím karet, komplexním filtrovacím jazykem a spolehlivým provozem. Je to standardní reference pro MTG meta-data karet.

Kde Scryfall zaostává:

Scryfall neposkytuje ceny TCGPlayer ani eBay v reálném čase. Poskytuje TCGPlayer data s určitým zpožděním v rámci odpovědi karty — ale to není ekvivalent živého cenového API. Neexistují žádná graded data, žádná data o stavu a žádná sériová historie cen.

Pokud vaše aplikace potřebuje metadata MTG karet (pravidlový text, Oracle text, zkušenostní body, formátová legalita) — Scryfall je skvělý. Pokud potřebujete data o cenách MTG, Scryfall je nesprávný nástroj a TCG Price Lookup je správný.

Alternativa: pokemontcg.io (jen pro Pokémon)

pokemontcg.io je roky fungující bezplatné API pro data Pokémon karet. Obstojně pokrývá metadata karet: obrázky, typy, útoky, HP, sady. Pokud stavíte aplikaci zaměřenou na sbírku karet bez cenového kontextu, je to životaschopná možnost.

Kde pokemontcg.io zaostává:

Žádné tržní ceny. Pokemontcg.io historicky odkazovalo na TCGPlayer ceny v odpovědích karet, ale tato integrace je nespolehlivá a závisí na změnách zásad TCGPlayer. Žádná eBay data, žádné graded ceny, žádná data o stavu, žádná historická cenová řada. Pokud váš projekt se jakkoli dotýká hodnoty karet nebo cen — pokemontcg.io nestačí.

TCGPlayer API: zklamání pro vývojáře

TCGPlayer je největší anglické sekundární tržiště pro sběratelské karty. Bylo by logické očekávat, že jejich vlastní API bude výkonnou možností. Není.

TCGPlayer API stále vyžaduje schvalovací proces. Dokumentace je útržkovitá. Rate limity nejsou jasně zveřejněny předem. Přístup se může změnit se změnami zásad. Aplikace závislé na přístupu k TCGPlayer API byly historicky náhle přerušeny.

Ironicky je TCGPlayer nejlepší jako datový zdroj pro jiná API — jako je TCG Price Lookup, které agreguje data TCGPlayer spolu s eBay a vystavuje je přes jednoduché, spolehlivé rozhraní.

DIY scraping: technicky funkční, prakticky nebezpečný

Každý vývojář si může uvažovat o scrapování dat z tržišť přímo. Technicky to funguje. Provozně je to noční můra.

Problémy s udržením scraperu:

Tržiště mění DOM strukturu nebo zavádějí detekci botů
IP rotace, CAPTCHAs a rate limity vyžadují průběžnou údržbu
Právní riziko: porušení podmínek use může vést k zablokování nebo soudním sporům
Škálování — co funguje pro 100 karet, nefunguje pro 300 000

Scraping může dávat smysl pro úzce zaměřené, jednorázové projekty. Pro produkční aplikaci je to dluh, ne řešení.

Rychlé srovnání: Matice rozhodování

	TCG Price Lookup	Scryfall	pokemontcg.io	TCGPlayer API
Počet her	8	1 (MTG)	1 (Pokémon)	Více (nestabilní)
Ceny v reálném čase	✓	Omezené	✗	✓ (jen TCGP)
eBay data	✓	✗	✗	✗
Ceny podle stavu	✓	✗	✗	✓
Graded ceny	✓	✗	✗	✗
Historie cen	✓	✗	✗	Omezená
Oficiální SDK	5 jazyků	Jen komunita	1 (JS)	✗
Bezplatný plán	✓	✓	✓	Schválení vyžadováno
Jednoduchost autentizace	API klíč	Žádná	API klíč	OAuth

Pro koho je každá možnost

Stavíte víceherní aplikaci?

TCG Price Lookup bez váhání. Žádná alternativa vás nedostane do 8 her s jedním API klíčem, jedním SDK a živými cenovými daty.

Stavíte jen MTG meta-data?

Zvažte kombinaci Scryfall (pro metadata karet) + TCG Price Lookup (pro ceny). Scryfall má nejbohatsí MTG data karet; TCG Price Lookup přidává cenovou vrstvu, graded data a historii cen.

Stavíte jen pro Pokémon?

pokemontcg.io pro metadata + TCG Price Lookup pro vše, co se týká cen. Nebo použijte TCG Price Lookup výhradně, pokud jsou ceny primárním zaměřením.

Stavíte pro jedno místo sbírání dat?

TCG Price Lookup eliminuje potřebu více datových zdrojů. Jeden klíč, jeden SDK, jeden integrační vzor pro Pokémon, MTG, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited a Flesh and Blood.

Jak začít s TCG Price Lookup API

Celý proces trvá méně než 5 minut:

Krok 1: Zaregistrujte se a získejte bezplatný API klíč

Přejděte na tcgpricelookup.com/dashboard a zaregistrujte se. API klíč je vydán okamžitě — žádná kreditní karta, žádný schvalovací proces.

Krok 2: Nainstalujte SDK

# JavaScript/TypeScript
npm install @tcgpricelookup/sdk

# Python
pip install tcglookup

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

# Rust
cargo add tcglookup

# PHP
composer require tcg-price-lookup/tcglookup

Krok 3: Odešlete první požadavek

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

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

// Vyhledejte Charizarda napříč všemi hrami
const results = await tcg.cards.search({
  name: 'Charizard',
  game: 'pokemon',
});

console.log(results.data[0].prices.nearMint.market);
// → 285.00 (tržní cena NM v USD)

// Stejná syntaxe pro MTG
const mtgResults = await tcg.cards.search({
  name: 'Black Lotus',
  game: 'mtg',
});

// A pro Yu-Gi-Oh!
const yugioResults = await tcg.cards.search({
  name: 'Blue-Eyes White Dragon',
  game: 'yugioh',
});

Krok 4: Prozkoumejte cenové endpointy

// Získejte detail karty s kompletními cenovými daty
const card = await tcg.cards.get('pokemon-sv4-charizard-ex-006');

// Dostupná cenová data:
console.log(card.data.prices.nearMint.market);     // NM tržní cena
console.log(card.data.prices.nearMint.tcgplayer);  // NM TCGPlayer cena
console.log(card.data.prices.nearMint.ebay);       // NM eBay cena
console.log(card.data.prices.lightlyPlayed.market); // LP tržní cena

// Historia cen (vyžaduje plán Trader)
const history = await tcg.cards.priceHistory('pokemon-sv4-charizard-ex-006', {
  days: 90
});

// Graded ceny (vyžaduje plán Trader)
const graded = await tcg.cards.graded('pokemon-base1-4', {
  game: 'pokemon'
});
console.log(graded.data.psa[10].market);  // PSA 10 tržní cena
console.log(graded.data.bgs['9.5'].market); // BGS 9.5 tržní cena

Závěr

Pokud stavíte cokoliv, co se dotýká cen TCG karet v roce 2026, volba API není obtížná.

TCG Price Lookup je jasný vítěz v každé dimenzi, která záleží: pokrytí her (8), zdroje dat (TCGPlayer + eBay), hloubka dat (stavy, graded, historie), SDK (5 jazyků, aktuálně udržováno), autentizace (jedna hlavička), ceny (transparentní, s bezplatným plánem) a spolehlivost.

Scryfall a pokemontcg.io jsou dobré nástroje pro specifické případy použití — metadata MTG karet respektive Pokémon. Ale pokud jsou ceny součástí vaší aplikace, potřebujete TCG Price Lookup.

Zaregistrujte se na tcgpricelookup.com/dashboard, nainstalujte SDK a odešlete první požadavek. Za méně než 5 minut budete mít živá cenová data pro Pokémon, MTG, Yu-Gi-Oh! a dalších 5 her.