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

Najszybsze
API cen TCG
dla deweloperów

API cen kart w czasie rzeczywistym dla Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece i 3 kolejnych gier. Ponad 300 000 kart, 5 oficjalnych SDK, bezpłatny plan w zestawie.

300,000+ Kart
8 Gier
5 SDK
2 Rynków
Free Bezpłatny plan
24/7 Aktualizacje
Szybki 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 działa TCG API

Od zera do pobierania cen kart w mniej niż 5 minut. 3 kroki, zero konfiguracji.

01

Pobierz darmowy klucz API

Zarejestruj się na tcgpricelookup.com — bez karty kredytowej. Klucz API zostaje wystawiony natychmiast i działa we wszystkich 8 obsługiwanych grach. Plan darmowy to 200 zapytań dziennie — wystarczy, żeby zacząć budować.

API key: tpl_live_xxxxxxxxxxxx
02

Zainstaluj SDK

Wybierz swój język. Oficjalne SDK dostępne są dla JavaScript, Python, Go, Rust i PHP. Każde SDK jest utrzymywane przez zespół TCG Price Lookup i zawiera pełne definicje typów.

$ npm install tcglookup
03

Pobierz ceny kart

Wyszukuj po nazwie, serii lub ID. Pobieraj ceny TCGPlayer i eBay w czasie rzeczywistym, ceny według stanu, ceny gradowanych kart i historię cen — wszystko przez jedno API.

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

Co możesz zbudować

API cen kart TCG jest używane od hobbystycznych skryptów po produkcyjne aplikacje tradingowe.

💰

Porównywarka cen

Pokazuj ceny rynkowe TCGPlayer i ceny sprzedaży eBay obok siebie. Kupujący znajdą najniższe ceny, sprzedający ustawią konkurencyjne oferty.

📊

Tracker portfelowy

Pozwól kolekcjonerom wprowadzać karty i śledzić wartość kolekcji w czasie. Użyj endpointów historii cen, żeby tworzyć wykresy zysków i strat.

🤖

Bot Discord

Dodaj slash commands do serwera TCG Discord, żeby członkowie mogli sprawdzać ceny kart bez wychodzenia z czatu. Open-source'owy starter bota Discord obsługujący wszystkie 8 gier można wdrożyć w kilka minut.

🔄

Aplikacja tradingowa

Wzbogać interfejs kupna/sprzedaży/wymiany o dane cenowe w czasie rzeczywistym. Obsługa wyświetlania sprawiedliwych wartości wymiany, wykrywania niedowartościowanych ofert i zbiorczego pobierania cen dla całych list decków.

🔔

Alerty cenowe

Monitoruj konkretne karty i powiadamiaj użytkowników, gdy cena przekroczy próg. Możesz używać cyklicznego pollingu lub powiadomień webhook (plany płatne).

📈

Dashboard analityczny

Twórz wykresy historii cen, analizuj trendy w całych seriach i szacuj kapitalizację rynkową zestawów. Endpointy historii cen dostarczają dzienne snapshoty za ostatni miesiąc.

TCG API dla każdej gry

Jeden klucz API dla 8 gier. Pokemon TCG API, MTG API, Yu-Gi-Oh! API, Lorcana, One Piece i więcej — wszystko przez jeden zunifikowany interfejs.

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.

Dokumentacja 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.

Dokumentacja 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.

Dokumentacja 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.

Dokumentacja 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.

Dokumentacja 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.

Dokumentacja 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.

Dokumentacja 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.

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

Porównanie TCG API

Jak TCG Price Lookup wypada na tle Scryfall, pokemontcg.io, TCGPlayer API i własnych scraperów.

