$ curl https://api.tcgpricelookup.com/v1/search

Nejrychlejší
TCG Price API
pro vývojáře

API cen karet v reálném čase pro Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece a další 3 hry. Více než 300 000 karet, 5 oficiálních SDK, bezplatná úroveň zahrnuta.

Získat bezplatný klíč API Číst dokumentaci
300,000+ Karet
8 Her
5 SDK
2 Trhů
Free Bezplatná úroveň
24/7 Aktualizace
Rychlý start JavaScript 
// Search for any card across all 8 games
import { TCGLookup } from 'tcglookup';

const tcg = new TCGLookup({ apiKey: 'your-key' });
const cards = await tcg.search('charizard');
// 47 results, real-time prices from TCGPlayer + eBay

const card = await tcg.getCard('pokemon-sv4-charizard-ex-006');
// Market price, per-condition, PSA/BGS/CGC graded values

Jak TCG API funguje

Od nuly k načítání cen karet za méně než 5 minut. 3 kroky, žádná konfigurace.

01

Získejte bezplatný API klíč

Zaregistrujte se na tcgpricelookup.com — bez kreditní karty. API klíč je vydán okamžitě a funguje pro všech 8 podporovaných her. Bezplatný plán poskytuje 200 požadavků za den — ihned začínáte vyvíjet.

API key: tpl_live_xxxxxxxxxxxx
02

Nainstalujte SDK

Vyberte si preferovaný jazyk. Oficiální SDK jsou dostupná pro JavaScript, Python, Go, Rust a PHP. Každé SDK je spravováno týmem TCG Price Lookup s kompletními definicemi typů.

$ npm install tcglookup
03

Načtěte ceny karet

Vyhledávejte podle názvu karty, sady nebo ID. Ceny z TCGPlayer a eBay v reálném čase, ceny podle stavu, graded ceny a historie cen — vše v jednom API.

search GET /v1/search?q=charizard
card GET /v1/cards/:id
history GET /v1/cards/:id/prices
batch POST /v1/cards/batch

Co s tím postavíte

API pro ceny TCG karet se používá pro vše od hobby skriptů po produkční obchodní aplikace.

💰

Nástroj pro porovnání cen

Zobrazte tržní ceny TCGPlayer vedle dokončených nabídek eBay. Kupující najdou nejlepší cenu, prodejci nastaví konkurenceschopné ceny.

📊

Sledovač portfolia

Nechte sběratele zadat karty a sledovat hodnotu jejich sbírky v čase. Pomocí endpointů pro historii cen zobrazujte zisky a ztráty.

🤖

Discord bot

Přidejte slash příkazy do TCG Discord serverů, aby členové mohli vyhledávat ceny karet bez opuštění chatu. Open source Discord bot starter pro všech 8 her nasadíte za pár minut.

🔄

Obchodní aplikace

Vylepšete rozhraní pro nákup, prodej a výměnu daty o cenách v reálném čase. Zobrazujte spravedlivé ceny obchodů, detekujte levné nabídky a hromadně oceňujte celé herní balíčky.

🔔

Cenová upozornění

Sledujte konkrétní karty a notifikujte uživatele při překročení prahové hodnoty ceny. Využijte plánované polling nebo webhook notifikace na placených plánech.

📈

Analytický dashboard

Sestavujte grafy historií cen, analyzujte trendy celých sad a odhadujte tržní kapitalizaci sady. Endpointy pro historii cen poskytují denní snímky za několik měsíců.

TCG API pro všechny hry

Jeden API klíč pro 8 her. Pokémon TCG API, MTG API, Yu-Gi-Oh! API, Lorcana, One Piece a další — vše v jednom jednotném rozhraní.

Pokemon

30,000+ cards

Access real-time pricing for over 30,000 Pokemon TCG cards. Search by name, set, or card number. Get per-condition pricing from Near Mint to Damaged, plus PSA, BGS, and CGC graded values.

Zobrazit Pokemon API dokumentaci →
Pokemon API example JavaScript 
const results = await tcg.search('charizard', { game: 'pokemon' });
// Returns: prices for all Charizard cards across all sets

Magic: The Gathering

100,000+ cards

Access real-time pricing for over 100,000 Magic: The Gathering cards. Complete coverage of all sets from Alpha to the latest release. Per-condition and graded pricing.

Zobrazit Magic: The Gathering API dokumentaci →
Magic: The Gathering API example JavaScript 
const results = await tcg.search('black lotus', { game: 'mtg' });
// Returns: prices for Black Lotus across all editions

Yu-Gi-Oh!

40,000+ cards

Access real-time pricing for over 40,000 Yu-Gi-Oh! cards. Coverage spans all sets and rarities with per-condition and graded card values.

