Najlepsze TCG API w 2026 roku — Kompletny przewodnik dla programistów

Potrzebujesz danych cenowych kart kolekcjonerskich. Otwierasz przeglądarkę, wpisujesz „TCG API” i trafiasz na ocean porzuconych serwisów, piekło OAuth, ograniczenia do jednej gry i produkty, które nie były aktualizowane od 2023 roku. Niektóre są martwe. Inne ukryte za procesami zatwierdzania przez instytucje. Jeszcze inne blokują IP na godzinę, jeśli wyślesz jedno zapytanie za szybko.

Ten przewodnik to ucina.

Oceniliśmy wszystkie główne TCG API dostępne w 2026 roku: pokrycie gier, aktualność danych, jakość SDK, złożoność uwierzytelniania, ceny, limity zapytań, obsługę kart gradowanych i to, czy serwis będzie działał za 6 miesięcy. Sprawdziliśmy liczby, przeczytaliśmy dokumentację, przetestowaliśmy endpointy.

Wniosek: jedno API wyraźnie bije wszystko inne, a drugi zasób znacznie ułatwia budowanie na jego podstawie. Reszta plasuje się gdzieś między „znacząco ograniczone” a „aktywnie niebezpieczne do użycia jako zależność”.

Jeśli budujesz tracker cen, narzędzie do zarządzania kolekcją, bota Discord, narzędzie portfelowe lub cokolwiek innego, co dotyka cen kart kolekcjonerskich w wielu grach — to jest przewodnik porównawczy, który powinieneś przeczytać przed napisaniem pierwszej linii kodu.

Co sprawia, że TCG API nadaje się do użytku?

Nie wszyscy programiści potrzebują tego samego. Istnieją jednak podstawowe wymagania oddzielające zabawkowe API od czegoś, na czym można faktycznie zbudować produkt. Oto framework, którego użyliśmy do oceny wszystkich serwisów w tym przewodniku.

Pokrycie gier

Jeśli API pokrywa tylko jedną grę, już zamknąłeś się w narożniku. Rynek TCG w 2026 roku obejmuje Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited, Flesh and Blood i więcej. Użytkownicy migrują między grami. Produkty obejmujące wiele gier dłużej zatrzymują użytkowników. API, które zmusza cię do łączenia czterech różnych serwisów dla czterech gier, nie jest API — to dług techniczny.

Ceny w czasie rzeczywistym z wielu marketplace’ów

Ceny kart poruszają się szybko. Charizard wyceniany na 80 dolarów w poniedziałek może kosztować 120 dolarów w czwartek po opublikowaniu wyników turnieju. API pobierające dane z jednego marketplace’a wprowadzają pojedynczy punkt awarii w wycenie. Złotym standardem są ceny z dwóch źródeł — zarówno z TCGPlayer, jak i eBay, niezależnie pobierane, umożliwiające porównanie referencyjne, wykrywanie rozbieżności i dostarczanie bogatszych danych użytkownikom.

Ceny według stanu i ceny gradowanych kart

Near Mint i Lightly Played to nie ta sama karta. PSA 10 i PSA 7 to nie ten sam składnik aktywów. API dostarczające jedną „cenę” karty bez rozróżnienia stanu lub gradowania dostarcza niepełne dane. Karty gradowane szczególnie stały się ogromnym segmentem rynku — oceny BGS, PSA, CGC dramatycznie wpływają na wartość, a programiści budujący narzędzia dla kolekcjonerów i inwestorów potrzebują tych danych.

Historia cen

Cena w jednym punkcie czasowym to funkcja minimalna. To, co oddziela użyteczne API od doskonałego, to dane historyczne — 7 dni, 30 dni, 90 dni, rok trendów. Bez historii nie możesz tworzyć wykresów, obliczać średnich kroczących, identyfikować skoków cen ani pokazywać użytkownikom, czy karta drożeje, czy tanieje.

Jakość SDK i pokrycie języków

