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

最快的
TCG 價格 API
專為開發者打造

支援 Pokemon、Magic: The Gathering、遊戲王、Lorcana、航海王等 8 款遊戲的即時卡牌價格 API。超過 30 萬張卡牌、5 個官方 SDK、含免費方案。

取得免費 API 金鑰閱讀文件

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 個步驟，無需繁雜設定。

取得免費 API 金鑰

在 tcgpricelookup.com 註冊 — 無需信用卡。API 金鑰立即發放，可用於所有 8 款支援遊戲。免費方案提供每日 200 次請求，讓您立即開始開發。

API key: tpl_live_xxxxxxxxxxxx

→

安裝 SDK

選擇您偏好的程式語言。官方 SDK 支援 JavaScript、Python、Go、Rust 與 PHP。每個 SDK 均由 TCG Price Lookup 團隊維護，並附有完整型別定義。

$ npm install tcglookup

→

取得卡牌價格

透過卡牌名稱、系列或 ID 搜尋。單一 API 即可取得 TCGPlayer 與 eBay 即時價格、各狀態別價格、鑑定價格及價格歷史。

search GET /v1/search?q=charizard

card GET /v1/cards/:id

history GET /v1/cards/:id/prices

batch POST /v1/cards/batch

可以建構什麼

TCG 卡牌價格 API 廣泛應用於從興趣腳本到正式交易應用的各種場景。

💰

價格比較工具

並排顯示 TCGPlayer 市場價格與 eBay 成交價格。買家找到最低價，賣家設定具競爭力的售價。

📊

收藏組合追蹤器

讓收藏家輸入卡牌並隨時間追蹤收藏品的價值。使用價格歷史端點繪製損益圖表。

🤖

Discord 機器人

為 TCG Discord 伺服器新增斜線指令，讓成員無需離開聊天即可查詢卡牌價格。支援所有 8 款遊戲的開源 Discord 機器人入門套件可在數分鐘內部署。

🔄

交易應用程式

以即時價格數據強化買賣交換介面。顯示公平交易價值、偵測低估清單、批次取得整套牌組的價格。

🔔

價格提醒

監控特定卡牌，當價格超過門檻時通知使用者。可使用排程輪詢或付費方案的 Webhook 通知。

📈

分析儀表板

建構價格歷史圖表、系列整體趨勢分析及系列市值估算。價格歷史端點提供逐月的每日快照。

支援所有遊戲的 TCG API

單一 API 金鑰支援 8 款遊戲。寶可夢 TCG API、MTG API、遊戲王 API、Lorcana 及航海王等，全部整合於統一介面。

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 及自製爬蟲的比較。

功能	TCG Price Lookup	Scryfall API	pokemontcg.io	TCGPlayer API	自製爬蟲
支援遊戲數	8 款	僅 MTG	僅寶可夢	多款（不定）	自行決定
即時價格	✓	部分（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 →

閱讀 API 文件 →

常見問題

從 TCG Price Lookup API 入門到速率限制、鑑定卡牌價格的一切解答。

什麼是集換式卡牌 API？

集換式卡牌 API（TCG API）是一種提供程式化存取卡牌資料的網路服務。您可以取得卡牌詳情、系列資訊以及即時市場價格。開發者透過 TCG API 建構價格追蹤器、收藏管理工具、Discord 機器人等應用程式。

TCG Price Lookup API 是免費的嗎？

是的，TCG Price Lookup 提供每日 200 次請求的免費方案，適合興趣專案與原型開發（僅限非商業用途）。付費方案提供更高的速率限制、價格歷史端點、eBay 價格、鑑定卡牌價格以及商業使用權。無需信用卡即可開始使用。

支援哪些集換式卡牌遊戲？

目前支援 8 款遊戲：寶可夢 TCG（英文版）、寶可夢日本版、Magic: The Gathering、Yu-Gi-Oh!、Disney Lorcana、航海王卡牌遊戲、Star Wars: Unlimited、Flesh and Blood。所有遊戲使用相同的統一搜尋與卡牌端點。

如何取得寶可夢 TCG API 金鑰？

在 tcgpricelookup.com 註冊並驗證您的電子郵件地址後，API 金鑰將立即發放。無需等待審核，您可以立即開始對寶可夢 TCG API（及其他所有遊戲）發送請求。

是否支援鑑定卡牌價格（PSA、BGS、CGC）？

是的。您可以取得 PSA（1 至 10 分）、Beckett（BGS 7 至 10 分，包含 9.5 與 10 黑標）、CGC（1 至 10 分）的鑑定卡牌價格。鑑定價格來源於 eBay 銷售數據，需要 Trader 方案以上。

API 速率限制是多少？

免費方案每日最多 200 次請求（突發：每 3 秒 1 次）。Trader 方案（每月 $14.99 美元）每日 10,000 次請求（突發：每秒 1 次）。Business 方案（每月 $89.99 美元）每日 100,000 次請求（突發：每秒 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 成交清單每日更新。對於時效性最高的應用，您也可以使用價格歷史端點追蹤趨勢。

立即使用 TCG API 開始開發

含免費方案。無需信用卡。立即存取 8 款遊戲超過 30 萬張卡牌的資料。

取得免費 API 金鑰閱讀文件

最快的 TCG 價格 API專為開發者打造

TCG API 如何運作

取得免費 API 金鑰

安裝 SDK

取得卡牌價格

可以建構什麼

價格比較工具

收藏組合追蹤器

Discord 機器人

交易應用程式

價格提醒

分析儀表板

支援所有遊戲的 TCG API

Pokemon

Magic: The Gathering

Yu-Gi-Oh!

Disney Lorcana

One Piece

Pokemon Japan

Star Wars: Unlimited

Flesh and Blood

TCG API 比較

開發者生態系

官方 SDK — 6 種語言

CLI Tool

Go SDK

JavaScript / TypeScript SDK

PHP SDK

Python SDK

Rust SDK

工具與資源 — 5 項工具

Awesome TCG

Discord Bot

Next.js Starter

OpenAPI Specification

Postman Collection

常見問題

什麼是集換式卡牌 API？

TCG Price Lookup API 是免費的嗎？

支援哪些集換式卡牌遊戲？

如何取得寶可夢 TCG API 金鑰？

是否支援鑑定卡牌價格（PSA、BGS、CGC）？

API 速率限制是多少？

有哪些可用的 SDK？

卡牌價格多久更新一次？

立即使用 TCG API 開始開發

最快的
TCG 價格 API
專為開發者打造