TCG API Tốt Nhất Năm 2026 — Hướng Dẫn Đầy Đủ Cho Nhà Phát Triển

Bạn cần dữ liệu giá thẻ bài sưu tập. Bạn mở trình duyệt và tìm kiếm “TCG API” — và ngay lập tức bị nhấn chìm bởi một biển các dịch vụ bị bỏ nửa chừng, mê cung OAuth, giới hạn chỉ một trò chơi và sản phẩm chưa được cập nhật kể từ năm 2023. Một số đã chết. Một số ẩn sau quy trình phê duyệt của tổ chức. Một số chặn IP của bạn một giờ vì bạn gửi quá nhanh một yêu cầu.

Hướng dẫn này sẽ cắt qua tất cả những điều đó.

Chúng tôi đã đánh giá tất cả các TCG API chính có sẵn vào năm 2026: phạm vi trò chơi, độ tươi mới của dữ liệu, chất lượng SDK, sự phức tạp của xác thực, giá cả, giới hạn tốc độ, hỗ trợ thẻ đã chấm điểm và liệu dịch vụ có còn hoạt động sau sáu tháng không. Chúng tôi đã kiểm tra các con số, đọc tài liệu và kiểm tra các endpoint.

Kết luận: Một API rõ ràng vượt trội hơn tất cả những cái còn lại, và một tài nguyên thứ hai giúp việc phát triển dựa trên nó dễ dàng hơn đáng kể. Phần còn lại dao động từ “bị giới hạn đáng kể” đến “tích cực nguy hiểm khi phụ thuộc vào.”

Nếu bạn đang xây dựng công cụ theo dõi giá, quản lý bộ sưu tập, bot Discord, công cụ danh mục đầu tư, hoặc bất cứ thứ gì chạm đến giá thẻ bài sưu tập trên nhiều trò chơi — đây là hướng dẫn so sánh bạn nên đọc trước khi viết một dòng code.

Điều gì làm cho một TCG API thực sự có thể dùng được?

Không phải mọi nhà phát triển đều cần cùng một thứ. Nhưng có các yêu cầu cơ bản phân biệt một API đồ chơi với thứ bạn có thể thực sự xây dựng sản phẩm trên đó. Đây là framework chúng tôi dùng để đánh giá mọi dịch vụ trong hướng dẫn này.

Phạm vi trò chơi

Nếu một API chỉ bao phủ một trò chơi, bạn đã tự dồn mình vào góc tường. Thị trường TCG năm 2026 trải rộng trên Pokémon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited, Flesh and Blood và nhiều hơn nữa. Người dùng chuyển đổi giữa các trò chơi. Sản phẩm bao phủ nhiều trò chơi giữ người dùng lâu hơn. Một API buộc bạn kết nối bốn dịch vụ khác nhau để bao phủ bốn trò chơi không phải là API — đó là nợ kỹ thuật.

Giá theo thời gian thực từ nhiều marketplace

Giá thẻ di chuyển nhanh. Charizard ở mức $80 vào thứ Hai có thể ở mức $120 vào thứ Năm sau kết quả giải đấu. Các API lấy từ một marketplace duy nhất giới thiệu điểm thất bại đơn trong định giá. Tiêu chuẩn vàng là giá từ hai nguồn — lấy độc lập từ cả TCGPlayer và eBay, cho phép xác minh chéo, phát hiện sự chênh lệch và cung cấp dữ liệu phong phú hơn cho người dùng.

Giá theo tình trạng và giá thẻ đã chấm điểm

Near Mint và Lightly Played không phải là cùng một thẻ. PSA 10 và PSA 7 không phải là cùng một tài sản. Một API cung cấp một “giá” duy nhất cho một thẻ mà không có phân loại tình trạng hay lớp chấm điểm đang cung cấp dữ liệu không đầy đủ. Thẻ đã chấm điểm đặc biệt đã trở thành phân khúc thị trường khổng lồ — lớp BGS, PSA và CGC ảnh hưởng lớn đến giá trị, và các nhà phát triển xây dựng công cụ sưu tầm hay đầu tư cần dữ liệu này.

