API Uç Noktaları

TCG Price Lookup API arama, kart detayı, fiyat geçmişi, setler, oyunlar ve toplu arama uç noktalarının tam referansı.

Temel URL

https://api.tcgpricelookup.com/v1

Tüm oyunlarda ada göre kart araması yapar.

GET /v1/search

Sorgu Parametreleri:

Parametre	Zorunlu	Açıklama
`q`	Evet	Arama sorgusu (kart adı)
`game`	Hayır	Oyun kimliği (örn: `pokemon`, `mtg`, `yugioh`)
`set`	Hayır	Set adı veya set koduna göre filtrele
`rarity`	Hayır	Nadirliğe göre filtrele
`limit`	Hayır	Sonuç sayısı (varsayılan: 20, maksimum: 100)
`offset`	Hayır	Sayfalandırma için ofseti

Örnek:

curl "https://api.tcgpricelookup.com/v1/search?q=charizard&game=pokemon" \
  -H "X-API-Key: your-api-key"

ID ile bir kartın detaylı fiyat verisini alır.

GET /v1/cards/:id

Örnek:

curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
  -H "X-API-Key: your-api-key"

Bir kartın fiyat geçmişini alır (Trader planı veya üzeri).

GET /v1/cards/:id/prices

Sorgu Parametreleri:

Parametre	Varsayılan	Açıklama
`days`	30	Geçmiş gün sayısı (maksimum: 90)

Belirli bir oyunun tüm setlerini listeler.

GET /v1/sets?game=pokemon

Tek bir istekte 20 karta kadar alır (Trader planı veya üzeri).

POST /v1/cards/batch

İstek Gövdesi:

{
  "ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}