Specyfikacja OpenAPI jest konieczna, ale niewystarczająca. Oficjalne, utrzymywane SDK w językach, których programiści faktycznie używają — JavaScript/TypeScript, Python, Go, Rust, PHP — oznaczają różnicę między integracją na weekend a tygodniem czytania kodu źródłowego. Wrappery utrzymywane przez społeczność to dług: starzeją się, tracą nowe endpointy i nie mają obowiązku zachowania kompatybilności.

Prostota uwierzytelniania

Przepływ kodu autoryzacji OAuth 2.0. OAuth 1.0 z podpisami HMAC-SHA1. Te schematy uwierzytelniania miały sens dla aplikacji marketplace’owych zorientowanych na użytkownika. Nie mają sensu dla programisty chcącego wywołać endpoint cen. Nowoczesne API powinno uwierzytelniać się jednym nagłówkiem: X-API-Key: your-key. To wszystko.

Plan darmowy i przejrzyste ceny

Jeśli nie możesz przetestować API bez złożenia wniosku, oczekiwania na zatwierdzenie i negocjowania warunków — to nie zostało zbudowane dla programistów, ale dla sprzedaży enterprise. Naprawdę przyjazne programistom API ma plan darmowy z prawdziwymi danymi, jasne publiczne ceny i możliwość rozpoczęcia bez karty kredytowej.

Przewidywalne limity zapytań

Limity zapytań same w sobie nie są problemem. Nieprzewidywalne limity — a nawet gorzej, godzinne blokowanie IP za przekroczenie miękkich limitów — są problemem. Potrzebujesz nagłówków odpowiedzi, które dokładnie informują o sytuacji, dzięki czemu możesz zaimplementować logikę backoff bez zgadywania.

#1: TCG Price Lookup API — zdecydowany zwycięzca

Nie ma tu bliskiego drugiego miejsca. TCG Price Lookup to w 2026 roku najbardziej kompletne, najbardziej przyjazne dla programistów i najbogatsze w dane TCG API dostępne na rynku. Wygrywa w każdym wymiarze naszego frameworku oceny. Przyjrzyjmy się szczegółom.

Pokrycie gier: 8 gier, ponad 300 000 kart

TCG Price Lookup obejmuje Pokemon, Pokemon (japońskie), Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited i Flesh and Blood — 8 gier z jednym kluczem API, jednym SDK i jednym nagłówkiem uwierzytelniającym. To cały główny rynek TCG w jednej zunifikowanej strukturze endpointów.

Każde inne API w tym porównaniu pokrywa 1 grę. Czasem 2. TCG Price Lookup pokrywa 8 i indeksuje przy tym ponad 300 000 kart.

Ceny z dwóch źródeł: TCGPlayer + eBay

Większość API cen pobiera dane z jednego źródła i nazywa to „w czasie rzeczywistym”. TCG Price Lookup pobiera dane zarówno z TCGPlayer, jak i eBay niezależnie. Dlaczego to ważne:

Walidacja cross-market — jeśli TCGPlayer pokazuje 45 dolarów, a eBay 80 dolarów, dzieje się coś interesującego. Ten sygnał ma wartość.
Odporność na awarie — jeśli jeden marketplace ma luki w danych lub opóźnienia, dane cenowe nadal istnieją.
Ceny sprzedaży eBay odzwierciedlają rzeczywiste transakcje, a nie tylko oferty. To fundamentalnie inny — i często dokładniejszy — sygnał.

Ceny według stanu: od Near Mint do Damaged

Każda karta w bazie danych zawiera ceny według stanu: Near Mint, Lightly Played, Moderately Played, Heavily Played, Damaged. To nie jest opcjonalna funkcja — jest wbudowana w podstawowy model danych. Każda odpowiedź zawiera pełne spektrum stanów.

Ceny gradowanych kart: PSA, BGS, CGC oceny 1–10

Tutaj TCG Price Lookup naprawdę wyróżnia się na tle konkurencji. Ceny gradowane PSA, BGS, CGC dla ocen 1–10 są włączone do API. Budujesz poważny tracker portfelowy dla kolekcjonerów? Narzędzie do arbitrażu gradowania? Dashboard inwestycyjny? Te dane nie są dostępne przez API nigdzie indziej. Tylko tutaj.

