$ curl https://api.tcgpricelookup.com/v1/search

Nopein
TCG-hinta-API
kehittäjille

Reaaliaikainen korttihinta-API Pokemonille, Magic: The Gatheringille, Yu-Gi-Oh!:lle, Lorcanalle, One Piecelle ja kolmelle muulle pelille. Yli 300 000 korttia, 5 virallista SDK:ta, ilmainen taso mukana.

Hanki ilmainen API-avain Lue dokumentaatio
300,000+ Korttia
8 Peliä
5 SDK:ta
2 Markkinaa
Free Ilmainen taso
24/7 Päivitykset
Pikaopas JavaScript 
// Search for any card across all 8 games
import { TCGLookup } from 'tcglookup';

const tcg = new TCGLookup({ apiKey: 'your-key' });
const cards = await tcg.search('charizard');
// 47 results, real-time prices from TCGPlayer + eBay

const card = await tcg.getCard('pokemon-sv4-charizard-ex-006');
// Market price, per-condition, PSA/BGS/CGC graded values

Kuinka TCG API toimii

Nollasta korttihintadatan hakemiseen alle 5 minuutissa. 3 vaihetta, ei konfigurointia.

01

Hanki ilmainen API-avain

Rekisteröidy osoitteessa tcgpricelookup.com — ei luottokorttia. API-avain myönnetään välittömästi ja toimii kaikissa 8 tuetussa pelissä. Ilmainen taso tarjoaa 200 pyyntöä/päivä, joten kehittäminen voi alkaa heti.

API key: tpl_live_xxxxxxxxxxxx
02

Asenna SDK

Valitse haluamasi kieli. Viralliset SDK:t ovat saatavilla JavaScriptille, Pythonille, Golle, Rustille ja PHP:lle. Jokaista SDK:ta ylläpitää TCG Price Lookup -tiimi täydellisillä tyyppimäärityksillä.

$ npm install tcglookup
03

Hae korttihinnat

Hae nimen, setin tai ID:n perusteella. Reaaliaikaiset TCGPlayer- ja eBay-hinnat, kunto-kohtaiset hinnat, luokiteltujen korttien hinnat ja hintatarinat yhdestä API:sta.

search GET /v1/search?q=charizard
card GET /v1/cards/:id
history GET /v1/cards/:id/prices
batch POST /v1/cards/batch

Mitä voit rakentaa

TCG-korttihinta-APIt ovat käytössä kaikkialla harrastajien skripteistä tuotantoympäristön kaupankäyntisovelluksiin.

💰

Hintavertailutyökalu

Näytä TCGPlayerin markkinahinnat ja eBayn toteutuneet kaupat rinnakkain. Ostajat löytävät parhaan hinnan, myyjät asettavat kilpailukykyiset hinnat.

📊

Portfolion seuranta

Keräilijät syöttävät korttinsa ja seuraavat kokoelmansa arvoa ajan mittaan. Piirrä voitot ja tappiot kaavioihin hintatarinan päätepisteellä.

🤖

Discord-botti

Lisää slash-komennot TCG Discord -palvelimillesi, jotta jäsenet voivat tarkistaa korttihinnat poistumatta chatista. Avoimen lähdekoodin Discord-botti-startti kaikille 8 pelille, joka on käyttöönottovalmis minuuteissa.

🔄

Kaupankäyntisovellus

Tehosta osto-, myynti- ja vaihtoliittymiäsi reaaliaikaisella hintadatalla. Näytä reilut vaihtoarvot, tunnista alihinnoitellut listat ja hae pakkolistan kaikki hinnat kerralla.

🔔

Hintahälytykset

Seuraa tiettyjä kortteja ja ilmoita käyttäjille, kun hinta ylittää kynnysarvon. Käytä ajoitettua kyselyä tai webhook-ilmoituksia maksullisilla tasoilla.

📈

Analytiikkakojelauta

