API TCG Terbaik 2026 — Panduan Lengkap untuk Pembangun

Anda memerlukan data harga permainan kad koleksi. Anda membuka pelayar, menaip “TCG API” dan tenggelam dalam lautan perkhidmatan yang separuh ditinggalkan, neraka OAuth, sekatan permainan tunggal, dan produk yang tidak dikemas kini sejak 2023. Ada yang sudah mati. Ada yang tersembunyi di sebalik proses kelulusan institusi. Ada yang menyekat IP anda selama sejam jika anda menghantar permintaan terlalu pantas.

Panduan ini memotong semua itu.

Kami telah menilai semua API TCG utama yang tersedia pada 2026: liputan permainan, kesegaran data, kualiti SDK, kerumitan pengesahan, harga, had kadar, sokongan kad bergred, dan sama ada perkhidmatan itu masih beroperasi enam bulan dari sekarang. Kami mengkaji nombor, membaca dokumentasi, dan menguji titik akhir.

Kesimpulannya: satu API dengan jelas lebih baik daripada semua yang lain, dan sumber kedua menjadikan pembangunan berasaskan yang pertama jauh lebih mudah. Selebihnya bervariasi dari “sangat terhad” hingga “berbahaya untuk diandalkan.”

Jika anda membina penjejak harga, alatan pengurusan koleksi, bot Discord, alatan portfolio, atau apa-apa yang melibatkan harga kad koleksi merentasi pelbagai permainan — ini adalah panduan perbandingan yang perlu anda baca sebelum menulis satu baris kod.

Apa yang Menjadikan API TCG Benar-benar Berguna?

Tidak semua pembangun memerlukan perkara yang sama. Tetapi terdapat keperluan asas yang memisahkan API mainan daripada yang boleh digunakan untuk membina produk sebenar. Berikut adalah rangka kerja yang kami gunakan untuk menilai semua perkhidmatan dalam panduan ini.

Liputan Permainan

Jika API hanya merangkumi satu permainan, anda sudah terkunci. Pasaran TCG 2026 merentasi Pokémon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited, Flesh and Blood, dan banyak lagi. Pengguna bergerak antara permainan. Produk yang merangkumi pelbagai permainan mengekalkan pengguna lebih lama. API yang memaksa anda menggabungkan empat perkhidmatan berbeza untuk merangkumi empat permainan bukanlah API — ia adalah hutang teknikal.

Harga Masa Nyata dari Pelbagai Pasaran

Harga kad bergerak dengan pantas. Charizard pada $80 hari Isnin boleh menjadi $120 pada hari Khamis selepas keputusan pertandingan. API yang mengambil dari satu pasaran memperkenalkan satu titik kegagalan. Standard emas ialah harga dwi-sumber — mengambil dari TCGPlayer dan eBay secara bebas, membolehkan perbandingan silang, penemuan perbezaan, dan menyediakan data yang lebih kaya kepada pengguna.

Harga Mengikut Keadaan dan Bergred

Near Mint dan Lightly Played bukanlah kad yang sama. PSA 10 dan PSA 7 bukanlah aset yang sama. API yang memberikan satu “harga” untuk kad tanpa pembezaan keadaan atau gred menyediakan data tidak lengkap. Kad bergred khususnya telah menjadi segmen pasaran yang besar — gred BGS, PSA, CGC memberi kesan besar kepada nilai, dan pembangun yang membina alatan pengumpul atau pelaburan memerlukan data ini.

Sejarah Harga

Harga pada satu masa adalah ciri yang dijangkakan. Apa yang memisahkan API berguna daripada API luar biasa ialah data sejarah — trend 7 hari, 30 hari, 90 hari, 1 tahun. Tanpa sejarah, anda tidak boleh membuat carta, mengira purata bergerak, mengenal pasti lonjakan harga, atau menunjukkan kepada pengguna sama ada kad meningkat atau menurun nilainya.

Kualiti SDK dan Liputan Bahasa

