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

가장 빠른
TCG 가격 API
개발자를 위한

Pokemon, Magic: The Gathering, 유희왕, Lorcana, 원피스 등 8개 게임의 실시간 카드 가격 API. 카드 30만 장 이상, 공식 SDK 5종, 무료 티어 포함.

무료 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로 검색하세요. 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

만들 수 있는 것

TCG 카드 가격 API는 취미 스크립트부터 프로덕션 트레이딩 앱까지 다양하게 활용됩니다.

💰

가격 비교 도구

TCGPlayer 시장 가격과 eBay 낙찰 가격을 나란히 표시합니다. 구매자는 최저가를 찾고, 판매자는 경쟁력 있는 가격을 설정할 수 있습니다.

📊

포트폴리오 추적기

컬렉터가 카드를 입력하고 시간에 따른 컬렉션 가치를 추적합니다. 가격 이력 endpoint로 손익을 차트로 확인할 수 있습니다.

🤖

Discord 봇

TCG Discord 서버에 슬래시 명령어를 추가하여 멤버가 채팅을 떠나지 않고 카드 가격을 조회할 수 있게 합니다. 8개 게임 모두를 지원하는 오픈소스 Discord 봇 스타터를 몇 분 만에 배포할 수 있습니다.

🔄

트레이딩 앱

실시간 가격 데이터로 매매·교환 인터페이스를 강화합니다. 공정 교환 가격 표시, 저평가 목록 감지, 덱 리스트 전체 일괄 가격 조회를 지원합니다.

🔔

가격 알림

특정 카드를 모니터링하다가 가격이 임계값을 넘으면 사용자에게 알림을 보냅니다. 예약 폴링 또는 유료 플랜의 Webhook 알림을 활용할 수 있습니다.

📈

분석 대시보드

가격 이력 차트, 세트 전체 트렌드 분석, 세트 시가총액 추정을 구축합니다. 가격 이력 endpoint는 월별 일일 스냅샷을 제공합니다.

모든 게임을 지원하는 TCG API

하나의 API 키로 8개 게임을 지원합니다. 포켓몬 TCG API, MTG API, 유희왕 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, 자체 스크레이퍼 비교입니다.

기능	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 시작 방법부터 rate limit, 등급 카드 가격까지.

TCG API란 무엇인가요?

TCG API(트레이딩 카드 게임 API)는 카드 데이터에 프로그래밍 방식으로 접근할 수 있는 웹 서비스입니다. 카드 상세 정보, 세트 정보, 실시간 시장 가격 등을 조회할 수 있습니다. 개발자들은 TCG API를 활용하여 가격 추적기, 포트폴리오 도구, Discord 봇 등을 구축합니다.

TCG Price Lookup API는 무료인가요?

네, TCG Price Lookup은 취미 프로젝트나 프로토타입을 위한 하루 200회 요청의 무료 플랜을 제공합니다(비상업적 이용). 유료 플랜에서는 높은 rate limit, 가격 이력 endpoint, eBay 가격, 등급 카드 가격, 상업적 이용 권한 등을 이용할 수 있습니다. 신용카드 없이 시작할 수 있습니다.

어떤 트레이딩 카드 게임을 지원하나요?

현재 8개 게임을 지원합니다: 포켓몬 TCG(영어판), 포켓몬 일본판, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece 카드게임, Star Wars: Unlimited, Flesh and Blood. 모든 게임에서 동일한 통합 검색 및 카드 endpoint를 사용할 수 있습니다.

포켓몬 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의 rate limit은 어떻게 되나요?

무료 플랜은 하루 최대 200회 요청(버스트: 1회/3초). 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 낙찰 목록은 매일 업데이트됩니다. 시간에 민감한 애플리케이션의 경우, 가격 이력 endpoint에서 트렌드를 추적할 수 있습니다.

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

자주 묻는 질문

TCG API란 무엇인가요?

TCG Price Lookup API는 무료인가요?

어떤 트레이딩 카드 게임을 지원하나요?

포켓몬 TCG API 키는 어떻게 발급받나요?

등급 카드 가격(PSA, BGS, CGC)도 지원하나요?

API의 rate limit은 어떻게 되나요?

어떤 SDK를 사용할 수 있나요?

카드 가격은 얼마나 자주 업데이트되나요?

TCG API로 오늘부터 개발을 시작하세요

가장 빠른
TCG 가격 API
개발자를 위한