$ curl https://api.tcgpricelookup.com/v1/search
La API de precios TCG
más rápida
para desarrolladores
API de precios de cartas en tiempo real para Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece y 3 juegos más. Más de 300.000 cartas, 5 SDKs oficiales, nivel gratuito incluido.
// 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 valuesCómo funciona la API TCG
De cero a precios de cartas en menos de 5 minutos. 3 pasos, sin configuración.
Obtenga su clave de API gratuita
Regístrese en tcgpricelookup.com — sin tarjeta de crédito. Su clave de API se emite al instante y funciona con los 8 juegos compatibles. El plan gratuito incluye 200 solicitudes por día para comenzar a desarrollar de inmediato.
Instale el SDK
Elija su lenguaje preferido. Los SDK oficiales están disponibles para JavaScript, Python, Go, Rust y PHP. Cada SDK es mantenido por el equipo de TCG Price Lookup con definiciones de tipo completas.
Obtenga precios de cartas
Busque por nombre, set o ID de carta. Obtenga precios de mercado en tiempo real de TCGPlayer y eBay, precios por condición, precios graduados e historial de precios — todo en una sola API.
Qué puede construir
La API de precios de cartas TCG se utiliza para todo, desde scripts personales hasta aplicaciones de trading en producción.
Comparadores de precios
Muestre precios de mercado de TCGPlayer y ventas finalizadas de eBay lado a lado. Los compradores encuentran el mejor precio; los vendedores establecen precios competitivos.
Rastreadores de portafolio
Permita que los coleccionistas registren sus cartas y vean el valor de su colección a lo largo del tiempo. Grafique ganancias y pérdidas con el endpoint de historial de precios.
Bots de Discord
Agregue comandos de barra diagonal a servidores de Discord TCG para que los miembros puedan buscar precios de cartas sin salir del chat. El bot de Discord de código abierto compatible con los 8 juegos se puede desplegar en minutos.
Aplicaciones de trading
Mejore interfaces de compra, venta e intercambio con datos de precios en tiempo real. Muestre valores de intercambio justos, detecte listados con descuento y obtenga precios en lote para listas de mazos enteras.
Alertas de precios
Monitoree cartas específicas y notifique a los usuarios cuando los precios superen un umbral. Use polling programado o notificaciones webhook en los planes de pago.
Dashboards de análisis
Construya gráficos de historial de precios, análisis de tendencias de sets completos y estimaciones del valor de mercado total de un set. El endpoint de historial de precios proporciona snapshots diarios por mes.
Una API TCG para todos los juegos
Una clave de API para 8 juegos. API de Pokémon TCG, API de MTG, API de Yu-Gi-Oh!, Lorcana, One Piece y más — todo en una interfaz unificada.
Pokemon
30,000+ cardsAccess 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 documentación de la API de Pokemon →const results = await tcg.search('charizard', { game: 'pokemon' });
// Returns: prices for all Charizard cards across all setsMagic: The Gathering
100,000+ cardsAccess 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 documentación de la API de Magic: The Gathering →const results = await tcg.search('black lotus', { game: 'mtg' });
// Returns: prices for Black Lotus across all editionsYu-Gi-Oh!
40,000+ cardsAccess 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 documentación de la API de Yu-Gi-Oh! →const results = await tcg.search('blue-eyes white dragon', { game: 'yugioh' });
// Returns: prices for Blue-Eyes White Dragon across all setsDisney Lorcana
3,000+ cardsAccess real-time pricing for over 3,000 Disney Lorcana cards. Full coverage since launch with per-condition pricing and graded values.
Ver documentación de la API de Disney Lorcana →const results = await tcg.search('elsa', { game: 'lorcana' });
// Returns: prices for all Elsa cardsOne Piece
6,000+ cardsAccess real-time pricing for over 6,000 One Piece TCG cards. Complete set coverage with per-condition pricing and graded values.
Ver documentación de la API de One Piece →const results = await tcg.search('luffy', { game: 'onepiece' });
// Returns: prices for all Luffy cardsPokemon Japan
20,000+ cardsAccess real-time pricing for over 20,000 Japanese Pokemon TCG cards. Covers Japanese-exclusive sets, promos, and special releases.
Ver documentación de la API de Pokemon Japan →const results = await tcg.search('pikachu', { game: 'pokemonjp' });
// Returns: prices for Japanese Pikachu cardsStar Wars: Unlimited
2,500+ cardsAccess real-time pricing for over 2,500 Star Wars: Unlimited cards. Full coverage with per-condition pricing and graded values.
Ver documentación de la API de Star Wars: Unlimited →const results = await tcg.search('darth vader', { game: 'swu' });
// Returns: prices for all Darth Vader cardsFlesh and Blood
8,000+ cardsAccess real-time pricing for over 8,000 Flesh and Blood cards. Complete coverage with per-condition pricing and graded values.
Ver documentación de la API de Flesh and Blood →const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cardsComparativa de API TCG
TCG Price Lookup frente a Scryfall, pokemontcg.io, TCGPlayer API y scrapers propios.
| Característica | TCG Price Lookup | Scryfall API | pokemontcg.io | TCGPlayer API | Scraper propio |
|---|---|---|---|---|---|
| Juegos compatibles | 8 juegos | Solo MTG | Solo Pokémon | Varios (variable) | Libre |
| Precios en tiempo real | ✓ | Parcial (TCGP) | ✗ | ✓ (solo TCGP) | Depende |
| Precios por condición | ✓ | ✗ | ✗ | ✓ | Manual |
| Precios graduados (PSA/BGS/CGC) | ✓ | ✗ | ✗ | ✗ | Manual |
| SDK oficiales | 5 lenguajes | Solo comunidad | 1 (JS) | ✗ | ✗ |
| Plan gratuito | ✓ 200 solicitudes/día | Sin datos de precio | Sin datos de precio | Requiere solicitud | ✓ (autofinanciado) |
| Historial de precios | ✓ | ✗ | ✗ | Limitado | Propio |
Ecosistema de desarrolladores
Además de la REST API, 5 SDK oficiales en 5 lenguajes, herramientas listas para usar y documentación completa para desarrolladores.
SDK oficiales — 6 lenguajes
CLI Tool
GitHub →Live trading card prices in your terminal. Search, lookup, price history, JSON output for scripting. Also installable via npm.
- ✓ 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.
- ✓ 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.
- ✓ 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.
- ✓ 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.
- ✓ 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.
- ✓ Async with reqwest + tokio
- ✓ Typed Error enum
- ✓ Builder pattern
Herramientas y recursos — 5 herramientas
Awesome TCG
listCurated 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
botSelf-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
starterOne-click deployable Next.js 16 starter for the TCG Price Lookup API. Search live trading card prices across 8 games out of the box.
OpenAPI Specification
specOpenAPI 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
collectionReady-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 →Preguntas frecuentes
Desde cómo empezar con la API TCG Price Lookup hasta límites de tasa y precios de cartas graduadas.
¿Qué es una API TCG?
+
Una API TCG (Trading Card Game API) es un servicio web que proporciona acceso programático a datos de cartas coleccionables. Puede obtener detalles de cartas, información de sets y precios de mercado en tiempo real. Los desarrolladores usan las API TCG para construir rastreadores de precios, herramientas de portafolio, bots de Discord y mucho más.
¿Es gratuita la API TCG Price Lookup?
+
Sí, TCG Price Lookup ofrece un plan gratuito con 200 solicitudes por día para proyectos personales y prototipos (uso no comercial). Los planes de pago ofrecen límites de tasa más altos, endpoints de historial de precios, precios de eBay, precios de cartas graduadas y uso comercial. No se requiere tarjeta de crédito para comenzar.
¿Qué juegos de cartas coleccionables son compatibles?
+
Actualmente son compatibles 8 juegos: Pokémon TCG (inglés), Pokémon japonés, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited y Flesh and Blood. Todos los juegos usan los mismos endpoints unificados de búsqueda y carta.
¿Cómo se obtiene una clave de API para Pokémon TCG?
+
Regístrese en tcgpricelookup.com y verifique su correo electrónico; su clave de API se emitirá de inmediato. Sin proceso de aprobación: puede comenzar a hacer solicitudes a la API de Pokémon TCG (y a todos los demás juegos) de inmediato.
¿Son compatibles los precios de cartas graduadas (PSA, BGS, CGC)?
+
Sí. Puede obtener precios de cartas graduadas PSA (grados 1-10), Beckett (BGS 7-10, incluidos 9.5 y 10 Black Label) y CGC (grados 1-10). Los precios graduados se obtienen de datos de ventas de eBay. Requiere el plan Trader o superior.
¿Cuáles son los límites de tasa de la API?
+
El plan gratuito tiene un máximo de 200 solicitudes por día (ráfaga: 1 solicitud/3 s). El plan Trader ($14,99/mes) permite 10 000 solicitudes por día (ráfaga: 1 solicitud/s). El plan Business ($89,99/mes) permite 100 000 solicitudes por día (ráfaga: 3 solicitudes/s). Los límites diarios se restablecen a medianoche UTC.
¿Qué SDK están disponibles?
+
Hay 5 SDK oficiales: JavaScript/TypeScript (npm install tcglookup), Python (pip install tcglookup), Go (go get github.com/TCG-Price-Lookup/tcglookup-go), Rust (cargo add tcglookup) y PHP (composer require tcg-price-lookup/tcglookup). También hay una herramienta CLI para acceder desde la terminal.
¿Con qué frecuencia se actualizan los precios de las cartas?
+
Los precios de las cartas se actualizan continuamente. Los precios de mercado de TCGPlayer se actualizan cada pocas horas a medida que ingresan nuevos datos de ventas. Los listados de eBay se actualizan diariamente. Para las aplicaciones más sensibles al tiempo, también puede rastrear tendencias con el endpoint de historial de precios.
Comience a desarrollar con la API TCG hoy
Plan gratuito incluido. Sin tarjeta de crédito. Acceso instantáneo a más de 300 000 cartas de 8 juegos.