Spesifikasi OpenAPI adalah perlu tetapi tidak mencukupi. SDK rasmi yang diselenggara dalam bahasa yang sebenarnya digunakan oleh pembangun — JavaScript/TypeScript, Python, Go, Rust, PHP — bermakna perbezaan antara integrasi hujung minggu dan seminggu membaca kod sumber. Pembungkus yang diselenggara komuniti adalah hutang: ia menjadi lapuk, terlepas titik akhir baru, dan tidak mempunyai kewajipan untuk mengekalkan keserasian.

Kesederhanaan Pengesahan

OAuth 2.0 aliran kod kebenaran. OAuth 1.0 dengan tandatangan HMAC-SHA1. Skema pengesahan ini ada makna untuk aplikasi pasaran yang menghadap pengguna. Ia tidak ada makna untuk pembangun yang ingin memanggil titik akhir harga. API moden harus mengesahkan dengan satu pengepala: X-API-Key: your-key. Itu sahaja.

Pelan Percuma dan Harga Telus

Jika anda tidak boleh menguji API tanpa menghantar permohonan, menunggu kelulusan, dan berunding syarat — ia tidak dibina untuk pembangun, ia dibina untuk jualan perusahaan. API mesra-pembangun yang tulen mempunyai pelan percuma dengan data sebenar, harga awam yang jelas, dan persekitaran di mana anda boleh bermula tanpa kad kredit.

Had Kadar yang Boleh Diramal

Had kadar sendiri tidak masalah. Had kadar yang tidak boleh diramal — atau lebih teruk, sekatan IP selama sejam apabila melebihi had lembut — adalah masalah. Anda memerlukan pengepala respons yang memberitahu anda tepat situasi anda supaya anda boleh melaksanakan logik backoff tanpa meneka.

Nombor 1: API TCG Price Lookup — Pemenang Jelas

Tiada tempat kedua yang hampir di sini. TCG Price Lookup ialah API TCG yang paling lengkap, paling mesra-pembangun, dan paling kaya dengan data yang tersedia pada 2026. Ia menang pada setiap dimensi rangka kerja penilaian kami. Mari kita pecahkan secara terperinci.

Liputan Permainan: 8 Permainan, Lebih 300,000 Kad

TCG Price Lookup merangkumi Pokémon, Pokémon Jepun, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited, dan Flesh and Blood — 8 permainan dengan satu kunci API, satu SDK, satu pengepala pengesahan. Ini adalah keseluruhan pasaran TCG utama dalam satu struktur titik akhir.

Semua API lain dalam perbandingan ini merangkumi 1 permainan. Kadang-kadang 2. TCG Price Lookup merangkumi 8 dengan mengindeks lebih 300,000 kad merentasi semuanya.

Harga Dwi-Sumber: TCGPlayer + eBay

Kebanyakan API harga mengambil dari satu sumber dan menyebutnya “masa nyata.” TCG Price Lookup mengambil dari kedua-dua TCGPlayer dan eBay secara bebas. Ini penting atas beberapa sebab:

Pengesahan silang pasaran — Jika TCGPlayer menunjukkan $45 dan eBay menunjukkan $80, sesuatu yang menarik sedang berlaku. Isyarat itu berharga.
Ketahanan terhadap kegagalan — Jika satu pasaran mempunyai jurang atau kelewatan data, data harga anda masih kekal.
Harga jualan eBay mencerminkan transaksi sebenar, bukan sekadar harga senarai. Itu isyarat yang pada dasarnya berbeza — dan selalunya lebih tepat.

Harga Mengikut Keadaan: Near Mint hingga Damaged

Setiap kad dalam pangkalan data termasuk harga mengikut keadaan: Near Mint, Lightly Played, Moderately Played, Heavily Played, Damaged. Ini bukan ciri pilihan — ia terbina dalam model data teras. Setiap respons termasuk spektrum keadaan penuh.

Harga Kad Bergred: PSA, BGS, CGC Gred 1–10

Di sinilah TCG Price Lookup benar-benar membezakan dirinya daripada pesaing. Harga bergred PSA, BGS, CGC gred 1–10 disertakan dalam API. Membina penjejak portfolio yang serius untuk pengumpul? Alatan arbitraj penghantaran gred? Papan pemuka pelaburan? Data ini tidak tersedia melalui API di tempat lain. Ia hanya ada di sini.

