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

Cel mai rapid
TCG Price API
pentru dezvoltatori

API de prețuri în timp real pentru Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece și 3 jocuri în plus. Peste 300.000 de cărți, 5 SDK-uri oficiale, nivel gratuit inclus.

300,000+ Cărți
8 Jocuri
5 SDK-uri
2 Piețe
Free Nivel gratuit
24/7 Actualizări
Pornire rapidă 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

Cum funcționează TCG API

De la zero la primul preț de carte în sub 5 minute. 3 pași, fără configurare.

01

Obțineți o cheie API gratuită

Înregistrați-vă pe tcgpricelookup.com — fără card de credit. Cheia API este emisă imediat și funcționează pentru toate cele 8 jocuri suportate. Planul gratuit include 200 de cereri pe zi, suficient pentru a începe dezvoltarea imediat.

API key: tpl_live_xxxxxxxxxxxx
02

Instalați SDK-ul

Alegeți limbajul preferat. SDK-urile oficiale sunt disponibile pentru JavaScript, Python, Go, Rust și PHP. Fiecare SDK este întreținut de echipa TCG Price Lookup și vine cu definiții complete de tipuri.

$ npm install tcglookup
03

Obțineți prețuri pentru cărți

Căutați după numele cărții, set sau ID. Obțineți prețuri în timp real de pe TCGPlayer și eBay, prețuri pe condiție, prețuri gradate și istoricul prețurilor — toate dintr-un singur API.

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

Ce puteți construi

API-ul pentru prețuri TCG este folosit pentru orice, de la scripturi hobby până la aplicații de tranzacționare în producție.

💰

Instrumente de comparare prețuri

Afișați prețurile de piață TCGPlayer alături de prețurile eBay finalizate. Cumpărătorii găsesc cele mai mici prețuri; vânzătorii stabilesc prețuri competitive.

📊

Urmăritor de portofoliu

Colecționarii introduc cărțile și urmăresc valoarea colecției în timp. Endpoint-ul de istoric al prețurilor permite realizarea graficelor pentru profit și pierdere.

🤖

Bot Discord

Adăugați comenzi slash pe serverele Discord TCG, astfel încât membrii să poată verifica prețurile cărților fără a părăsi chat-ul. Un bot Discord open-source pentru toate cele 8 jocuri poate fi implementat în câteva minute.

🔄

Aplicații de tranzacționare

Alimentați interfețele de cumpărare/vânzare/schimb cu date de prețuri în timp real. Afișați valori de schimb echitabile, detectați listări sub preț, obțineți prețuri în lot pentru liste întregi de pachet.

🔔

Alerte de prețuri

Urmăriți cărți specifice și notificați utilizatorii când prețul depășește un prag. Utilizați polling programat sau notificări webhook pe planurile plătite.

📈

Dashboard de analiză

Construiți grafice de istoricul prețurilor, analize de tendințe pentru seturi întregi, estimări ale capitalizării de piață. Endpoint-ul de istoric al prețurilor oferă instantanee zilnice lunare.

Un TCG API pentru toate jocurile

O singură cheie API pentru 8 jocuri. API-ul Pokémon TCG, API-ul MTG, API-ul Yu-Gi-Oh!, Lorcana, One Piece și altele — toate într-o singură interfață unificată.

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.

Documentație API Pokemon →
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.

Documentație API Magic: The Gathering →
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.

Documentație API Yu-Gi-Oh! →
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.

Documentație API Disney Lorcana →
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.

Documentație API One Piece →
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.

Documentație API Pokemon Japan →
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.

Documentație API Star Wars: Unlimited →
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.

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

Comparație TCG API

TCG Price Lookup față de Scryfall, pokemontcg.io, TCGPlayer API și scraperele proprii.