Funkcja TCG Price Lookup Scryfall API pokemontcg.io TCGPlayer API Własny scraper
Liczba obsługiwanych gier 8 gier Tylko MTG Tylko Pokemon Wiele (zmiennie) Dowolne
Ceny w czasie rzeczywistym Częściowo (TCGP) ✓ (tylko TCGP) Zależy
Ceny według stanu Ręcznie
Ceny gradowanych (PSA/BGS/CGC) Ręcznie
Oficjalne SDK 5 języków Tylko community 1 (JS)
Plan darmowy ✓ 200 zapytań/dzień Brak danych cen Brak danych cen Wymagana aplikacja ✓ (własny koszt)
Historia cen Ograniczona Własna

Ekosystem programistyczny

Oprócz REST API: oficjalne SDK w 5 językach, gotowe narzędzia i pełna dokumentacja dla programistów.

Oficjalne SDK — 6 języków

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

Narzędzia i zasoby — 5 narzędzi

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 →

Często zadawane pytania

Od rozpoczęcia pracy z TCG Price Lookup API po limity zapytań i ceny gradowanych kart.

Czym jest TCG API?

+

TCG API (API gier karciarskich) to usługa internetowa zapewniająca programowy dostęp do danych o kartach. Możesz pobierać szczegóły kart, informacje o seriach, ceny rynkowe w czasie rzeczywistym i wiele więcej. Programiści używają TCG API do tworzenia trackerów cen, narzędzi portfelowych, botów Discord i innych aplikacji.

Czy TCG Price Lookup API jest darmowy?

+

Tak, TCG Price Lookup oferuje plan darmowy z 200 zapytaniami dziennie na projekty hobbystyczne i prototypy (użytek niekomercyjny). Plany płatne zapewniają wyższe limity, endpointy historii cen, ceny eBay, ceny gradowanych kart i prawa do użytku komercyjnego. Nie potrzebujesz karty kredytowej, żeby zacząć.

Które gry karciane są obsługiwane?

+

Obsługujemy 8 gier: Pokemon TCG (angielski), Pokemon (japoński), Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited i Flesh and Blood. Wszystkie gry korzystają z tych samych zunifikowanych endpointów wyszukiwania i kart.

Jak uzyskać klucz API Pokemon TCG?

+

Zarejestruj się na tcgpricelookup.com i potwierdź adres e-mail — klucz API zostanie wystawiony natychmiast. Bez procesu zatwierdzania: możesz od razu zacząć wysyłać zapytania do Pokemon TCG API (i wszystkich innych gier).

Czy obsługiwane są ceny gradowanych kart (PSA, BGS, CGC)?

+

Tak. Możesz pobierać ceny gradowanych kart PSA (oceny 1–10), Beckett (BGS 7–10, 9.5, Black Label 10) i CGC (oceny 1–10). Ceny gradowanych kart są pobierane z danych sprzedażowych eBay. Wymagany plan Trader lub wyższy.

Jakie są limity zapytań API?

+

Plan darmowy: maksymalnie 200 zapytań dziennie (burst: 1 zapytanie / 3 sek.). Plan Trader ($14.99/mies.): 10 000 zapytań dziennie (burst: 1 zapytanie / sek.). Plan Business ($89.99/mies.): 100 000 zapytań dziennie (burst: 3 zapytania / sek.). Dzienne limity resetują się o północy UTC.

Jakie SDK są dostępne?

+

Dostępnych jest 5 oficjalnych SDK: JavaScript/TypeScript (npm install tcglookup), 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). Dostępne jest też narzędzie CLI do dostępu z terminala.

Jak często aktualizowane są ceny kart?

+

Ceny kart są aktualizowane w sposób ciągły. Ceny rynkowe TCGPlayer są odświeżane co kilka godzin wraz z napływem nowych danych sprzedaży. Aukcje eBay są aktualizowane codziennie. Dla najbardziej wrażliwych czasowo aplikacji możesz śledzić trendy za pomocą endpointów historii cen.

Zacznij budować z TCG API już dziś

Plan darmowy w zestawie. Bez karty kredytowej. Natychmiastowy dostęp do ponad 300 000 kart z 8 gier.