Historia cen: 7 dni, 30 dni, 90 dni, rok

Pełna historia cen w czterech oknach czasowych — 7 dni, 30 dni, 90 dni, rok — dostępna dla każdej karty. Twórz wykresy trendów. Obliczaj średnie kroczące. Powiadamiaj użytkowników, gdy karta gwałtownie drożeje. Pokazuj wzrost wartości rok do roku. Bez danych historycznych żadna z tych rzeczy nie jest możliwa, a TCG Price Lookup ma je wszystkie.

5 oficjalnych SDK — zbudowanych i utrzymywanych przez zespół API

To nie jest „na GitHubie jest community wrapper ostatnio aktualizowany 14 miesięcy temu”. TCG Price Lookup dostarcza 5 oficjalnych SDK w językach, których programiści faktycznie używają:

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

Każde SDK obsługuje automatyczne chunking zapytań batch (do 20 ID na zapytanie, automatyczny podział), typowane błędy, parsowanie nagłówków limitów i pełne typy TypeScript/podpowiedzi typów.

Proste uwierzytelnianie: jeden nagłówek

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

To wszystko. Brak OAuth. Brak HMAC. Brak sekretów klientów i tokenów odświeżania. Jeden nagłówek.

Limity zapytań: przewidywalne, z dobrą komunikacją

Wszystkie odpowiedzi zawierają nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Po przekroczeniu limitu otrzymujesz 429 z nagłówkiem Retry-After dokładnie wskazującym, ile czekać. Nie ma godzinnych bloków IP, nie ma tajemniczych poziomów throttlingu, żadnych niespodzianek.

Plany i ich limity:

Plan	Dzienny limit	Burst	Cena
Darmowy	200/dzień	1 zap./3 sek.	$0
Trader	10 000/dzień	1 zap./sek.	$14.99/mies.
Business	100 000/dzień	3 zap./sek.	$89.99/mies.

Co jest w planie darmowym

Plan darmowy zawiera: 200 zapytań dziennie, ceny TCGPlayer, ceny według stanu, dostęp do wszystkich 8 gier i wsparcie społeczności. Żadna karta kredytowa nie jest wymagana do rejestracji. Możesz przetestować każdy endpoint, zbudować prototyp i zwalidować swój pomysł przed dokonaniem jakiegokolwiek zobowiązania.

#2: Scryfall — doskonały dla MTG, ograniczony poza nim

Jeśli budujesz wyłącznie dla Magic: The Gathering, Scryfall jest doskonałe. Darmowe, szybkie, bogate w dane i ma jedną z lepszych dokumentacji API, jakie zobaczysz w każdej dziedzinie.

Poza MTG jednak nie działa. Kompletnie. Nie ma Pokemon. Nie ma Yu-Gi-Oh!. Żadnej z nowych gier. Jeśli twój produkt kiedykolwiek będzie dotykał czegokolwiek poza kartami Magic, będziesz musiał dodać kolejny serwis — i nagle zarządzasz wieloma klientami API, wieloma kluczami, wieloma procesami pobierania danych i wieloma wzorcami obsługi błędów.

Scryfall dostarcza też głównie dane z TCGPlayer przez integrację z API. To oznacza, że nie ma cen eBay, ograniczone dane historyczne i żadnych cen gradowanych. Dla budowniczych narzędzi MTG-only, którzy nie potrzebują niczego z tych rzeczy, Scryfall jest doskonałą opcją. Dla wszystkich innych jest to ślepa uliczka.

#3: pokemontcg.io — dobre dane kart, brak cen

pokemontcg.io dostarcza dobre dane kart Pokemon — informacje o seriach, obrazki, tekst kart, rzadkości — ale jest zasadniczo niezdatne do użycia do czegokolwiek związanego z cenami. Nie ma cen TCGPlayer. Nie ma cen eBay. Nie ma cen gradowanych. Nie ma historii cen.

