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

A API de preços TCG
mais rápida
para desenvolvedores

API de preços de cartas em tempo real para Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece e mais 3 jogos. Mais de 300.000 cartas, 5 SDKs oficiais, nível gratuito incluído.

Obter chave de API gratuita Ler a documentação

300,000+ Cartas

8 Jogos

5 SDKs

2 Mercados

Free Nível gratuito

24/7 Atualizações

Início rápido 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

Como funciona a TCG API

Do zero ao acesso a dados de preços de cartas em menos de 5 minutos. 3 passos, sem configuração.

Obtenha uma chave de API gratuita

Cadastre-se em tcgpricelookup.com — sem cartão de crédito. Sua chave de API é gerada na hora e funciona em todos os 8 jogos suportados. O plano gratuito oferece 200 requisições por dia para começar a desenvolver imediatamente.

API key: tpl_live_xxxxxxxxxxxx

→

Instale um SDK

Escolha sua linguagem preferida. Os SDKs oficiais estão disponíveis para JavaScript, Python, Go, Rust e PHP. Cada SDK é mantido pela equipe TCG Price Lookup com tipagem completa.

$ npm install tcglookup

→

Busque preços de cartas

Busque por nome, conjunto ou ID. Obtenha preços em tempo real do TCGPlayer e eBay, preços por condição, preços graduados e histórico de preços — tudo em uma única API.

search GET /v1/search?q=charizard

card GET /v1/cards/:id

history GET /v1/cards/:id/prices

batch POST /v1/cards/batch

O que você pode construir

A API de preços de cartas TCG é usada em projetos desde scripts de hobby até apps de trading em produção.

💰

Comparador de preços

Exiba preços de mercado do TCGPlayer e vendas realizadas no eBay lado a lado. Compradores encontram as melhores ofertas; vendedores definem preços competitivos.

📊

Rastreador de portfólio

Deixe colecionadores inserir cartas e rastrear o valor da coleção ao longo do tempo. Use o endpoint de histórico de preços para criar gráficos de ganhos e perdas.

🤖

Bot do Discord

Adicione slash commands ao seu servidor Discord de TCG para que os membros possam verificar preços sem sair do chat. Um bot open-source compatível com todos os 8 jogos pode ser implantado em minutos.

🔄

App de trading

Potencialize interfaces de compra, venda e troca com dados de preços em tempo real. Mostre valores de troca justos, detecte listagens abaixo do preço e obtenha preços em lote para decks completos.

🔔

Alertas de preço

Monitore cartas específicas e notifique usuários quando o preço atingir um limite. Use polling agendado ou notificações via webhook nos planos pagos.

📈

Dashboard analítico

Crie gráficos de histórico de preços, análise de tendências para conjuntos inteiros e estimativas de capitalização de mercado de sets. O endpoint de histórico fornece snapshots diários por mês.

Uma TCG API para todos os jogos

Uma chave de API para 8 jogos. API do Pokémon TCG, API do MTG, API do Yu-Gi-Oh!, Lorcana, One Piece e mais — todos em uma interface unificada.

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.

Ver documentação da API Pokemon →

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.

Ver documentação da API Magic: The Gathering →

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.

Ver documentação da API Yu-Gi-Oh! →

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.

Ver documentação da API Disney Lorcana →

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.

Ver documentação da API One Piece →

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.

Ver documentação da API Pokemon Japan →

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.

Ver documentação da API Star Wars: Unlimited →

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.

Ver documentação da API Flesh and Blood →

Flesh and Blood API example JavaScript

const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cards

Ver todos os jogos suportados →

Comparativo de TCG APIs

TCG Price Lookup vs Scryfall, pokemontcg.io, TCGPlayer API e scrapers próprios.

Recurso	TCG Price Lookup	Scryfall API	pokemontcg.io	TCGPlayer API	Scraper próprio
Jogos cobertos	8 jogos	Só MTG	Só Pokémon	Muitos (varia)	Qualquer
Preços em tempo real	✓	Parcial (TCGP)	✗	✓ (só TCGP)	Depende
Preços por condição	✓	✗	✗	✓	Manual
Preços graduados (PSA/BGS/CGC)	✓	✗	✗	✗	Manual
SDKs oficiais	5 linguagens	Só comunidade	1 (JS)	✗	✗
Plano gratuito	✓ 200 req/dia	Sem preços	Sem preços	Requer solicitação	✓ (por conta)
Histórico de preços	✓	✗	✗	Limitado	Próprio

Ecossistema de desenvolvedores

Além da REST API, temos 5 SDKs oficiais para diferentes linguagens, ferramentas prontas para usar e documentação abrangente.

SDKs oficiais — 6 linguagens

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

