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

Nhận khóa API miễn phí Đọc tài liệu

300,000+ Thẻ bài

8 Trò chơi

5 SDK

2 Thị trường

Free Gói miễn phí

24/7 Cập nhật

Bắt đầu nhanh 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

Cá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.

API key: tpl_live_xxxxxxxxxxxx

→

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.

$ npm install tcglookup

→

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.

search GET /v1/search?q=charizard

card GET /v1/cards/:id

history GET /v1/cards/:id/prices

batch POST /v1/cards/batch

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

Xem tài liệu 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.

Xem tài liệu 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.

Xem tài liệu 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.

Xem tài liệu 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.

Xem tài liệu 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.

Xem tài liệu 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.

Xem tài liệu 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.

Xem tài liệu API Flesh and Blood →

Flesh and Blood API example JavaScript

const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cards

Xem tất cả trò chơi được hỗ trợ →

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

$ 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

Công cụ & Tài nguyên — 5 công cụ

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 →

Đọc tài liệu API →

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.

Nhận khóa API miễn phí Đọc tài liệu

TCG Price API nhanh nhấtdành cho nhà phát triển

Cách hoạt động của TCG API

Lấy API key miễn phí

Cài đặt SDK

Lấy giá thẻ

Bạn có thể xây dựng gì

Công cụ so sánh giá

Theo dõi danh mục đầu tư

Bot Discord

Ứng dụng giao dịch

Cảnh báo giá

Bảng điều khiển phân tích

TCG API cho mọi trò chơi

Pokemon

Magic: The Gathering

Yu-Gi-Oh!

Disney Lorcana

One Piece

Pokemon Japan

Star Wars: Unlimited

Flesh and Blood

So sánh TCG API

Hệ sinh thái nhà phát triển

SDK chính thức — 6 ngôn ngữ

CLI Tool

Go SDK

JavaScript / TypeScript SDK

PHP SDK

Python SDK

Rust SDK

Công cụ & Tài nguyên — 5 công cụ

Awesome TCG

Discord Bot

Next.js Starter

OpenAPI Specification

Postman Collection

Câu hỏi thường gặp

TCG API là gì?

TCG Price Lookup API có miễn phí không?

Những trò chơi thẻ bài sưu tập nào được hỗ trợ?

Làm thế nào để lấy API key Pokémon TCG?

Giá thẻ đã được chấm điểm (PSA, BGS, CGC) có được hỗ trợ không?

Giới hạn tốc độ API là bao nhiêu?

Những SDK nào có sẵn?

Giá thẻ được cập nhật bao lâu một lần?

Bắt đầu phát triển với TCG API ngay hôm nay

TCG Price API
nhanh nhất
dành cho nhà phát triển