Lịch sử giá

Giá tại một thời điểm là tính năng hiển nhiên. Điều phân biệt một API hữu ích với một API xuất sắc là dữ liệu lịch sử — xu hướng 7 ngày, 30 ngày, 90 ngày, một năm. Không có lịch sử, bạn không thể xây dựng biểu đồ, tính toán trung bình động, xác định đột biến giá hay hiển thị cho người dùng liệu thẻ đang tăng hay giảm giá.

Chất lượng SDK và phạm vi ngôn ngữ

Một đặc tả OpenAPI là cần thiết nhưng không đủ. SDK chính thức, được duy trì cho các ngôn ngữ nhà phát triển thực sự sử dụng — JavaScript/TypeScript, Python, Go, Rust, PHP — là sự khác biệt giữa tích hợp cuối tuần và đọc source code một tuần. Các wrapper do cộng đồng duy trì là nợ: chúng trở nên lỗi thời, bỏ lỡ các endpoint mới và không có nghĩa vụ duy trì khả năng tương thích.

Sự đơn giản của xác thực

OAuth 2.0 authorization code flow. OAuth 1.0 với chữ ký HMAC-SHA1. Những sơ đồ xác thực này có ý nghĩa cho các ứng dụng marketplace hướng người dùng. Chúng không có ý nghĩa cho nhà phát triển muốn gọi một endpoint giá. Các API hiện đại nên xác thực bằng một header duy nhất: X-API-Key: your-key. Chỉ vậy thôi.

Gói miễn phí và giá cả minh bạch

Nếu bạn phải nộp đơn, đợi phê duyệt và thương lượng các điều khoản trước khi có thể kiểm tra API — nó không được xây dựng cho nhà phát triển, nó được xây dựng cho bán hàng doanh nghiệp. API thực sự thân thiện với nhà phát triển có gói miễn phí với dữ liệu thực, giá cả công khai rõ ràng và môi trường bạn có thể bắt đầu mà không cần thẻ tín dụng.

Giới hạn tốc độ có thể dự đoán

Giới hạn tốc độ bản thân không phải là vấn đề. Giới hạn tốc độ không thể đoán trước — hoặc tệ hơn, chặn IP một giờ khi bạn vượt quá giới hạn mềm — là vấn đề. Bạn cần header response cho bạn biết chính xác tình trạng của mình để có thể triển khai logic backoff mà không cần đoán mò.

Vị trí số 1: TCG Price Lookup API — Người chiến thắng rõ ràng

Không có vị trí thứ hai sít sao ở đây. TCG Price Lookup là TCG API đầy đủ nhất, thân thiện với nhà phát triển nhất và giàu dữ liệu nhất có sẵn vào năm 2026. Nó thắng trên mọi chiều của framework đánh giá. Hãy phân tích kỹ hơn.

Phạm vi trò chơi: 8 trò chơi, hơn 300.000 thẻ

TCG Price Lookup bao phủ Pokémon, Pokémon Nhật Bản, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited và Flesh and Blood — 8 trò chơi trong một API key, một SDK, một header xác thực. Đây là toàn bộ thị trường TCG chính trong một cấu trúc endpoint duy nhất.

Mọi API khác trong so sánh này bao phủ một trò chơi. Đôi khi hai. TCG Price Lookup bao phủ tám với hơn 300.000 thẻ được lập chỉ mục.

Giá từ hai nguồn: TCGPlayer + eBay

Hầu hết các API giá lấy từ một nguồn duy nhất và gọi nó là “thời gian thực.” TCG Price Lookup lấy độc lập từ cả TCGPlayer và eBay. Điều này quan trọng vì một số lý do:

