Titik Akhir API

Rujukan lengkap titik akhir carian, butiran kad, sejarah harga, set, permainan, dan kelompok API TCG Price Lookup.

URL Asas

https://api.tcgpricelookup.com/v1

Cari kad merentasi semua permainan mengikut nama.

GET /v1/search

Parameter Pertanyaan:

Parameter	Diperlukan	Penerangan
`q`	Ya	Pertanyaan carian (nama kad)
`game`	Tidak	Slug permainan (contoh: `pokemon`, `mtg`, `yugioh`)
`set`	Tidak	Tapis mengikut nama atau kod set
`rarity`	Tidak	Tapis mengikut keraritan
`limit`	Tidak	Bilangan hasil (lalai: 20, maks: 100)
`offset`	Tidak	Ofset untuk penomboran halaman

Contoh:

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

Dapatkan data harga terperinci untuk kad mengikut ID.

GET /v1/cards/:id

Contoh:

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

Dapatkan sejarah harga kad (Pelan Trader ke atas).

GET /v1/cards/:id/prices

Parameter Pertanyaan:

Parameter	Lalai	Penerangan
`days`	30	Bilangan hari sejarah (maks: 90)

Senaraikan semua set untuk permainan tertentu.

GET /v1/sets?game=pokemon

Dapatkan sehingga 20 kad dalam satu permintaan (Pelan Trader ke atas).

POST /v1/cards/batch

Badan Permintaan:

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