Başlarken

TCG Price Lookup API'yi 5 dakika içinde kullanmaya başlama rehberi.

1. API Anahtarı Alın

tcgpricelookup.com adresine kaydolun ve panelden ücretsiz API anahtarınızı alın. Ücretsiz planda günde 200 istek bulunur, kredi kartı gerekmez.

Giriş yaptıktan sonra Pano → API Anahtarları bölümüne gidin. Anahtarınız şu biçimdedir:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Bu anahtarı gizli tutun. Sürüm kontrolüne işlemeyin veya istemci tarafı kodunda açıklamayın.

2. SDK’yı Yükleyin

Tercih ettiğiniz dil için resmi SDK’yı yükleyin:

# 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üm SDK’lar kimlik doğrulama, istek serileştirme, hata ayrıştırma ve hız limiti başlıklarını otomatik olarak yönetir.

3. İlk İsteği Gönderin

Her desteklenen dil için minimal örnek:

// 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);
// → Canlı piyasa fiyatları içeren kart nesneleri dizisi
# 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. Yanıtı İnceleyin

Başarılı bir yanıt şu yapıya sahiptir:

{
  "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. Sonraki Adımlar