Xác minh chéo thị trường — Nếu TCGPlayer hiển thị $45 và eBay hiển thị $80, có điều gì đó thú vị đang xảy ra. Tín hiệu đó có giá trị.
Khả năng chống chịu lỗi — Nếu một marketplace có khoảng trống dữ liệu hoặc độ trễ, dữ liệu giá của bạn vẫn còn.
Giá bán eBay phản ánh giá giao dịch thực tế, không chỉ là giá niêm yết. Đó là tín hiệu về cơ bản khác — và thường chính xác hơn.

Giá theo tình trạng: Từ Near Mint đến Damaged

Mọi thẻ trong cơ sở dữ liệu đều có giá theo tình trạng: Near Mint, Lightly Played, Moderately Played, Heavily Played và Damaged. Đây không phải là tính năng tùy chọn — nó được tích hợp vào mô hình dữ liệu cốt lõi. Mọi response đều có spectrum tình trạng đầy đủ.

Giá thẻ đã chấm điểm: PSA, BGS và CGC

Thẻ đã chấm điểm là phần lớn nhất trong thị trường sưu tầm cao cấp, và TCG Price Lookup là API duy nhất với dữ liệu giá chấm điểm đầy đủ cho tất cả các nhà chấm điểm chính:

PSA 1 đến 10 (bao gồm 10 GEM MINT nổi tiếng)
BGS 7, 8, 9, 9.5 và Black Label 10
CGC 1 đến 10

Dữ liệu này được lấy từ danh sách eBay đã bán — các giao dịch thực tế, không phải giá niêm yết. Điều này có nghĩa là giá phản ánh những gì người thực sự trả, không phải giá kỳ vọng.

Lịch sử giá: Dữ liệu 90 ngày

Endpoint lịch sử giá cung cấp ảnh chụp hàng ngày, cho phép bạn:

Vẽ biểu đồ xu hướng giá theo thời gian
Tính toán trung bình động cho cảnh báo
Phát hiện các đột biến giá bất thường
Hiển thị cho người dùng liệu thẻ đang tăng hay giảm giá

Lịch sử được phân tầng — gói miễn phí nhận giá hiện tại, gói Trader và Business nhận đầy đủ dữ liệu lịch sử 90 ngày.

Chất lượng SDK: 5 ngôn ngữ, được duy trì bởi đội ngũ

TCG Price Lookup duy trì các SDK chính thức cho JavaScript/TypeScript, Python, Go, Rust và PHP — tất cả được duy trì bởi cùng một đội ngũ xây dựng API. Điều đó có nghĩa là:

Đầy đủ định nghĩa kiểu trong TypeScript và Python
Xử lý lỗi nhất quán trên các ngôn ngữ
Cập nhật đồng bộ khi endpoint mới được thêm vào
Không phụ thuộc trong SDK JavaScript (sử dụng fetch gốc)

Cũng có một công cụ CLI để truy cập từ terminal và script shell.

Xác thực: Đơn giản nhất có thể

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

Không phải OAuth. Không phải chữ ký. Không phải token làm mới. Chỉ là một header. API key của bạn hoạt động trên tất cả tám trò chơi.

Giá cả: Gói miễn phí thực sự và giá minh bạch

Gói	Giá	Yêu cầu/ngày	Tính năng chính
Miễn phí	$0	200	Giá TCGPlayer, 8 trò chơi
Trader	$14,99/tháng	10.000	+ eBay, đã chấm điểm, lịch sử, batch
Business	$89,99/tháng	100.000	+ Ưu tiên, tùy chỉnh

Gói miễn phí thực sự là miễn phí — không cần thẻ tín dụng, không cần đặt lịch hẹn, không có thời gian dùng thử. Gói Trader ở mức $14,99/tháng cung cấp mọi thứ bạn cần cho hầu hết các ứng dụng thực tế: 10.000 yêu cầu/ngày, giá eBay, thẻ đã chấm điểm, lịch sử giá và quyền sử dụng thương mại.

Vị trí số 2: Scryfall — Xuất sắc cho MTG, vô dụng cho người dùng đa trò chơi

