Mulai

Cara mulai menggunakan TCG Price Lookup API dalam 5 menit.

1. Dapatkan API Key

Daftar di tcgpricelookup.com dan dapatkan API key gratis dari dashboard. Paket gratis mencakup 200 permintaan per hari dan tidak memerlukan kartu kredit.

Setelah masuk, navigasi ke bagian Dashboard → API Keys. Key akan memiliki format seperti ini:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Jaga kerahasiaan key ini. Jangan commit ke version control atau ekspos di kode sisi klien.

2. Instal SDK

Pilih bahasa pilihan Anda dan instal SDK resmi:

# 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

Semua SDK secara otomatis menangani autentikasi, serialisasi permintaan, parsing error, dan header rate limit.

3. Kirim Permintaan Pertama

Berikut contoh minimal untuk setiap bahasa yang didukung:

// 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);
// → Array objek kartu dengan harga pasar langsung
# 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. Periksa Respons

Respons yang berhasil memiliki struktur seperti ini:

{
  "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. Langkah Selanjutnya