Rakenna hintahistoriakaavioita, koko setin trendianalyysia ja setin markkina-arvioita. Hintatarinan päätepiste tarjoaa päivittäisiä tilannekatsauksia kuukausittain.

TCG API kaikille peleille

Yksi API-avain, 8 peliä. Pokémon TCG API, MTG API, Yu-Gi-Oh! API, Lorcana, One Piece ja muut — kaikki yhdessä yhtenäisessä rajapinnassa.

Pokemon

30,000+ cards

Access real-time pricing for over 30,000 Pokemon TCG cards. Search by name, set, or card number. Get per-condition pricing from Near Mint to Damaged, plus PSA, BGS, and CGC graded values.

Katso Pokemon API-dokumentaatio →
Pokemon API example JavaScript 
const results = await tcg.search('charizard', { game: 'pokemon' });
// Returns: prices for all Charizard cards across all sets

Magic: The Gathering

100,000+ cards

Access real-time pricing for over 100,000 Magic: The Gathering cards. Complete coverage of all sets from Alpha to the latest release. Per-condition and graded pricing.

Katso Magic: The Gathering API-dokumentaatio →
Magic: The Gathering API example JavaScript 
const results = await tcg.search('black lotus', { game: 'mtg' });
// Returns: prices for Black Lotus across all editions

Yu-Gi-Oh!

40,000+ cards

Access real-time pricing for over 40,000 Yu-Gi-Oh! cards. Coverage spans all sets and rarities with per-condition and graded card values.

Katso Yu-Gi-Oh! API-dokumentaatio →
Yu-Gi-Oh! API example JavaScript 
const results = await tcg.search('blue-eyes white dragon', { game: 'yugioh' });
// Returns: prices for Blue-Eyes White Dragon across all sets

Disney Lorcana

3,000+ cards

Access real-time pricing for over 3,000 Disney Lorcana cards. Full coverage since launch with per-condition pricing and graded values.

Katso Disney Lorcana API-dokumentaatio →
Disney Lorcana API example JavaScript 
const results = await tcg.search('elsa', { game: 'lorcana' });
// Returns: prices for all Elsa cards

One Piece

6,000+ cards

Access real-time pricing for over 6,000 One Piece TCG cards. Complete set coverage with per-condition pricing and graded values.

Katso One Piece API-dokumentaatio →
One Piece API example JavaScript 
const results = await tcg.search('luffy', { game: 'onepiece' });
// Returns: prices for all Luffy cards

Pokemon Japan

20,000+ cards

Access real-time pricing for over 20,000 Japanese Pokemon TCG cards. Covers Japanese-exclusive sets, promos, and special releases.

Katso Pokemon Japan API-dokumentaatio →
Pokemon Japan API example JavaScript 
const results = await tcg.search('pikachu', { game: 'pokemonjp' });
// Returns: prices for Japanese Pikachu cards

Star Wars: Unlimited

2,500+ cards

Access real-time pricing for over 2,500 Star Wars: Unlimited cards. Full coverage with per-condition pricing and graded values.

Katso Star Wars: Unlimited API-dokumentaatio →
Star Wars: Unlimited API example JavaScript 
const results = await tcg.search('darth vader', { game: 'swu' });
// Returns: prices for all Darth Vader cards

Flesh and Blood

8,000+ cards

Access real-time pricing for over 8,000 Flesh and Blood cards. Complete coverage with per-condition pricing and graded values.

Katso Flesh and Blood API-dokumentaatio →
Flesh and Blood API example JavaScript 
const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cards
Katso kaikki tuetut pelit →

TCG API -vertailu

TCG Price Lookup vs. Scryfall, pokemontcg.io, TCGPlayer API ja omatekoiset kaapijat.