Funcționalitate TCG Price Lookup Scryfall API pokemontcg.io TCGPlayer API Scraper propriu
Jocuri suportate 8 jocuri Doar MTG Doar Pokémon Mai multe (variabil) Orice
Prețuri în timp real Parțial (TCGP) ✓ (doar TCGP) Depinde
Prețuri pe condiție Manual
Prețuri gradate (PSA/BGS/CGC) Manual
SDK-uri oficiale 5 limbaje Doar comunitate 1 (JS)
Plan gratuit ✓ 200 cereri/zi Fără date de prețuri Fără date de prețuri Necesită cerere ✓ (pe propria cheltuială)
Istoricul prețurilor Limitat Personalizat

Ecosistemul pentru dezvoltatori

Pe lângă REST API, avem 5 SDK-uri oficiale în 5 limbaje, instrumente gata de utilizat și documentație completă pentru dezvoltatori.

SDK-uri oficiale — 6 limbaje

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

Instrumente și resurse — 5 instrumente

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 →

Întrebări frecvente

De la cum să începeți cu API-ul TCG Price Lookup până la limite de rată și prețuri pentru cărți gradate.

Ce este un TCG API?

+

Un TCG API (Application Programming Interface pentru jocuri de cărți de colecție) este un serviciu web care oferă acces programatic la datele despre cărți. Puteți obține detalii despre cărți, informații despre seturi și prețuri de piață în timp real. Dezvoltatorii folosesc TCG API-urile pentru a construi instrumente de urmărire a prețurilor, portofolii, boți Discord și altele.

TCG Price Lookup API este gratuit?

+

Da, TCG Price Lookup oferă un plan gratuit cu 200 de cereri pe zi pentru proiecte hobby și prototipuri (utilizare necomercială). Planurile plătite oferă limite de rată mai mari, endpoint-uri de istoric al prețurilor, prețuri eBay, prețuri pentru cărți gradate și drepturi de utilizare comercială. Nu este necesar un card de credit pentru a începe.

Ce jocuri de cărți de colecție sunt suportate?

+

În prezent sunt suportate 8 jocuri: Pokémon TCG (engleză), Pokémon japoneză, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited și Flesh and Blood. Toate jocurile folosesc aceleași endpoint-uri unificate de căutare și cărți.

Cum obțin o cheie API pentru Pokémon TCG?

+

Înregistrați-vă pe tcgpricelookup.com și confirmați adresa de email — cheia API va fi emisă imediat. Puteți începe să trimiteți cereri către Pokémon TCG API (și toate celelalte jocuri) fără niciun proces de aprobare.

Sunt suportate prețurile pentru cărți gradate (PSA, BGS, CGC)?

+

Da. Puteți obține prețuri pentru cărți gradate PSA (gradele 1–10), Beckett (BGS 7–10, inclusiv 9.5 și 10 Black Label) și CGC (gradele 1–10). Prețurile gradate sunt extrase din datele de vânzări eBay. Necesită planul Trader sau superior.

Care sunt limitele de rată ale API-ului?

+

Planul gratuit: maxim 200 de cereri pe zi (burst: 1 cerere/3 secunde). Planul Trader ($14.99/lună): 10.000 de cereri pe zi (burst: 1 cerere/secundă). Planul Business ($89.99/lună): 100.000 de cereri pe zi (burst: 3 cereri/secundă). Limitele zilnice se resetează la miezul nopții UTC.

Ce SDK-uri sunt disponibile?

+

Există 5 SDK-uri oficiale: JavaScript/TypeScript (npm install tcglookup), Python (pip install tcglookup), Go (go get github.com/TCG-Price-Lookup/tcglookup-go), Rust (cargo add tcglookup) și PHP (composer require tcg-price-lookup/tcglookup). Un instrument CLI este de asemenea disponibil pentru acces din terminal.

Cât de des sunt actualizate prețurile cărților?

+

Prețurile cărților sunt actualizate continuu. Prețurile de piață TCGPlayer sunt actualizate la câteva ore odată cu noile date de vânzări. Listările eBay finalizate sunt actualizate zilnic. Pentru aplicațiile cele mai sensibile la timp, puteți urmări tendințele folosind endpoint-ul de istoric al prețurilor.

Începeți să dezvoltați cu TCG API astăzi

Plan gratuit inclus. Fără card de credit. Acces imediat la peste 300.000 de cărți din 8 jocuri.