시작하기

5분 이내에 TCG Price Lookup API 사용을 시작하는 방법.

1. API 키 발급

tcgpricelookup.com에서 회원가입하고 대시보드에서 무료 API 키를 발급받으세요. 무료 플랜에는 하루 200회 요청이 포함되며 신용카드는 필요하지 않습니다.

로그인 후 대시보드 → API 키 섹션으로 이동하세요. 키는 다음과 같은 형식입니다:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

이 키는 비밀로 유지하세요. 버전 관리에 커밋하거나 클라이언트 사이드 코드에 공개하지 마세요.

2. SDK 설치

원하는 언어를 선택하여 공식 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

모든 SDK는 인증, 요청 직렬화, 에러 파싱, rate limit 헤더를 자동으로 처리합니다.

3. 첫 번째 요청 전송

각 지원 언어에서의 최소한의 예시입니다:

// JavaScript / TypeScript
import { TCGLookup } from 'tcglookup';

const tcg = new TCGLookup({ apiKey: 'your-api-key' });

const results = await tcg.search('charizard', { game: 'pokemon', limit: 5 });
console.log(results.data);
// → 실시간 시장 가격을 포함한 카드 객체 배열
# Python
from tcglookup import TCGLookup

tcg = TCGLookup(api_key='your-api-key')
results = tcg.search('charizard', game='pokemon', limit=5)
print(results.data)
// Go
client := tcglookup.NewClient("your-api-key")
results, _ := client.Search("charizard", &tcglookup.SearchParams{Game: "pokemon"})

4. 응답 확인

성공한 응답은 다음과 같은 구조입니다:

{
  "data": [
    {
      "id": "pokemon-base1-4",
      "name": "Charizard",
      "game": "pokemon",
      "set": { "name": "Base Set", "code": "base1" },
      "rarity": "Rare Holo",
      "prices": {
        "nearMint": {
          "market": 450.00,
          "tcgplayer": 445.00,
          "ebay": 455.00
        },
        "lightlyPlayed": {
          "market": 380.00
        }
      }
    }
  ],
  "total": 12,
  "limit": 5,
  "offset": 0
}

5. 다음 단계