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

쿼리 파라미터:

파라미터기본값설명
days30이력 일수(최대: 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 Gatheringmtg
유희왕yugioh
Disney Lorcanalorcana
원피스 카드게임onepiece
Star Wars: Unlimitedswu
Flesh and Bloodfab