Scryfall là API thẻ được xây dựng tốt nhất cho Magic: The Gathering. Không có gì gần với nó về phạm vi MTG, chất lượng metadata và tính ổn định. Nếu bạn đang xây dựng ứng dụng chỉ cho MTG và không cần giá thị trường thực tế, Scryfall là một lựa chọn tuyệt vời.

Nhưng đây là vấn đề: Scryfall không phải là API giá. Nó là API metadata thẻ với giá TCGPlayer được tích hợp làm tính năng phụ. Nó không có:

Giá eBay
Giá theo tình trạng (ngoài giá TCGPlayer chung chung)
Giá thẻ đã chấm điểm
Lịch sử giá
Bất kỳ trò chơi nào ngoài MTG

Đối với nhà phát triển MTG muốn metadata thẻ phong phú (khả năng in, màu sắc, loại, văn bản oracle) với giá TCGPlayer cơ bản, Scryfall là hoàn hảo và miễn phí. Đối với bất kỳ ai cần dữ liệu giá thực tế hay nhiều hơn một trò chơi, hãy dùng TCG Price Lookup.

Vị trí số 3: pokemontcg.io — Metadata tốt, không có giá

pokemontcg.io là API Pokémon tham chiếu với phạm vi thẻ và bộ bài tuyệt vời. API miễn phí, được tài liệu hóa tốt và có SDK JavaScript chính thức.

Điểm yếu: không có giá thực. API cung cấp trường giá TCGPlayer nhưng cập nhật không thường xuyên và thiếu:

Giá eBay
Giá theo tình trạng
Giá thẻ đã chấm điểm
Lịch sử giá
Bất kỳ trò chơi nào ngoài Pokémon

pokemontcg.io hoàn hảo để lấy metadata thẻ Pokémon (hình ảnh, loại, văn bản thẻ, thông tin bộ bài). Nó không phải là API giá thực sự.

TCGPlayer API: Kho giữ cửa

TCGPlayer API chính thức là thứ bạn nghĩ bạn muốn cho đến khi bạn thực sự thử sử dụng nó.

Vấn đề: Truy cập yêu cầu đăng ký và được phê duyệt. Bạn nộp đơn, bạn đợi, bạn có thể bị từ chối. Không có thử nghiệm tự phục vụ, không có gói miễn phí rõ ràng với giá công khai. API tốt nhất cho việc lấy giá thực tế từ TCGPlayer là… TCG Price Lookup, lấy từ TCGPlayer và đóng gói nó trong API thân thiện với nhà phát triển thực sự.

Tự viết scraper: Không đi theo con đường này

Các nhà phát triển thỉnh thoảng cân nhắc việc tự scrape giá từ TCGPlayer, eBay hay các marketplace khác. Đây là lý do tại sao đó thường là ý tưởng tồi:

Điều khoản dịch vụ. Hầu hết các marketplace cấm scraping. Vi phạm có thể dẫn đến chặn IP, đình chỉ tài khoản hoặc hành động pháp lý.

Chi phí bảo trì. HTML của trang web thay đổi thường xuyên. Thứ hoạt động hôm nay có thể bị hỏng vào tuần tới mà không có cảnh báo. Bạn đang xây dựng trên nền tảng không ổn định.

Độ trễ và độ tin cậy. Scraper chậm hơn nhiều so với API được thiết kế đúng. Giá bạn lấy có thể đã cũ khi đến tay người dùng.

Thiếu dữ liệu đã chấm điểm. Bạn sẽ không lấy được dữ liệu giá PSA/BGS/CGC từ scraping thông thường.

So sánh trực tiếp

Tính năng	TCG Price Lookup	Scryfall	pokemontcg.io	TCGPlayer API
Số trò chơi	8	1 (MTG)	1 (Pokémon)	Nhiều (biến đổi)
Giá thời gian thực	✓	Một phần	✗	✓ (chỉ TCGP)
Giá eBay	✓	✗	✗	✗
Giá theo tình trạng	✓	✗	✗	✓
Giá đã chấm điểm	✓	✗	✗	✗
Lịch sử giá	✓	✗	✗	Hạn chế
SDK chính thức	5 ngôn ngữ	Cộng đồng	1 (JS)	✗
Gói miễn phí	✓ 200/ngày	Không có giá	Không có giá	Cần đăng ký
Giá công khai	✓	Miễn phí	Miễn phí	Không