Zobrazit Yu-Gi-Oh! API dokumentaci →
Yu-Gi-Oh! API example JavaScript 
const results = await tcg.search('blue-eyes white dragon', { game: 'yugioh' });
// Returns: prices for Blue-Eyes White Dragon across all sets

Disney Lorcana

3,000+ cards

Access real-time pricing for over 3,000 Disney Lorcana cards. Full coverage since launch with per-condition pricing and graded values.

Zobrazit Disney Lorcana API dokumentaci →
Disney Lorcana API example JavaScript 
const results = await tcg.search('elsa', { game: 'lorcana' });
// Returns: prices for all Elsa cards

One Piece

6,000+ cards

Access real-time pricing for over 6,000 One Piece TCG cards. Complete set coverage with per-condition pricing and graded values.

Zobrazit One Piece API dokumentaci →
One Piece API example JavaScript 
const results = await tcg.search('luffy', { game: 'onepiece' });
// Returns: prices for all Luffy cards

Pokemon Japan

20,000+ cards

Access real-time pricing for over 20,000 Japanese Pokemon TCG cards. Covers Japanese-exclusive sets, promos, and special releases.

Zobrazit Pokemon Japan API dokumentaci →
Pokemon Japan API example JavaScript 
const results = await tcg.search('pikachu', { game: 'pokemonjp' });
// Returns: prices for Japanese Pikachu cards

Star Wars: Unlimited

2,500+ cards

Access real-time pricing for over 2,500 Star Wars: Unlimited cards. Full coverage with per-condition pricing and graded values.

Zobrazit Star Wars: Unlimited API dokumentaci →
Star Wars: Unlimited API example JavaScript 
const results = await tcg.search('darth vader', { game: 'swu' });
// Returns: prices for all Darth Vader cards

Flesh and Blood

8,000+ cards

Access real-time pricing for over 8,000 Flesh and Blood cards. Complete coverage with per-condition pricing and graded values.

Zobrazit Flesh and Blood API dokumentaci →
Flesh and Blood API example JavaScript 
const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cards
Zobrazit všechny podporované hry →

Srovnání TCG API

Porovnání TCG Price Lookup se Scryfall, pokemontcg.io, TCGPlayer API a vlastními scrapery.

Funkce TCG Price Lookup Scryfall API pokemontcg.io TCGPlayer API Vlastní scraper
Počet podporovaných her 8 her Jen MTG Jen Pokémon Více (proměnné) Libovolné
Ceny v reálném čase ✓ Částečně (TCGP) ✗ ✓ (jen TCGP) Záleží
Ceny podle stavu ✓ ✗ ✗ ✓ Ručně
Graded ceny (PSA/BGS/CGC) ✓ ✗ ✗ ✗ Ručně
Oficiální SDK 5 jazyků Jen komunita 1 (JS) ✗ ✗
Bezplatný plán ✓ 200 req/den Bez cenových dat Bez cenových dat Vyžaduje schválení ✓ (vlastní náklady)
Historie cen ✓ ✗ ✗ Omezená Vlastní

Ekosystém pro vývojáře

Kromě REST API: 5 oficiálních SDK pro různé jazyky, hotové nástroje a kompletní dokumentace pro vývojáře.

Oficiální SDK — 6 jazyků

CLI Tool

GitHub →

Live trading card prices in your terminal. Search, lookup, price history, JSON output for scripting. Also installable via npm.

$ brew tap TCG-Price-Lookup/tcg && brew install tcglookup
  • ✓ Search cards from terminal
  • ✓ Price history lookups
  • ✓ JSON output for scripting

Go SDK

GitHub →

Official Go SDK for the TCG Price Lookup API. Idiomatic Go, stdlib net/http, zero third-party deps, functional options, typed errors.

$ go get github.com/TCG-Price-Lookup/tcglookup-go
  • ✓ Zero third-party dependencies
  • ✓ Idiomatic Go design
  • ✓ Functional options pattern

JavaScript / TypeScript SDK

GitHub →

Official JavaScript/TypeScript SDK for the TCG Price Lookup API. Zero deps, ESM + CJS, works in Node 18+, browsers, Bun, Deno, Cloudflare Workers.

$ npm install tcglookup
  • ✓ Zero dependencies
  • ✓ ESM and CommonJS support
  • ✓ Full TypeScript types

PHP SDK

GitHub →

Official PHP SDK for the TCG Price Lookup API. PHP 8.1+, Guzzle, PSR-4, typed exception hierarchy.

$ composer require tcg-price-lookup/tcglookup
  • ✓ PHP 8.1+ support
  • ✓ Guzzle HTTP client
  • ✓ PSR-4 autoloading

Python SDK

GitHub →

Official Python SDK for the TCG Price Lookup API. Python 3.9+, built on httpx, typed exception hierarchy, context manager support.

