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

Najrýchlejší
TCG Price API
pre vývojárov

Rozhranie API pre ceny kariet v reálnom čase pre Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece a 3 ďalšie hry. Viac ako 300 000 kariet, 5 oficiálnych SDK, bezplatná úroveň zahrnutá.

300,000+ Kariet
8 Hier
5 SDK
2 Trhov
Free Bezplatná úroveň
24/7 Aktualizácie
Rýchly štart 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

Ako TCG API funguje

Od nuly k načítaniu cien kariet za menej ako 5 minút. 3 kroky, žiadna konfigurácia.

01

Získajte bezplatný API kľúč

Zaregistrujte sa na tcgpricelookup.com — bez kreditnej karty. API kľúč je vystavený okamžite a funguje pre všetkých 8 podporovaných hier. Bezplatný plán ponúka 200 požiadaviek denne, čo vám umožní hneď začať vyvíjať.

API key: tpl_live_xxxxxxxxxxxx
02

Nainštalujte SDK

Vyberte si preferovaný jazyk. Oficiálne SDK sú dostupné pre JavaScript, Python, Go, Rust a PHP. Každé SDK udržiava tím TCG Price Lookup s plnými typovými definíciami.

$ npm install tcglookup
03

Získajte ceny kariet

Vyhľadávajte podľa názvu karty, série alebo ID. Získajte aktuálne ceny z TCGPlayer aj eBay, ceny podľa stavu, ceny ohodnotených kariet a históriu cien — všetko cez jedno API.

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

Čo môžete vytvoriť

API pre ceny TCG kariet sa využíva na všetko od hobby skriptov až po produkčné obchodné aplikácie.

💰

Porovnávač cien

Zobrazujte trhové ceny z TCGPlayer vedľa predajov na eBay. Kupujúci nájdu najlepšie ceny, predajci nastavia konkurenčné ceny.

📊

Sledovač portfólia

Nechajte zberateľov zadávať karty a sledovať hodnotu ich zbierky v čase. Endpoint pre históriu cien umožňuje vytvárať grafy ziskov a strát.

🤖

Discord bot

Pridajte slash príkazy do TCG Discord serverov, aby členovia mohli vyhľadávať ceny kariet bez opustenia chatu. Open-source Discord bot starter pre všetky 4 hry nasadíte za minúty.

🔄

Obchodná aplikácia

Vylepšite rozhrania pre nákup, predaj a výmenu s dátami o cenách v reálnom čase. Zobrazujte spravodlivé obchodné hodnoty, detekujte podhodnotené ponuky a získavajte hromadné ceny pre celé zoznamy karet.

🔔

Cenové upozornenia

Sledujte konkrétne karty a upozorňujte používateľov, keď ceny prekročia prahové hodnoty. Použite plánované dotazovanie alebo webhooky dostupné v platených plánoch.

📈

Analytický dashboard

Vytvárajte grafy histórie cien, analýzy trendov celej série a odhady trhovej hodnoty. Endpoint pre históriu cien poskytuje denné snímky za každý mesiac.

TCG API pre všetky hry

Jeden API kľúč pre 8 hier. Pokémon TCG API, MTG API, Yu-Gi-Oh! API, Lorcana, One Piece a ďalšie — všetko cez jedno jednotné rozhranie.

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.

Zobraziť dokumentáciu Pokemon API →
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.

Zobraziť dokumentáciu Magic: The Gathering API →
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.

Zobraziť dokumentáciu Yu-Gi-Oh! API →
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.

Zobraziť dokumentáciu Disney Lorcana API →
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.

Zobraziť dokumentáciu One Piece API →
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.

Zobraziť dokumentáciu Pokemon Japan API →
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.

Zobraziť dokumentáciu Star Wars: Unlimited API →
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.

Zobraziť dokumentáciu Flesh and Blood API →
Flesh and Blood API example JavaScript
const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cards

Porovnanie TCG API

Porovnanie TCG Price Lookup so Scryfall, pokemontcg.io, TCGPlayer API a vlastnými scrapermi.