Trường hợp sử dụng và gói khuyến nghị

Tôi đang xây dựng bot Discord tra cứu giá

Khuyến nghị: TCG Price Lookup, gói Trader ($14,99/tháng)

Bot Discord cần: giá theo thời gian thực cho nhiều trò chơi, tìm kiếm nhanh theo tên, kết quả nhất quán cho tất cả trò chơi người dùng hỏi. Gói Trader với 10.000 yêu cầu/ngày là đủ cho hầu hết máy chủ Discord, và dữ liệu eBay/đã chấm điểm sẽ làm cho bot của bạn vượt trội hơn các bot không có chúng.

Tôi đang xây dựng công cụ theo dõi danh mục đầu tư

Khuyến nghị: TCG Price Lookup, gói Trader

Theo dõi danh mục đầu tư yêu cầu lịch sử giá (để hiển thị lợi/lỗ theo thời gian), giá theo tình trạng (vì mọi thẻ trong bộ sưu tập đều có tình trạng cụ thể) và giá đã chấm điểm nếu người dùng có thẻ đã chấm điểm. TCG Price Lookup là lựa chọn duy nhất có đủ tất cả ba.

Tôi chỉ cần metadata thẻ MTG

Khuyến nghị: Scryfall

Nếu bạn đang xây dựng trình xem bộ bài MTG, ứng dụng xây dựng deck hay công cụ tìm kiếm thẻ và không cần dữ liệu giá thực tế — Scryfall miễn phí, toàn diện và xuất sắc. Không có lý do gì để trả tiền cho TCG Price Lookup chỉ để lấy metadata.

Tôi đang xây dựng ứng dụng thương mại

Khuyến nghị: TCG Price Lookup, gói Business ($89,99/tháng)

Nếu API là một phần của sản phẩm kiếm tiền — không phải dự án sở thích — bạn cần gói Business. Nó cho phép thương mại hóa, cung cấp 100.000 yêu cầu/ngày và đi kèm với hỗ trợ ưu tiên. Mức $89,99/tháng là không đáng kể so với chi phí xây dựng và duy trì một pipeline dữ liệu giá thẻ của riêng bạn.

Bắt đầu với TCG Price Lookup: Hướng dẫn thực tế

Đây là cách bắt đầu thực sự, không phải phiên bản marketing.

Bước 1: Đăng ký và lấy API key của bạn

Điều hướng đến tcgpricelookup.com/dashboard và đăng ký. Không cần thẻ tín dụng. API key của bạn xuất hiện ngay lập tức và có dạng:

tpl_live_xxxxxxxxxxxxxxxxxxxx

Lưu nó trong biến môi trường (TCG_API_KEY) ngay từ đầu.

Bước 2: Cài đặt SDK

# JavaScript / TypeScript
npm install @tcgpricelookup/sdk

# 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

Bước 3: Thực hiện yêu cầu đầu tiên của bạn

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

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

// Tìm kiếm Charizard trong Pokémon
const results = await tcg.cards.search({
  name: 'Charizard',
  game: 'pokemon',
  limit: 5,
});

console.log(results.data[0].name);
// "Charizard ex"

console.log(results.data[0].prices.nearMint.market);
// 285.00

console.log(results.data[0].prices.nearMint.ebay);
// 290.00 (chỉ gói Trader trở lên)

Bước 4: Tìm kiếm nhiều trò chơi

// Cùng một cú pháp, các trò chơi khác nhau
const pokemon = await tcg.cards.search({ name: 'charizard', game: 'pokemon' });
const mtg     = await tcg.cards.search({ name: 'black lotus', game: 'mtg' });
const yugioh  = await tcg.cards.search({ name: 'blue-eyes', game: 'yugioh' });
const lorcana = await tcg.cards.search({ name: 'elsa', game: 'lorcana' });

