$ curl https://api.tcgpricelookup.com/v1/search
TCG Price API
nhanh nhất
dành cho nhà phát triển
API giá thẻ bài thời gian thực cho Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece và 3 trò chơi khác. Hơn 300.000 thẻ, 5 SDK chính thức, gói miễn phí có sẵn.
// 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 valuesCách hoạt động của TCG API
Từ bắt đầu đến dữ liệu giá thẻ trong vòng 5 phút. 3 bước, không cần cấu hình.
Lấy API key miễn phí
Đăng ký tại tcgpricelookup.com — không cần thẻ tín dụng. API key được cấp ngay lập tức và hoạt động trên tất cả 8 trò chơi được hỗ trợ. Gói miễn phí cung cấp 200 yêu cầu/ngày để bắt đầu phát triển ngay.
Cài đặt SDK
Chọn ngôn ngữ bạn muốn. SDK chính thức có sẵn cho JavaScript, Python, Go, Rust và PHP. Mỗi SDK được duy trì bởi đội ngũ TCG Price Lookup với đầy đủ định nghĩa kiểu dữ liệu.
Lấy giá thẻ
Tìm kiếm theo tên thẻ, bộ bài hoặc ID. Nhận giá theo thời gian thực từ TCGPlayer và eBay, giá theo tình trạng, giá thẻ đã chấm điểm và lịch sử giá — tất cả trong một API.
Bạn có thể xây dựng gì
API giá thẻ bài sưu tập TCG được sử dụng cho mọi thứ từ script cá nhân đến ứng dụng giao dịch thương mại.
Công cụ so sánh giá
Hiển thị giá thị trường TCGPlayer và giá bán eBay song song. Người mua tìm giá thấp nhất, người bán đặt giá cạnh tranh.
Theo dõi danh mục đầu tư
Cho phép người sưu tập nhập thẻ và theo dõi giá trị bộ sưu tập theo thời gian. Sử dụng endpoint lịch sử giá để vẽ biểu đồ lãi/lỗ.
Bot Discord
Thêm lệnh slash vào máy chủ Discord TCG để thành viên có thể tra cứu giá thẻ mà không rời khỏi chat. Bot Discord mã nguồn mở hỗ trợ tất cả 8 trò chơi, có thể triển khai trong vài phút.
Ứng dụng giao dịch
Nâng cao giao diện mua/bán/trao đổi bằng dữ liệu giá thời gian thực. Hiển thị giá trao đổi công bằng, phát hiện danh sách giá thấp, lấy giá hàng loạt cho toàn bộ danh sách bộ bài.
Cảnh báo giá
Theo dõi các thẻ cụ thể và thông báo cho người dùng khi giá vượt ngưỡng. Sử dụng polling theo lịch hoặc thông báo webhook với gói trả phí.
Bảng điều khiển phân tích
Xây dựng biểu đồ lịch sử giá, phân tích xu hướng toàn bộ bộ bài và ước tính vốn hóa thị trường của bộ bài. Endpoint lịch sử giá cung cấp ảnh chụp hàng ngày theo tháng.
TCG API cho mọi trò chơi
Một API key cho 8 trò chơi. Pokémon TCG API, MTG API, Yu-Gi-Oh! API, Lorcana, One Piece và nhiều hơn nữa — tất cả trong một giao diện thống nhất.
Pokemon
30,000+ cardsAccess 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.
Xem tài liệu API Pokemon →const results = await tcg.search('charizard', { game: 'pokemon' });
// Returns: prices for all Charizard cards across all setsMagic: The Gathering
100,000+ cardsAccess 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.
Xem tài liệu API Magic: The Gathering →const results = await tcg.search('black lotus', { game: 'mtg' });
// Returns: prices for Black Lotus across all editionsYu-Gi-Oh!
40,000+ cardsAccess real-time pricing for over 40,000 Yu-Gi-Oh! cards. Coverage spans all sets and rarities with per-condition and graded card values.
Xem tài liệu API Yu-Gi-Oh! →const results = await tcg.search('blue-eyes white dragon', { game: 'yugioh' });
// Returns: prices for Blue-Eyes White Dragon across all setsDisney Lorcana
3,000+ cardsAccess real-time pricing for over 3,000 Disney Lorcana cards. Full coverage since launch with per-condition pricing and graded values.
Xem tài liệu API Disney Lorcana →const results = await tcg.search('elsa', { game: 'lorcana' });
// Returns: prices for all Elsa cardsOne Piece
6,000+ cardsAccess real-time pricing for over 6,000 One Piece TCG cards. Complete set coverage with per-condition pricing and graded values.
Xem tài liệu API One Piece →const results = await tcg.search('luffy', { game: 'onepiece' });
// Returns: prices for all Luffy cardsPokemon Japan
20,000+ cardsAccess real-time pricing for over 20,000 Japanese Pokemon TCG cards. Covers Japanese-exclusive sets, promos, and special releases.
Xem tài liệu API Pokemon Japan →const results = await tcg.search('pikachu', { game: 'pokemonjp' });
// Returns: prices for Japanese Pikachu cardsStar Wars: Unlimited
2,500+ cardsAccess real-time pricing for over 2,500 Star Wars: Unlimited cards. Full coverage with per-condition pricing and graded values.
Xem tài liệu API Star Wars: Unlimited →const results = await tcg.search('darth vader', { game: 'swu' });
// Returns: prices for all Darth Vader cardsFlesh and Blood
8,000+ cardsAccess real-time pricing for over 8,000 Flesh and Blood cards. Complete coverage with per-condition pricing and graded values.
Xem tài liệu API Flesh and Blood →const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cardsSo sánh TCG API
So sánh TCG Price Lookup với Scryfall, pokemontcg.io, TCGPlayer API và tự viết scraper.
| Tính năng | TCG Price Lookup | Scryfall API | pokemontcg.io | TCGPlayer API | Tự viết scraper |
|---|---|---|---|---|---|
| Số trò chơi hỗ trợ | 8 trò chơi | Chỉ MTG | Chỉ Pokémon | Nhiều (thay đổi) | Tùy ý |
| Giá theo thời gian thực | ✓ | Một phần (TCGP) | ✗ | ✓ (chỉ TCGP) | Tùy trường hợp |
| Giá theo tình trạng | ✓ | ✗ | ✗ | ✓ | Thủ công |
| Giá thẻ đã chấm điểm (PSA/BGS/CGC) | ✓ | ✗ | ✗ | ✗ | Thủ công |
| SDK chính thức | 5 ngôn ngữ | Cộng đồng | 1 (JS) | ✗ | ✗ |
| Gói miễn phí | ✓ 200 yêu cầu/ngày | Không có dữ liệu giá | Không có dữ liệu giá | Cần đăng ký | ✓ (tự chi phí) |
| Lịch sử giá | ✓ | ✗ | ✗ | Hạn chế | Tự xây dựng |
Hệ sinh thái nhà phát triển
Ngoài REST API, còn có 5 SDK chính thức cho các ngôn ngữ phổ biến, công cụ sẵn dùng và tài liệu nhà phát triển toàn diện.
SDK chính thức — 6 ngôn ngữ
CLI Tool
GitHub →Live trading card prices in your terminal. Search, lookup, price history, JSON output for scripting. Also installable via npm.
- ✓ 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.
- ✓ 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.
- ✓ 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.
- ✓ 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.
- ✓ 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.
- ✓ Async with reqwest + tokio
- ✓ Typed Error enum
- ✓ Builder pattern
Công cụ & Tài nguyên — 5 công cụ
Awesome TCG
listCurated 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
botSelf-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
starterOne-click deployable Next.js 16 starter for the TCG Price Lookup API. Search live trading card prices across 8 games out of the box.
OpenAPI Specification
specOpenAPI 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
collectionReady-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 →Câu hỏi thường gặp
Từ cách bắt đầu với TCG Price Lookup API đến giới hạn tốc độ và giá thẻ đã chấm điểm.
TCG API là gì?
+
TCG API (Trading Card Game API) là dịch vụ web cung cấp quyền truy cập lập trình vào dữ liệu thẻ bài. Bạn có thể lấy thông tin chi tiết về thẻ, thông tin bộ bài và giá thị trường theo thời gian thực. Các nhà phát triển sử dụng TCG API để xây dựng công cụ theo dõi giá, ứng dụng quản lý bộ sưu tập, bot Discord và nhiều hơn nữa.
TCG Price Lookup API có miễn phí không?
+
Có, TCG Price Lookup cung cấp gói miễn phí với 200 yêu cầu mỗi ngày cho các dự án cá nhân và nguyên mẫu (phi thương mại). Các gói trả phí cung cấp giới hạn tốc độ cao hơn, endpoint lịch sử giá, giá eBay, giá thẻ đã được chấm điểm và quyền sử dụng thương mại. Không cần thẻ tín dụng để bắt đầu.
Những trò chơi thẻ bài sưu tập nào được hỗ trợ?
+
Hiện tại hỗ trợ 8 trò chơi: Pokémon TCG (tiếng Anh), Pokémon Nhật Bản, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited và Flesh and Blood. Tất cả các trò chơi đều dùng cùng một endpoint tìm kiếm và endpoint thẻ thống nhất.
Làm thế nào để lấy API key Pokémon TCG?
+
Đăng ký tại tcgpricelookup.com và xác nhận địa chỉ email của bạn — API key sẽ được cấp ngay lập tức. Không có quy trình phê duyệt, bạn có thể bắt đầu gửi yêu cầu đến Pokémon TCG API (và tất cả các trò chơi khác) ngay lập tức.
Giá thẻ đã được chấm điểm (PSA, BGS, CGC) có được hỗ trợ không?
+
Có. Bạn có thể lấy giá thẻ đã được chấm điểm PSA (lớp 1–10), Beckett (BGS 7–10, 9.5, Black Label 10) và CGC (lớp 1–10). Giá thẻ đã chấm điểm được lấy từ dữ liệu bán hàng eBay. Yêu cầu gói Trader trở lên.
Giới hạn tốc độ API là bao nhiêu?
+
Gói miễn phí: tối đa 200 yêu cầu/ngày (burst: 1 yêu cầu/3 giây). Gói Trader ($14,99/tháng): 10.000 yêu cầu/ngày (burst: 1 yêu cầu/giây). Gói Business ($89,99/tháng): 100.000 yêu cầu/ngày (burst: 3 yêu cầu/giây). Giới hạn ngày đặt lại vào lúc nửa đêm UTC.
Những SDK nào có sẵn?
+
Có 5 SDK chính thức: 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). Ngoài ra còn có công cụ CLI để truy cập từ terminal.
Giá thẻ được cập nhật bao lâu một lần?
+
Giá thẻ được cập nhật liên tục. Giá thị trường TCGPlayer được cập nhật nhiều lần mỗi ngày khi có dữ liệu bán hàng mới. Danh sách eBay đã bán được cập nhật hàng ngày. Đối với các ứng dụng nhạy cảm với thời gian nhất, endpoint lịch sử giá cho phép bạn theo dõi xu hướng theo thời gian.
Bắt đầu phát triển với TCG API ngay hôm nay
Bao gồm gói miễn phí. Không cần thẻ tín dụng. Truy cập ngay hơn 300.000 thẻ trong 8 trò chơi.