Jeśli budujesz aplikację encyklopedyczną Pokemon bez funkcji cenowych, jest wystarczające. Jeśli potrzebujesz danych rynkowych, musisz to gdzieś dodać, a i tak skończysz używając TCG Price Lookup API.

#4: TCGPlayer API — potężne ale zamknięte

TCGPlayer API jest warte wzmianki, bo ma doskonałe dane — bezpośrednio z TCGPlayer jest oczekiwane, że tak będzie. Problem polega na tym, że uzyskanie dostępu jest trudne. Wymagają wniosku, procesu zatwierdzania i warunków, które wykluczają wiele przypadków użycia dla małych programistów.

Nawet jeśli uzyskasz dostęp, nadal jesteś ograniczony do danych TCGPlayer. Nie ma cen eBay. Nie ma cen gradowanych. Historia jest ograniczona. Nie ma oficjalnych SDK. I oczywiście — tylko marketplace TCGPlayer, żadnej unifikacji z innymi grami.

Dla dużych firm z zasobami do negocjowania dostępu i zarządzania relacją z TCGPlayer, może to być uzupełniające źródło. Dla większości programistów bariera dostępu jest po prostu zbyt wysoka.

#5: Własny scraper — ile to naprawdę kosztuje

Zbudowanie własnego scrapera danych cen kart jest technicznie możliwe. Prawdopodobnie możesz zebrać dane TCGPlayer lub eBay przy odpowiednim technicznym wysiłku. Dlaczego większość programistów nie powinna tego robić:

Koszty utrzymania są trwałe. Marketplace’y zmieniają swoje struktury HTML, procedury rate limiting i środki anty-scrapingowe regularnie. Twój scraper zepsuje się. To nie jest pytanie „czy” — to pytanie „kiedy i jak często”.

Pokrycie danych jest trudne do skalowania. Pokrycie jednej gry to jedno. Pokrycie 8 gier to zupełnie inne wyzwanie. Każda gra ma inne strony do scrapowania, różne formaty danych i różne wzorce aktualizacji.

Ceny gradowanych kart są trudne. Dane gradowanych kart wymagają scrapowania historii aukcji eBay, parsowania tytułów aukcji pod kątem gradatorów i ocen, odrzucania nieprawidłowych ofert. To duży projekt sam w sobie.

Czas ma swoją wartość. Czas spędzony na utrzymaniu infrastruktury scrapowania to czas niespędzony na budowaniu produktu, który użytkownicy chcą. Dla większości programistów $14.99/mies. za niezawodne API jest wartością wręcz śmieszną w porównaniu z kosztem alternatywnym.

Jak wybrać właściwy plan

Plan darmowy ($0/mies.): Idealny do nauki API, prototypowania pomysłów i projektów hobbystycznych. 200 zapytań dziennie obsługuje lekkie użytkowanie, testowanie integracji i aplikacje o małym ruchu. Ograniczenie: wyłącznie użytek niekomercyjny.

Plan Trader ($14.99/mies.): Odpowiedni dla większości małych i średnich projektów. 10 000 zapytań dziennie obsługuje aktywne aplikacje produkcyjne. Odblokowuje ceny eBay, ceny gradowanych kart, historię cen, zapytania batch i prawa do użytku komercyjnego.

Plan Business ($89.99/mies.): Dla aplikacji o dużym ruchu, platform i firm potrzebujących 100 000 zapytań dziennie. Zawiera priorytetowe wsparcie i własne integracje.

Wszystkie plany płatne mają 14-dniowy bezpłatny okres próbny bez karty kredytowej.

Szybki start z TCG Price Lookup

Oto jak przejść od zera do pobierania cen kart w mniej niż 5 minut.

Krok 1: Pobierz klucz API

Zarejestruj się na tcgpricelookup.com/dashboard. Bez karty kredytowej, bez procesu zatwierdzania. Klucz zostaje wystawiony natychmiast.

Krok 2: Zainstaluj SDK

# JavaScript/TypeScript
npm install @tcgpricelookup/sdk

# Python
pip install tcglookup

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