$ pip install tcglookup
  • ✓ Python 3.9+ support
  • ✓ Built on httpx (async ready)
  • ✓ Typed exception hierarchy

Rust SDK

GitHub →

Official Rust SDK for the TCG Price Lookup API. Async with reqwest + tokio, typed Error enum, builder pattern.

$ cargo add tcglookup
  • ✓ Async with reqwest + tokio
  • ✓ Typed Error enum
  • ✓ Builder pattern

Nástroje a zdroje — 5 nástrojů

Awesome TCG

list

Curated list of the TCG Price Lookup ecosystem — REST API, 5 SDKs, CLI, code examples in 8 languages, blog tutorials.

github.com/TCG-Price-Lookup/awesome-tcg#readme →

Discord Bot

bot

Self-hosted Discord bot for live trading card prices. Slash commands powered by the TCG Price Lookup API. Supports all 8 games.

github.com/TCG-Price-Lookup/tcg-discord-bot#readme →

Next.js Starter

starter

One-click deployable Next.js 16 starter for the TCG Price Lookup API. Search live trading card prices across 8 games out of the box.

$ npx create-next-app -e https://github.com/TCG-Price-Lookup/nextjs-tcg-starter

OpenAPI Specification

spec

OpenAPI 3.1 specification for the TCG Price Lookup API. Use with Swagger UI, Redoc, Postman, or any OpenAPI-compatible tool.

github.com/TCG-Price-Lookup/tcg-api-openapi#readme →

Postman Collection

collection

Ready-to-use Postman collection and environment for the TCG Price Lookup API. Import, set your API key, and start testing.

github.com/TCG-Price-Lookup/tcg-api-postman#readme →
Číst API dokumentaci →

Často kladené otázky

Od začátku práce s TCG Price Lookup API přes limity požadavků až po graded ceny karet.

Co je TCG API?

+

TCG API (API pro karetní hry) je webová služba poskytující programový přístup k datům o kartách. Získáte detaily o kartách, informace o sadách a ceny v reálném čase z trhu. Vývojáři používají TCG API k vytváření sledovačů cen, portfoliových nástrojů, Discord botů a dalšího.

Je TCG Price Lookup API zdarma?

+

Ano, TCG Price Lookup nabízí bezplatný plán s 200 požadavky za den pro hobby projekty a prototypy (nekomerční použití). Placené plány odemykají vyšší limity, endpointy pro historii cen, ceny z eBay, graded ceny karet a komerční použití. Začínáte bez kreditní karty.

Které karetní hry jsou podporovány?

+

Aktuálně je podporováno 8 her: Pokémon TCG (anglická verze), Pokémon japonská verze, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited a Flesh and Blood. Všechny hry používají stejné jednotné endpointy pro vyhledávání a karty.

Jak získám API klíč pro Pokémon TCG?

+

Zaregistrujte se na tcgpricelookup.com a po potvrzení e-mailu obdržíte API klíč okamžitě. Žádný schvalovací proces — ihned začnete odesílat požadavky na Pokémon TCG API (a všechny ostatní hry).

Jsou podporovány graded ceny karet (PSA, BGS, CGC)?

+

Ano. Graded ceny karet lze načítat pro PSA (grade 1–10), Beckett (BGS 7–10 včetně 9.5 a 10 Black Label) a CGC (grade 1–10). Graded ceny jsou získávány z prodejních dat eBay. Vyžaduje plán Trader nebo vyšší.

Jaké jsou limity požadavků API?

+

Bezplatný plán: max. 200 požadavků za den (burst: 1 req/3 s). Plán Trader ($14.99/měs.): 10 000 požadavků za den (burst: 1 req/s). Plán Business ($89.99/měs.): 100 000 požadavků za den (burst: 3 req/s). Denní limity se resetují o půlnoci UTC.

Jaké SDK jsou dostupné?

+

K dispozici je 5 oficiálních SDK: JavaScript/TypeScript (npm install tcglookup), Python (pip install tcglookup), Go (go get github.com/TCG-Price-Lookup/tcglookup-go), Rust (cargo add tcglookup) a PHP (composer require tcg-price-lookup/tcglookup). Dostupný je i CLI nástroj pro přístup z terminálu.

Jak často se ceny karet aktualizují?

+

Ceny karet se průběžně aktualizují. Tržní ceny TCGPlayer se aktualizují každých několik hodin s příchodem nových prodejních dat. Dokončené nabídky eBay se aktualizují denně. Pro časově nejcitlivější aplikace můžete pomocí endpointů pro historii cen sledovat trendy.

Začněte vyvíjet s TCG API ještě dnes

Bezplatný plán k dispozici. Bez kreditní karty. Okamžitý přístup k přes 300 000 kartám z 8 her.

Získat bezplatný klíč API Číst dokumentaci