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

Το ταχύτερο
TCG Price API
για προγραμματιστές

API τιμών καρτών σε πραγματικό χρόνο για Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece και 3 ακόμα παιχνίδια. Πάνω από 300.000 κάρτες, 5 επίσημα SDK, δωρεάν επίπεδο συμπεριλαμβάνεται.

300,000+ Κάρτες
8 Παιχνίδια
5 SDK
2 Αγορές
Free Δωρεάν επίπεδο
24/7 Ενημερώσεις
Γρήγορη εκκίνηση 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

Πώς λειτουργεί το TCG API

Από το μηδέν ως τη λήψη δεδομένων τιμών καρτών σε λιγότερο από 5 λεπτά. 3 βήματα, χωρίς διαμόρφωση.

01

Αποκτήστε δωρεάν API key

Εγγραφείτε στο tcgpricelookup.com — χωρίς πιστωτική κάρτα. Το API key εκδίδεται αμέσως και λειτουργεί σε όλα τα 8 υποστηριζόμενα παιχνίδια. Το δωρεάν πλάνο παρέχει 200 αιτήματα/ημέρα για να ξεκινήσετε αμέσως την ανάπτυξη.

API key: tpl_live_xxxxxxxxxxxx
02

Εγκαταστήστε ένα SDK

Επιλέξτε τη γλώσσα που προτιμάτε. Τα επίσημα SDK καλύπτουν JavaScript, Python, Go, Rust και PHP. Κάθε SDK συντηρείται από την ομάδα TCG Price Lookup και παρέχεται με πλήρεις ορισμούς τύπων.

$ npm install tcglookup
03

Ανακτήστε τιμές καρτών

Αναζητήστε με βάση το όνομα, το σετ ή το ID κάρτας. Λάβετε τιμές αγοράς TCGPlayer και eBay σε πραγματικό χρόνο, τιμές ανά κατάσταση, τιμές βαθμολογημένων καρτών και ιστορικό τιμών — όλα από ένα API.

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

Τι μπορείτε να δημιουργήσετε

Το API τιμών συλλεκτικών καρτών TCG χρησιμοποιείται για scripts χόμπι έως εφαρμογές συναλλαγών σε παραγωγή.

💰

Εργαλεία σύγκρισης τιμών

Εμφανίστε τιμές αγοράς TCGPlayer δίπλα στις τιμές eBay. Οι αγοραστές βρίσκουν τη χαμηλότερη τιμή, οι πωλητές ορίζουν ανταγωνιστικές τιμές.

📊

Παρακολούθηση portfolio

Οι συλλέκτες εισάγουν τις κάρτες τους και παρακολουθούν την αξία της συλλογής τους στο χρόνο. Δημιουργήστε γραφήματα κερδών/ζημιών με το endpoint ιστορικού τιμών.

🤖

Discord bot

Προσθέστε slash commands σε TCG Discord servers ώστε τα μέλη να αναζητούν τιμές καρτών χωρίς να αφήσουν τη συνομιλία. Ανοιχτού κώδικα Discord bot starter για 8 παιχνίδια, αναπτύσσεται σε λίγα λεπτά.

🔄

Εφαρμογές συναλλαγών

Ενισχύστε διεπαφές αγοράς/πώλησης/ανταλλαγής με δεδομένα τιμών σε πραγματικό χρόνο. Εμφανίστε δίκαιες αξίες ανταλλαγής, ανιχνεύστε υποτιμολογημένες αγγελίες και ανακτήστε τιμές για ολόκληρες λίστες decklistών μαζικά.

🔔

Ειδοποιήσεις τιμών

Παρακολουθήστε συγκεκριμένες κάρτες και ειδοποιήστε τους χρήστες όταν οι τιμές υπερβούν ένα κατώφλι. Χρησιμοποιήστε προγραμματισμένη ανίχνευση ή ειδοποιήσεις webhook για επί πληρωμή πλάνα.

📈

Πίνακες ελέγχου αναλύσεων

Δημιουργήστε γραφήματα ιστορικού τιμών, αναλύστε τάσεις σε ολόκληρα σετ και εκτιμήστε τη χρηματιστηριακή αξία σετ. Το endpoint ιστορικού τιμών παρέχει ημερήσια snapshots για τον τελευταίο μήνα.

TCG API για κάθε παιχνίδι

Ένα API key για 8 παιχνίδια. Pokemon TCG API, MTG API, Yu-Gi-Oh! API, Lorcana, One Piece και άλλα — όλα σε μια ενιαία διεπαφή.

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.

Δείτε τεκμηρίωση 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.

Δείτε τεκμηρίωση 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.

Δείτε τεκμηρίωση 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.

Δείτε τεκμηρίωση 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.

Δείτε τεκμηρίωση 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.

Δείτε τεκμηρίωση 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.

Δείτε τεκμηρίωση 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.

Δείτε τεκμηρίωση Flesh and Blood API →
Flesh and Blood API example JavaScript
const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cards

Σύγκριση TCG API

TCG Price Lookup έναντι Scryfall, pokemontcg.io, TCGPlayer API και ιδιόκτητων scrapers.