Funkcia TCG Price Lookup Scryfall API pokemontcg.io TCGPlayer API Vlastný scraper
Počet hier 8 hier Len MTG Len Pokémon Viaceré (variabilné) Ľubovoľné
Ceny v reálnom čase Čiastočne (TCGP) ✓ (len TCGP) Závisí
Ceny podľa stavu Manuálne
Ceny ohodnotených (PSA/BGS/CGC) Manuálne
Oficiálne SDK 5 jazykov Len komunitné 1 (JS)
Bezplatný plán ✓ 200 požiadaviek/deň Bez cenových dát Bez cenových dát Vyžaduje schválenie ✓ (vlastné náklady)
História cien Obmedzene Vlastné

Ekosystém pre vývojárov

Okrem REST API nájdete 5 oficiálnych SDK, nástroje pripravené na použitie a komplexnú dokumentáciu.

Oficiálne SDK — 6 jazykov

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ástrojov

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 →

Často kladené otázky

Od začatia práce s TCG Price Lookup API až po limity požiadaviek a ceny ohodnotených kariet.

Čo je TCG API?

+

TCG API (API pre zberateľské kartové hry) je webová služba, ktorá poskytuje programatický prístup k údajom o kartách. Môžete získať detaily o kartách, informácie o sériách, aktuálne trhové ceny a ďalšie údaje. Vývojári používajú TCG API na tvorbu sledovačov cien, nástrojov pre portfólio, Discord botov a podobne.

Je TCG Price Lookup API zadarmo?

+

Áno, TCG Price Lookup ponúka bezplatný plán s 200 požiadavkami denne pre hobby projekty a prototypy (nekomerčné použitie). Platené plány poskytujú vyššie limity, prístup k histórii cien, cenám z eBay, cenám ohodnotených kariet a komerčné využitie. Nie je potrebná kreditná karta.

Ktoré kartové hry sú podporované?

+

Momentálne je podporovaných 8 hier: Pokémon TCG (anglická verzia), Pokémon japonská verzia, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited a Flesh and Blood. Všetky hry používajú rovnaké jednotné endpointy pre vyhľadávanie.

Ako získam API kľúč pre Pokémon TCG?

+

Zaregistrujte sa na tcgpricelookup.com a po overení e-mailovej adresy dostanete API kľúč okamžite. Bez schvaľovacieho procesu môžete ihneď začať posielať požiadavky na Pokémon TCG API (aj na všetky ostatné hry).

Sú podporované ceny ohodnotených kariet (PSA, BGS, CGC)?

+

Áno. Môžete získať ceny ohodnotených kariet pre PSA (stupne 1–10), Beckett (BGS 7–10 vrátane 9.5 a 10 Black Label) a CGC (stupne 1–10). Ceny ohodnotených kariet pochádzajú z predajných dát eBay. Vyžaduje sa plán Trader alebo vyšší.

Aké sú limity pre API požiadavky?

+

Bezplatný plán: max. 200 požiadaviek denne (burst: 1 požiadavka/3 sekundy). Plán Trader ($14,99/mesiac): 10 000 požiadaviek denne (burst: 1 požiadavka/sekundu). Plán Business ($89,99/mesiac): 100 000 požiadaviek denne (burst: 3 požiadavky/sekundu). Denné limity sa resetujú o polnoci UTC.

Aké SDK sú k dispozícii?

+

K dispozícii je 5 oficiálnych 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). K dispozícii je aj CLI nástroj pre prístup z terminálu.

Ako často sa aktualizujú ceny kariet?

+

Ceny kariet sa aktualizujú priebežne. Trhové ceny z TCGPlayer sa aktualizujú každých niekoľko hodín so vzniknutými novými predajnými dátami. Predaje z eBay sa aktualizujú denne. Pre najcitlivejšie aplikácie môžete sledovať trendy pomocou endpointu pre históriu cien.

Začnite vyvíjať s TCG API dnes

Bezplatný plán k dispozícii. Bez kreditnej karty. Okamžitý prístup k viac ako 300 000 kartám v 8 hrách.