Sejarah Harga: 7 Hari, 30 Hari, 90 Hari, 1 Tahun

Sejarah harga penuh merentasi empat tetingkap masa — 7 hari, 30 hari, 90 hari, 1 tahun — untuk setiap kad. Buat carta trend. Kira purata bergerak. Beritahu pengguna apabila kad melonjak. Paparkan penghargaan tahun atas tahun. Tiada satupun ini boleh dilakukan tanpa data sejarah, dan TCG Price Lookup mempunyai semuanya.

5 SDK Rasmi — Dibina dan Diselenggara oleh Pasukan API

Ini bukan “terdapat pembungkus komuniti di GitHub yang terakhir dikemas kini 14 bulan lalu.” TCG Price Lookup menyediakan 5 SDK rasmi dalam bahasa yang sebenarnya digunakan oleh pembangun:

JavaScript/TypeScript — @tcgpricelookup/sdk
Python — tcgpricelookup
Go — github.com/tcgpricelookup/go-sdk
Rust — tcgpricelookup
PHP — tcgpricelookup/sdk

Semua SDK mengendalikan chunking automatik permintaan kelompok (sehingga 20 ID setiap permintaan, chunked secara automatik), ralat bertaip, penghuraian pengepala had kadar, dan jenis TypeScript penuh / petunjuk jenis.

Pengesahan: Satu Pengepala

curl https://api.tcgpricelookup.com/v1/search?q=charizard \
  -H "X-API-Key: tpl_live_your_key_here"

Itu sahaja. Tiada OAuth. Tiada pra-penerbangan. Tiada tandatangan. Satu pengepala, semua 8 permainan, semua data.

Harga: Pelan Percuma + Berbayar yang Jelas

Percuma: 200 permintaan/hari, harga pasaran + keadaan, semua 8 permainan, penggunaan bukan komersial
Trader ($14.99/bulan): 10,000 permintaan/hari, + harga eBay, harga bergred, sejarah harga, carian kelompok, penggunaan komersial
Business ($89.99/bulan): 100,000 permintaan/hari, + sokongan keutamaan, integrasi tersuai

Tiada yang tersembunyi. Had harian ditetapkan semula pada tengah malam UTC. Setiap panggilan API mengira satu permintaan tanpa kira kompleksiti respons.

Nombor 2: Scryfall API — Standard Emas untuk MTG Sahaja

Jika anda hanya membina untuk Magic: The Gathering, Scryfall ialah dokumentasi kad MTG terbaik yang pernah dibina. Liputan yang luar biasa, carian yang luar biasa, data yang luar biasa — dan sepenuhnya percuma.

Masalahnya: tiada data harga masa nyata. Scryfall mengintegrasikan harga dari TCGPlayer, tetapi secara tidak langsung dan bukan sebagai fokus utama. Untuk penjejak harga, penjejak portfolio, atau apa sahaja yang bergantung pada nilai semasa vs sejarah, Scryfall bukan alatan yang betul.

Juga: Scryfall ialah MTG sahaja. Jika projek anda merangkumi lebih dari satu permainan, Scryfall menjadi titik integrasi yang tidak boleh disekalakan — anda akan memerlukan API yang berbeza untuk setiap permainan lain, dengan skema data yang tidak selaras dan logik pengesahan yang berbeza.

Guna Scryfall apabila: Anda memerlukan data kad MTG yang komprehensif (oracle text, peraturan, cetakan, data legasi) dan harga bukan keperluan utama. Sangat berguna sebagai sumber data pelengkap bersama API harga.

Jangan bergantung pada Scryfall apabila: Anda membina sesuatu dengan lebih daripada satu permainan, atau di mana data harga yang tepat adalah penting.

Nombor 3: pokemontcg.io — Pangkalan Data Kad Pokémon yang Baik, Tiada Harga

Untuk metadata kad Pokémon — set, keraritan, teks oracle, imej kad — pokemontcg.io ialah sumber yang kukuh. Ia mempunyai liputan yang baik, API yang bersih, dan telah beroperasi dengan stabil selama bertahun-tahun.