Ominaisuus TCG Price Lookup Scryfall API pokemontcg.io TCGPlayer API Oma kaapin
Tuetut pelit 8 peliä Vain MTG Vain Pokémon Useita (vaihtelee) Vapaa
Reaaliaikaiset hinnat ✓ Osittain (TCGP) ✗ ✓ (vain TCGP) Riippuu
Kunto-kohtaiset hinnat ✓ ✗ ✗ ✓ Manuaalinen
Luokiteltujen hinnat (PSA/BGS/CGC) ✓ ✗ ✗ ✗ Manuaalinen
Viralliset SDK:t 5 kieltä Vain yhteisö 1 (JS) ✗ ✗
Ilmainen taso ✓ 200 pyyntöä/pv Ei hintadataa Ei hintadataa Vaatii hakemuksen ✓ (oma kustannus)
Hintahistoria ✓ ✗ ✗ Rajallinen Omatekoiset

Kehittäjäekosysteemi

REST API:n lisäksi viralliset SDK:t 5 kielelle, valmiit työkalut ja kattava kehittäjädokumentaatio.

Viralliset SDK:t — 6 kieltä

CLI Tool

GitHub →

Live trading card prices in your terminal. Search, lookup, price history, JSON output for scripting. Also installable via npm.

$ brew tap TCG-Price-Lookup/tcg && brew install tcglookup
  • ✓ Search cards from terminal
  • ✓ Price history lookups
  • ✓ JSON output for scripting

Go SDK

GitHub →

Official Go SDK for the TCG Price Lookup API. Idiomatic Go, stdlib net/http, zero third-party deps, functional options, typed errors.

$ go get github.com/TCG-Price-Lookup/tcglookup-go
  • ✓ Zero third-party dependencies
  • ✓ Idiomatic Go design
  • ✓ Functional options pattern

JavaScript / TypeScript SDK

GitHub →

Official JavaScript/TypeScript SDK for the TCG Price Lookup API. Zero deps, ESM + CJS, works in Node 18+, browsers, Bun, Deno, Cloudflare Workers.

$ npm install tcglookup
  • ✓ Zero dependencies
  • ✓ ESM and CommonJS support
  • ✓ Full TypeScript types

PHP SDK

GitHub →

Official PHP SDK for the TCG Price Lookup API. PHP 8.1+, Guzzle, PSR-4, typed exception hierarchy.

$ composer require tcg-price-lookup/tcglookup
  • ✓ PHP 8.1+ support
  • ✓ Guzzle HTTP client
  • ✓ PSR-4 autoloading

Python SDK

GitHub →

Official Python SDK for the TCG Price Lookup API. Python 3.9+, built on httpx, typed exception hierarchy, context manager support.

$ pip install tcglookup
  • ✓ Python 3.9+ support
  • ✓ Built on httpx (async ready)
  • ✓ Typed exception hierarchy

Rust SDK

GitHub →

Official Rust SDK for the TCG Price Lookup API. Async with reqwest + tokio, typed Error enum, builder pattern.

$ cargo add tcglookup
  • ✓ Async with reqwest + tokio
  • ✓ Typed Error enum
  • ✓ Builder pattern

Työkalut ja resurssit — 5 työkalua

Awesome TCG

list

Curated list of the TCG Price Lookup ecosystem — REST API, 5 SDKs, CLI, code examples in 8 languages, blog tutorials.

github.com/TCG-Price-Lookup/awesome-tcg#readme →

Discord Bot

bot

Self-hosted Discord bot for live trading card prices. Slash commands powered by the TCG Price Lookup API. Supports all 8 games.

github.com/TCG-Price-Lookup/tcg-discord-bot#readme →

Next.js Starter

starter

One-click deployable Next.js 16 starter for the TCG Price Lookup API. Search live trading card prices across 8 games out of the box.

$ npx create-next-app -e https://github.com/TCG-Price-Lookup/nextjs-tcg-starter

OpenAPI Specification

spec

OpenAPI 3.1 specification for the TCG Price Lookup API. Use with Swagger UI, Redoc, Postman, or any OpenAPI-compatible tool.

github.com/TCG-Price-Lookup/tcg-api-openapi#readme →

Postman Collection

collection

