Bắt đầu

Cách bắt đầu sử dụng TCG Price Lookup API trong vòng 5 phút.

1. Lấy API key

Đăng ký tại tcgpricelookup.com và lấy API key miễn phí từ bảng điều khiển. Gói miễn phí bao gồm 200 yêu cầu mỗi ngày, không cần thẻ tín dụng.

Sau khi đăng nhập, điều hướng đến phần Bảng điều khiển → API Keys. Key có dạng như sau:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Giữ key này bí mật. Đừng commit vào version control hay để lộ trong code phía client.

2. Cài đặt SDK

Chọn ngôn ngữ bạn muốn và cài đặt SDK chính thức:

# 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

Tất cả SDK tự động xử lý xác thực, serialization yêu cầu, phân tích lỗi và header giới hạn tốc độ.

3. Gửi yêu cầu đầu tiên

Đây là ví dụ tối giản cho mỗi ngôn ngữ được hỗ trợ:

// 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);
// → Mảng các đối tượng thẻ với giá thị trường trực tiếp
# 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. Kiểm tra response

Response thành công có cấu trúc như sau:

{
  "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. Các bước tiếp theo