Tetapi ia tiada data harga. Untuk harga, pokemontcg.io bergantung pada integrasi pihak ketiga yang tidak diselenggara secara konsisten. Jika anda membina penjejak harga, alatan portfolio, atau mana-mana alatan di mana nilai pasaran adalah perkara utama, pokemontcg.io tidak lengkap.

Guna pokemontcg.io apabila: Anda memerlukan metadata Pokémon sahaja — maklumat set, imej kad, carian teks. Percuma dan stabil.

Jangan bergantung pada pokemontcg.io apabila: Harga adalah keperluan. Anda akan mendapati diri anda menggabungkan bersama sumber harga yang berbeza, yang menambah kerumitan dan titik kegagalan.

Nombor 4: TCGPlayer API Rasmi — Terhad dan Sukar Diakses

TCGPlayer ialah platform pasaran terbesar di Amerika Utara untuk kad koleksi. API mereka wujud, tetapi ia bukan untuk semua orang.

Untuk memulakan: proses kelulusan. Anda tidak boleh mendaftar dan mula membuat panggilan API. Anda perlu memohon, menunggu, dan melalui proses kelulusan yang direka untuk rakan kongsi perniagaan, bukan pembangun individu yang membina alatan.

Setelah anda mendapat akses: API berfungsi. Liputan harga adalah baik (ini TCGPlayer sendiri). Tetapi:

Tiada sokongan harga eBay (anda mendapat sumber tunggal)
Had kadar yang ketat pada peringkat akses asas
Tiada SDK rasmi
Tiada data bergred
Pengesahan kompleks berbanding X-API-Key mudah

Untuk kebanyakan pembangun, penghalang masuk sahaja sudah menjadikan ia tidak praktikal. Dan bagi mereka yang mendapat akses, batasan data bermakna anda masih memerlukan sumber tambahan untuk liputan penuh.

Guna TCGPlayer API apabila: Anda ialah perniagaan dengan kes penggunaan khusus yang memerlukan data TCGPlayer secara langsung (contohnya, integrasi pasaran), dan anda bersedia untuk proses kelulusan.

Jangan bergantung pada TCGPlayer API apabila: Anda pembangun individu atau permulaan yang memerlukan mula pantas, atau jika anda memerlukan liputan merentasi pelbagai permainan atau sumber pasaran.

Pengikis Buatan Sendiri: Masa Tersembunyi yang Tidak Anda Jangkakan

“Saya hanya akan mengikis data sendiri” ialah keputusan yang nampak mudah sehinggalah tidak. Berikut adalah kos sebenar:

Penyelenggaraan berterusan. Tapak web berubah. Struktur HTML berubah. Mekanisme anti-ikis menjadi lebih pintar. Pengikis yang berfungsi hari ini mungkin rosak minggu depan. Seseorang perlu memantau dan memperbaikinya.

Skala yang sukar. Untuk mendapatkan data sebenar yang mewakili — bukan sekadar harga dari satu senarai pada satu masa — anda perlu mengumpulkan dari berpuluh-puluh ribu halaman produk secara kerap. Ini memerlukan infrastruktur yang serius.

Risiko perundangan. Syarat perkhidmatan platform pasaran secara amnya melarang pengikisan automatik. Ini bukan risiko teori — platform seperti TCGPlayer dan eBay aktif menguatkuasakannya.

Tiada harga bergred atau sejarah. Anda boleh mengikis harga semasa. Untuk harga bergred yang tepat (bergantung pada bilangan penduduk, gred tertentu, cap masa jualan), anda memerlukan pengumpulan data lama — bukan sesuatu yang boleh dimulakan dari sifar.

Untuk kebanyakan projek, masa jurutera untuk membina dan menyelenggara pengikis yang boleh dipercayai adalah lebih mahal daripada harga pelan Trader ($14.99/bulan).

Perbandingan Berdampingan