Ready-to-use Postman collection and environment for the TCG Price Lookup API. Import, set your API key, and start testing.

github.com/TCG-Price-Lookup/tcg-api-postman#readme →
Lue API-dokumentaatio →

Usein kysytyt kysymykset

TCG Price Lookup API:n aloittamisesta nopeusrajoihin ja luokiteltujen korttien hintoihin.

Mikä on keräilykortti-API?

+

Keräilykortti-API (TCG API) on verkkopalvelu, joka tarjoaa ohjelmallisen pääsyn korttidata aan. Voit hakea kortin tiedot, setti-informaation ja reaaliaikaiset markkinahinnat. Kehittäjät käyttävät TCG-APIa rakentaakseen hintaseurantaohjelmia, portfoliotyökaluja ja Discord-botteja.

Onko TCG Price Lookup API ilmainen?

+

Kyllä, TCG Price Lookupilla on ilmainen taso 200 pyyntöä/päivä harrastus- ja prototyyppiprojekteille (ei-kaupallinen). Maksulliset tasot tarjoavat korkeammat nopeusrajat, hintatarinan päätepisteet, eBay-hinnat, luokiteltujen korttien hinnat ja kaupallisen käyttöoikeuden. Ei vaadi luottokorttia.

Mitä keräilykorttipelejä tuetaan?

+

Tällä hetkellä tuetaan 8 peliä: Pokémon TCG (englanti), Pokémon japani, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited ja Flesh and Blood. Kaikissa peleissä käytetään samoja yhtenäisiä haku- ja korttirajapintoja.

Kuinka saan Pokémon TCG API -avaimen?

+

Rekisteröidy osoitteessa tcgpricelookup.com ja vahvista sähköpostiosoitteesi, niin saat API-avaimen välittömästi. Ilman hyväksymisprosessia voit aloittaa Pokémon TCG API -pyyntöjen (ja kaikkien muiden pelien) lähettämisen heti.

Tuetaanko luokiteltujen korttien hintoja (PSA, BGS, CGC)?

+

Kyllä. Voit hakea PSA (arvosanat 1–10), Beckett (BGS 7–10 sisältäen 9,5 ja 10 Black Label) ja CGC (arvosanat 1–10) luokiteltujen korttien hinnat. Luokiteltujen korttien hinnat haetaan eBay-myyntidatasta. Vaatii Trader-tason tai korkeamman.

Mitkä ovat API:n nopeusrajat?

+

Ilmainen taso: enintään 200 pyyntöä/päivä (burst: 1 pyyntö/3 s). Trader-taso (14,99 $/kk): 10 000 pyyntöä/päivä (burst: 1 pyyntö/s). Business-taso (89,99 $/kk): 100 000 pyyntöä/päivä (burst: 3 pyyntöä/s). Päivittäinen raja nollautuu UTC:n keskiyöllä.

Mitä SDK:ita on saatavilla?

+

Saatavilla on 5 virallista SDK:ta: JavaScript/TypeScript (npm install tcglookup), Python (pip install tcglookup), Go (go get github.com/TCG-Price-Lookup/tcglookup-go), Rust (cargo add tcglookup) ja PHP (composer require tcg-price-lookup/tcglookup). Saatavilla on myös CLI-työkalu pääsyyn terminaalista.

Kuinka usein korttihinnat päivittyvät?

+

Korttihinnat päivittyvät jatkuvasti. TCGPlayerin markkinahinnat päivittyvät muutaman tunnin välein uuden myyntidatan saapuessa. eBayn toteutuneet kaupat päivittyvät päivittäin. Kaikkein aikakriittisimmille sovelluksille voit myös seurata trendejä hintatarinan päätepisteiden avulla.

Aloita kehittäminen TCG API:lla tänään

Ilmainen taso saatavilla. Ei luottokorttia. Välitön pääsy yli 300 000 korttiin 8 pelissä.

Hanki ilmainen API-avain Lue dokumentaatio