API Endpoint
TCG Price Lookup API의 검색, 카드 상세, 가격 이력, 세트, 게임, 일괄 검색 endpoint의 전체 레퍼런스.
베이스 URL
https://api.tcgpricelookup.com/v1
카드 검색
이름으로 모든 게임의 카드를 검색합니다.
GET /v1/search
쿼리 파라미터:
| 파라미터 | 필수 | 설명 |
|---|---|---|
q | 예 | 검색 쿼리(카드 이름) |
game | 아니요 | 게임 슬러그(예: pokemon, mtg, yugioh) |
set | 아니요 | 세트 이름 또는 세트 코드로 필터링 |
rarity | 아니요 | 레어리티로 필터링 |
limit | 아니요 | 결과 수(기본값: 20, 최대: 100) |
offset | 아니요 | 페이지네이션용 오프셋 |
예시:
curl "https://api.tcgpricelookup.com/v1/search?q=charizard&game=pokemon" \
-H "X-API-Key: your-api-key"
카드 상세
ID로 카드의 상세 가격 데이터를 가져옵니다.
GET /v1/cards/:id
예시:
curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
-H "X-API-Key: your-api-key"
가격 이력
카드의 가격 이력을 가져옵니다(Trader 플랜 이상).
GET /v1/cards/:id/prices
쿼리 파라미터:
| 파라미터 | 기본값 | 설명 |
|---|---|---|
days | 30 | 이력 일수(최대: 90) |
세트 목록
특정 게임의 모든 세트를 나열합니다.
GET /v1/sets?game=pokemon
일괄 검색
1회 요청으로 최대 20장의 카드를 가져옵니다(Trader 플랜 이상).
POST /v1/cards/batch
요청 본문:
{
"ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}
지원 게임 슬러그
| 게임 | 슬러그 |
|---|---|
| 포켓몬 TCG(영어) | pokemon |
| 포켓몬(일본어) | pokemonjp |
| Magic: The Gathering | mtg |
| 유희왕 | yugioh |
| Disney Lorcana | lorcana |
| 원피스 카드게임 | onepiece |
| Star Wars: Unlimited | swu |
| Flesh and Blood | fab |