Ferramentas e recursos — 5 ferramentas

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 →

Ler a documentação da API →

Perguntas frequentes

Desde como começar com a TCG Price Lookup API até limites de taxa e preços de cartas graduadas.

O que é uma TCG API?

Uma TCG API (API de Jogo de Cartas Colecionáveis) é um serviço web que fornece acesso programático a dados de cartas. Você pode obter detalhes das cartas, informações de conjuntos e preços de mercado em tempo real. Os desenvolvedores usam TCG APIs para criar rastreadores de preços, ferramentas de portfólio, bots do Discord e muito mais.

A TCG Price Lookup API é gratuita?

Sim, a TCG Price Lookup oferece um plano gratuito com 200 requisições por dia para projetos de hobby e protótipos (apenas uso não comercial). Os planos pagos oferecem limites mais altos, endpoints de histórico de preços, preços eBay, preços de cartas graduadas e uso comercial. Sem necessidade de cartão de crédito para começar.

Quais jogos de cartas colecionáveis são suportados?

Atualmente suportamos 8 jogos: Pokémon TCG (inglês), Pokémon edição japonesa, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited e Flesh and Blood. Todos os jogos usam os mesmos endpoints unificados de busca e cartas.

Como faço para obter uma chave de API do Pokémon TCG?

Cadastre-se em tcgpricelookup.com e confirme seu e-mail — sua chave de API é gerada instantaneamente. Sem processo de aprovação. Você pode começar a fazer requisições para a API do Pokémon TCG (e todos os outros jogos) imediatamente.

Vocês suportam preços de cartas graduadas (PSA, BGS, CGC)?

Sim. Você pode obter preços de cartas graduadas para PSA (graus 1-10), Beckett (BGS 7-10, incluindo 9,5 e Black Label 10) e CGC (graus 1-10). Os preços graduados são obtidos de dados de vendas do eBay. Requer plano Trader ou superior.

Quais são os limites de taxa da API?

Plano gratuito: máximo de 200 requisições/dia (burst: 1 req/3s). Plano Trader ($14,99/mês): 10.000 requisições/dia (burst: 1 req/s). Plano Business ($89,99/mês): 100.000 requisições/dia (burst: 3 req/s). Os limites diários resetam à meia-noite UTC.

Quais SDKs estão disponíveis?

Existem 5 SDKs oficiais: JavaScript/TypeScript (npm install tcglookup), Python (pip install tcglookup), Go (go get github.com/TCG-Price-Lookup/tcglookup-go), Rust (cargo add tcglookup) e PHP (composer require tcg-price-lookup/tcglookup). Também há uma ferramenta CLI para acesso pelo terminal.

Com que frequência os preços das cartas são atualizados?

Os preços das cartas são atualizados continuamente. Os preços de mercado do TCGPlayer são atualizados a cada poucas horas à medida que novos dados de vendas chegam. Os dados de vendas do eBay são atualizados diariamente. Para aplicações mais sensíveis ao tempo, você pode rastrear tendências com o endpoint de histórico de preços.

Comece a desenvolver com a TCG API hoje

Plano gratuito incluído. Sem cartão de crédito. Acesso imediato a 300.000+ cartas em 8 jogos.

Obter chave de API gratuita Ler a documentação

A API de preços TCG mais rápidapara desenvolvedores

Como funciona a TCG API

Obtenha uma chave de API gratuita

Instale um SDK

Busque preços de cartas

O que você pode construir

Comparador de preços

Rastreador de portfólio

Bot do Discord

App de trading

Alertas de preço

Dashboard analítico

Uma TCG API para todos os jogos

Pokemon

Magic: The Gathering

Yu-Gi-Oh!

Disney Lorcana

One Piece

Pokemon Japan

Star Wars: Unlimited

Flesh and Blood

Comparativo de TCG APIs

Ecossistema de desenvolvedores

SDKs oficiais — 6 linguagens

CLI Tool

Go SDK

JavaScript / TypeScript SDK

PHP SDK

Python SDK

Rust SDK

Ferramentas e recursos — 5 ferramentas

Awesome TCG

Discord Bot

Next.js Starter

OpenAPI Specification

Postman Collection

Perguntas frequentes

O que é uma TCG API?

A TCG Price Lookup API é gratuita?

Quais jogos de cartas colecionáveis são suportados?

Como faço para obter uma chave de API do Pokémon TCG?

Vocês suportam preços de cartas graduadas (PSA, BGS, CGC)?

Quais são os limites de taxa da API?

Quais SDKs estão disponíveis?

Com que frequência os preços das cartas são atualizados?

Comece a desenvolver com a TCG API hoje

A API de preços TCG
mais rápida
para desenvolvedores