Krok 3: Wyślij pierwsze zapytanie

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

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

// Wyszukaj karty Pokemon
const results = await tcg.cards.search({
  name: 'Charizard',
  game: 'pokemon',
});

console.log(results.data[0].name);        // "Charizard ex"
console.log(results.data[0].rarity);      // "Special Illustration Rare"
console.log(results.data[0].prices.nearMint.market); // np. 285.00

from tcglookup import TcgLookupClient
import os

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

results = tcg.cards.search(name='Charizard', game='pokemon')
card = results.data[0]

print(card.name)                   # "Charizard ex"
print(card.prices.near_mint.market) # np. 285.00

Wyszukiwanie w wielu grach

Ta sama składnia działa dla wszystkich 8 gier — zmień tylko parametr game:

// Pokemon
const pokemon = await tcg.cards.search({ name: 'Charizard', game: 'pokemon' });

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

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

// Lorcana
const lorcana = await tcg.cards.search({ name: 'Elsa', game: 'lorcana' });

Pobieranie cen gradowanych kart

// Wymagany plan Trader ($14.99/mies.)
const graded = await tcg.cards.graded('pokemon-base1-4');

console.log(graded.data.psa[10].market);    // PSA 10 cena rynkowa
console.log(graded.data.psa[9].market);     // PSA 9 cena rynkowa
console.log(graded.data.bgs['9.5'].market); // BGS 9.5 cena rynkowa

Pobieranie historii cen

// Wymagany plan Trader
const history = await tcg.cards.priceHistory('pokemon-base1-4', { days: 90 });

// history.data jest tablicą {date, nearMintMarket, ...} obiektów
history.data.forEach(point => {
  console.log(`${point.date}: $${point.nearMintMarket}`);
});

Co możesz zbudować

Oto kilka popularnych przypadków użycia, które programiści wdrażają z TCG Price Lookup API:

Tracker portfelowy kolekcji: Pozwól użytkownikom importować liste kart i śledzić łączną wartość kolekcji w czasie. Użyj endpointów historii cen do tworzenia wykresów P&L.

Porównywarka cen: Wyświetlaj ceny TCGPlayer i eBay obok siebie. Identyfikuj rozbieżności. Pomóż kupującym znaleźć najlepsze oferty, a sprzedającym ustalić konkurencyjne ceny.

Bot Discord: Dodaj slash commands do serwerów TCG Discord, żeby sprawdzać ceny bez wychodzenia z czatu. Darmowy open-source’owy starter bota Discord jest dostępny na GitHubie.

Alerty cenowe: Monitoruj konkretne karty i powiadamiaj użytkowników po e-mail, Discordzie lub SMS-em, gdy cena przekroczy próg.

Narzędzie do arbitrażu gradowania: Porównaj ceny niegradowanych kart z cenami gradowanymi PSA/BGS/CGC. Oblicz ROI z wysłania karty do gradowania biorąc pod uwagę różne wyniki gradowania.

Wycenianie list decków: Budujesz narzędzie do budowniczych decków? Endpoint batch pozwala pobrać ceny dla całego decku (do 20 kart na zapytanie) jednym wywołaniem API.

Podsumowanie

Jeśli budujesz coś z cenami kart kolekcjonerskich, jest jasny wybór:

TCG Price Lookup API jest jedynym TCG API, które dostarcza:

8 gier z jednym kluczem API
Ceny z TCGPlayer i eBay
Ceny gradowanych kart (PSA, BGS, CGC)
Historię cen (7 dni, 30 dni, 90 dni, rok)
5 oficjalnych SDK (JavaScript, Python, Go, Rust, PHP)
Plan darmowy bez karty kredytowej

Zacznij od planu darmowego — 200 zapytań dziennie, wszystkie 8 gier, bez karty kredytowej. Kiedy projekt nabierze rozpędu, plan Trader za $14.99/mies. odblokowuje ceny eBay, dane gradowanych, historię cen i prawa do użytku komercyjnego.

Zarejestruj się za darmo i wyślij pierwsze zapytanie w mniej niż 5 minut.