Χαρακτηριστικό TCG Price Lookup Scryfall API pokemontcg.io TCGPlayer API Ιδιόκτητος scraper
Αριθμός παιχνιδιών 8 παιχνίδια Μόνο MTG Μόνο Pokemon Πολλά (ποικίλει) Ελεύθερα
Τιμές σε πραγματικό χρόνο Μερικώς (TCGP) ✓ (μόνο TCGP) Εξαρτάται
Τιμές ανά κατάσταση Χειροκίνητα
Τιμές βαθμολογημένων (PSA/BGS/CGC) Χειροκίνητα
Επίσημα SDK 5 γλώσσες Μόνο κοινότητα 1 (JS)
Δωρεάν πλάνο ✓ 200 αιτήματα/ημέρα Χωρίς δεδομένα τιμών Χωρίς δεδομένα τιμών Απαιτείται αίτηση ✓ (με κόστος)
Ιστορικό τιμών Περιορισμένο Ιδιόκτητο

Οικοσύστημα Προγραμματιστών

Πέρα από το REST API, 5 επίσημα SDK, έτοιμα εργαλεία και πλήρης τεκμηρίωση για προγραμματιστές.

Επίσημα SDK — 6 γλώσσες

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

Εργαλεία & Πόροι — 5 εργαλεία

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 →

Συχνές Ερωτήσεις

Από τα πρώτα βήματα με το TCG Price Lookup API ως τα όρια ρυθμού και τις τιμές βαθμολογημένων καρτών.

Τι είναι το TCG API;

+

Το TCG API (Trading Card Game API) είναι μια διαδικτυακή υπηρεσία που παρέχει προγραμματιστική πρόσβαση σε δεδομένα συλλεκτικών καρτών. Μπορείτε να ανακτήσετε λεπτομέρειες καρτών, πληροφορίες για σετ και τιμές αγοράς σε πραγματικό χρόνο. Οι προγραμματιστές χρησιμοποιούν το TCG API για να δημιουργήσουν εφαρμογές παρακολούθησης τιμών, εργαλεία portfolio, Discord bot και πολλά άλλα.

Είναι δωρεάν το TCG Price Lookup API;

+

Ναι, το TCG Price Lookup προσφέρει ένα δωρεάν πλάνο με 200 αιτήματα ανά ημέρα για projects χόμπι και πρωτότυπα (μη εμπορική χρήση). Τα επί πληρωμή πλάνα προσφέρουν υψηλότερα όρια ρυθμού, endpoints ιστορικού τιμών, τιμές eBay, τιμές βαθμολογημένων καρτών και εμπορικά δικαιώματα χρήσης. Δεν απαιτείται πιστωτική κάρτα για να ξεκινήσετε.

Ποια παιχνίδια συλλεκτικών καρτών υποστηρίζονται;

+

Υποστηρίζουμε αυτή τη στιγμή 8 παιχνίδια: Pokemon TCG (αγγλική έκδοση), Pokemon ιαπωνική έκδοση, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited και Flesh and Blood. Όλα τα παιχνίδια χρησιμοποιούν τα ίδια ενοποιημένα endpoints αναζήτησης και καρτών.

Πώς μπορώ να αποκτήσω ένα Pokemon TCG API key;

+

Εγγραφείτε στο tcgpricelookup.com και επιβεβαιώστε το email σας — το API key εκδίδεται αμέσως. Χωρίς διαδικασία έγκρισης. Μπορείτε να αρχίσετε αμέσως να κάνετε αιτήματα στο Pokemon TCG API (και σε όλα τα άλλα παιχνίδια).

Υποστηρίζονται οι τιμές βαθμολογημένων καρτών (PSA, BGS, CGC);

+

Ναι. Μπορείτε να ανακτήσετε τιμές βαθμολογημένων καρτών για PSA (βαθμοί 1-10), Beckett BGS (βαθμοί 7-10, 9.5, 10 Black Label) και CGC (βαθμοί 1-10). Οι τιμές βαθμολογημένων καρτών προέρχονται από δεδομένα πωλήσεων eBay. Απαιτείται πλάνο Trader ή ανώτερο.

Ποια είναι τα όρια ρυθμού του API;

+

Το δωρεάν πλάνο επιτρέπει έως 200 αιτήματα/ημέρα (burst: 1 αίτημα/3 δευτερόλεπτα). Το πλάνο Trader ($14,99/μήνα) επιτρέπει 10.000 αιτήματα/ημέρα (burst: 1 αίτημα/δευτερόλεπτο). Το πλάνο Business ($89,99/μήνα) επιτρέπει 100.000 αιτήματα/ημέρα (burst: 3 αιτήματα/δευτερόλεπτο). Τα ημερήσια όρια επαναφέρονται τα μεσάνυχτα UTC.

Ποια SDK είναι διαθέσιμα;

+

Υπάρχουν 5 επίσημα 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). Διατίθεται επίσης ένα CLI εργαλείο για πρόσβαση από το τερματικό.

Πόσο συχνά ενημερώνονται οι τιμές καρτών;

+

Οι τιμές καρτών ενημερώνονται συνεχώς. Οι τιμές αγοράς TCGPlayer ενημερώνονται κάθε λίγες ώρες καθώς εισέρχονται νέα δεδομένα πωλήσεων. Οι αγγελίες eBay ενημερώνονται καθημερινά. Για τις πιο χρονοευαίσθητες εφαρμογές, το endpoint ιστορικού τιμών σάς επιτρέπει να παρακολουθείτε τάσεις.

Ξεκινήστε να αναπτύσσετε με το TCG API σήμερα

Συμπεριλαμβάνεται δωρεάν πλάνο. Χωρίς πιστωτική κάρτα. Άμεση πρόσβαση σε πάνω από 300.000 κάρτες σε 8 παιχνίδια.