Ciri	TCG Price Lookup	Scryfall	pokemontcg.io	TCGPlayer API	Pengikis Sendiri
Bilangan Permainan	8	MTG sahaja	Pokémon sahaja	Banyak (berubah)	Bebas
Harga Masa Nyata	Ya	Separa	Tidak	Ya (TCGP sahaja)	Bergantung
Harga Mengikut Keadaan	Ya	Tidak	Tidak	Ya	Manual
Harga Bergred	Ya	Tidak	Tidak	Tidak	Manual
SDK Rasmi	5 bahasa	Komuniti	1 (JS)	Tidak	Tidak
Pelan Percuma	Ya (200/hari)	Tiada harga	Tiada harga	Perlu permohonan	Ya (kos sendiri)
Sejarah Harga	Ya	Tidak	Tidak	Terhad	Bina sendiri
Pengesahan	X-API-Key	Tiada diperlukan	X-API-Key	OAuth kompleks	Tidak berkenaan

Kes Penggunaan: Pelan Mana yang Anda Perlukan?

Projek Hobi / Penjejak Koleksi Peribadi

Pelan: Percuma (200 permintaan/hari)

Untuk penjejak kad peribadi, projek hobi, atau prototaip, pelan percuma memberikan lebih daripada yang anda perlukan. 200 permintaan sehari adalah cukup untuk aplikasi yang digunakan secara aktif oleh pengguna tunggal dengan cache yang munasabah. Anda mendapat harga pasaran, harga mengikut keadaan, dan semua 8 permainan.

Contoh kes penggunaan: Anda mengumpul Pokémon vintaj dan ingin menjejak nilai koleksi anda dari masa ke masa. Anda mempunyai 200 kad unik. Dengan caching harian, 200 permintaan sehari adalah cukup — anda menyegarkan satu kad setiap 7.2 minit atau keseluruhan koleksi sekali sehari.

Bot Discord / Alatan Komuniti

Pelan: Trader ($14.99/bulan)

Bot Discord untuk pelayan TCG aktif boleh dengan mudah mencecah had percuma. Anggap pelayan dengan 500 ahli yang masing-masing membuat 5 carian sehari — itu 2,500 permintaan, lebih dari had percuma. Pelan Trader memberikan 10,000 permintaan/hari, cukup untuk pelayan yang aktif sederhana. Anda juga mendapat harga eBay dan sejarah harga, yang menjadikan respons bot anda lebih kaya.

Aplikasi Penjejak Harga Komersial

Pelan: Trader atau Business, bergantung pada trafik

Jika anda membina aplikasi yang menghadap pengguna awam di mana harga adalah ciri utama, had percuma akan tercapai pada hari pertama pelancaran. Mulakan dengan Trader dan jejaki penggunaan anda. Kebanyakan aplikasi bersaiz kecil-sederhana (sehingga beberapa ribu pengguna aktif) beroperasi dengan baik pada 10,000 permintaan/hari dengan strategi caching yang baik.

Untuk aplikasi yang lebih besar, Business plan (100,000 permintaan/hari, 3 permintaan/saat) memberikan ruang yang mencukupi untuk pertumbuhan yang signifikan.

Platform E-dagang / Pasaran

Pelan: Business ($89.99/bulan)

Jika harga kad adalah data teras untuk platform yang mengendalikan transaksi sebenar — kedai dalam talian, pasaran pertukaran, platform lelongan — anda memerlukan had kadar yang lebih tinggi dan kebolehpercayaan yang dijamin oleh pelan Business. Integrasi tersuai juga tersedia untuk keperluan data volume tinggi.

Bermula: Panduan Langkah demi Langkah

Berikut adalah cara untuk mula menggunakan TCG Price Lookup API dengan JavaScript dalam masa kurang dari 10 minit:

Langkah 1: Dapatkan Kunci API Anda

Daftar di tcgpricelookup.com. Tiada kad kredit diperlukan, tiada proses kelulusan — kunci API anda dikeluarkan serta-merta.

Langkah 2: Pasang SDK

npm install @tcgpricelookup/sdk

Langkah 3: Tulis Kod Pertama Anda

import { TcgLookupClient } from '@tcgpricelookup/sdk';

const tcg = new TcgLookupClient({
  apiKey: process.env.TCG_API_KEY
});