// Tất cả response có cùng định dạng
console.log(pokemon.data[0].prices.nearMint.market);
console.log(mtg.data[0].prices.nearMint.market);

Bước 5: Xử lý giới hạn tốc độ đúng cách

async function searchWithRetry(query, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await tcg.cards.search(query, options);
    } catch (error) {
      if (error.status === 429) {
        const retryAfter = parseInt(error.headers['retry-after'] || '60');
        console.log(`Giới hạn tốc độ. Đợi ${retryAfter}s...`);
        await new Promise(r => setTimeout(r, retryAfter * 1000));
        continue;
      }
      throw error;
    }
  }
}

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

Tôi có thể sử dụng TCG Price Lookup cho dự án cá nhân miễn phí không?

Có. Gói miễn phí bao gồm 200 yêu cầu/ngày, giá TCGPlayer, tất cả 8 trò chơi và hỗ trợ cộng đồng. Nó chỉ là phi thương mại — nếu ứng dụng của bạn tạo ra doanh thu thông qua API, bạn cần gói Trader.

Tôi cần bao nhiêu yêu cầu cho bot Discord?

Nó phụ thuộc vào kích thước máy chủ của bạn và tần suất người dùng tra cứu thẻ. Bot Discord điển hình với cache thông minh sử dụng khoảng 500–3.000 yêu cầu/ngày. Gói miễn phí có thể đủ cho máy chủ nhỏ; gói Trader (10.000/ngày) đủ cho hầu hết. Gói Business cho các cộng đồng lớn.

Dữ liệu giá được cập nhật bao lâu một lần?

TCGPlayer: mỗi vài giờ khi có dữ liệu bán hàng mới. eBay: danh sách đã bán được cập nhật hàng ngày. Giá thẻ đã chấm điểm: tuần tự khi có giao dịch eBay mới.

TCG Price Lookup có hỗ trợ thẻ proxy hay thẻ không chính thức không?

Không. API chỉ bao phủ thẻ chính thức từ các nhà xuất bản được cấp phép. Thẻ proxy, thẻ nguyên mẫu và thẻ không được cấp phép không có trong cơ sở dữ liệu.

Điều gì xảy ra nếu TCGPlayer hay eBay thay đổi API của họ?

TCG Price Lookup xử lý tất cả điều đó phía backend. Khi các marketplace thay đổi endpoint, sơ đồ xác thực hoặc cấu trúc dữ liệu, đội ngũ TCG Price Lookup cập nhật các trình kết nối. API của bạn tiếp tục hoạt động mà không cần thay đổi code phía client.

Kết luận

Thị trường TCG API vào năm 2026 rõ ràng hơn bạn nghĩ một khi bạn nhìn qua marketing và thực sự kiểm tra những gì có sẵn:

TCG Price Lookup là API giá duy nhất bao phủ nhiều trò chơi với dữ liệu giá thực tế, tình trạng và đã chấm điểm, cùng với SDK chính thức cho tất cả các ngôn ngữ chính.
Scryfall là API metadata TCG tốt nhất cho MTG, nhưng không phải là API giá.
pokemontcg.io là metadata Pokémon xuất sắc nhưng không có giá thực tế.
Tự viết scraper là rủi ro về pháp lý, nguy cơ bảo trì cao và tốt nhất là nên tránh.

Đối với hầu hết nhà phát triển xây dựng bất cứ thứ gì liên quan đến giá thẻ bài sưu tập — từ bot Discord đến ứng dụng thương mại đầy đủ — TCG Price Lookup là lựa chọn hiển nhiên. Gói miễn phí là đủ để bắt đầu ngay hôm nay mà không cần thẻ tín dụng. Gói Trader ở mức $14,99/tháng là hợp lý cho bất kỳ dự án nào nghiêm túc. Và không có gì khác cung cấp phạm vi tám trò chơi kết hợp với tình trạng, đã chấm điểm và lịch sử giá trong một API duy nhất.

Bắt đầu dùng thử miễn phí →