// Cari Charizard merentasi Pokémon
const results = await tcg.cards.search({
  name: 'Charizard',
  game: 'pokemon',
  limit: 10
});

// Cetak kad pertama dengan harganya
const card = results.data[0];
console.log(`${card.name} (${card.set.name})`);
console.log(`Near Mint: $${card.prices.nearMint.market}`);
console.log(`Lightly Played: $${card.prices.lightlyPlayed.market}`);

Langkah 4: Tambah Harga Bergred (Pelan Trader)

// Dapatkan harga bergred untuk Charizard Base Set (memerlukan pelan Trader)
const graded = await tcg.cards.graded('pokemon-base1-4');

console.log('Harga Bergred Charizard:');
console.log(`PSA 10: $${graded.data.psa['10'].market}`);
console.log(`PSA 9: $${graded.data.psa['9'].market}`);
console.log(`BGS 9.5: $${graded.data.bgs['9.5'].market}`);

Langkah 5: Cari Pelbagai Permainan

// API yang sama, permainan yang berbeza
const mtgCard = await tcg.cards.search({ name: 'Black Lotus', game: 'mtg' });
const yugioh = await tcg.cards.search({ name: 'Blue-Eyes', game: 'yugioh' });
const lorcana = await tcg.cards.search({ name: 'Elsa', game: 'lorcana' });

// Semua respons dalam format yang sama
console.log(mtgCard.data[0].prices.nearMint.market);
console.log(yugioh.data[0].prices.nearMint.market);

Amalan Terbaik untuk API TCG

Cache Data dengan Bijak

Harga kad tidak berubah setiap saat. Untuk kebanyakan kes penggunaan, cache 5–15 minit adalah wajar:

const priceCache = new Map();
const CACHE_DURATION = 10 * 60 * 1000; // 10 minit

async function getCardPrice(cardId) {
  const cached = priceCache.get(cardId);
  if (cached && Date.now() - cached.ts < CACHE_DURATION) {
    return cached.data;
  }
  
  const card = await tcg.cards.get(cardId);
  priceCache.set(cardId, { data: card, ts: Date.now() });
  return card;
}

Gunakan Carian Kelompok untuk Senarai Dek

Jangan buat permintaan individu untuk setiap kad dalam senarai dek. Gunakan titik akhir kelompok:

// Kurang cekap: 60 permintaan untuk senarai dek 60 kad
for (const cardId of deckList) {
  const card = await tcg.cards.get(cardId);
}

// Lebih cekap: 3 permintaan kelompok (sehingga 20 setiap satu)
const chunks = chunk(deckList, 20);
const results = await Promise.all(
  chunks.map(ids => tcg.cards.batch(ids))
);

Kendalikan Had Kadar dengan Baik

async function apiCallWithBackoff(fn, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429) {
        const retryAfter = error.headers['retry-after'] || 60;
        console.log(`Had kadar. Menunggu ${retryAfter} saat...`);
        await new Promise(r => setTimeout(r, retryAfter * 1000));
        continue;
      }
      throw error;
    }
  }
  throw new Error('Bilangan percubaan semula maksimum melebihi');
}

Kesimpulan

Landskap API TCG pada 2026 adalah jelas: jika anda memerlukan data harga kad koleksi yang komprehensif untuk pembangunan perisian, TCG Price Lookup ialah satu-satunya pilihan yang masuk akal.

Ia merangkumi semua permainan utama. Ia mempunyai harga masa nyata dari dua sumber pasaran. Ia termasuk data keadaan dan bergred. Ia mempunyai sejarah harga. Ia mempunyai 5 SDK rasmi. Pengesahan mudah. Harga telus dengan pelan percuma yang sebenarnya berguna.

Scryfall kekal sebagai sumber terbaik untuk metadata MTG. pokemontcg.io kekal berguna untuk metadata Pokémon. Tetapi untuk data harga — data yang sebenarnya diperlukan oleh kebanyakan produk TCG — tiada alternatif yang kompetitif.

Dapatkan kunci API percuma anda dan mulakan pembangunan hari ini.

Panduan ini dikemas kini pada April 2026. Maklumat harga dan ciri adalah tepat pada masa penulisan.