EL MANUAL DE TU AVENTURA
De la idea a la primera consulta.
Todo lo que necesitas para trabajar con pokemon-tcg.dev.
Inicio rápido
Crea una cuenta, copia tu clave del panel y envíala como Bearer token. Guarda las claves privadas en tu servidor.
curl 'https://api.pokemon-tcg.dev/v1/cards?name=Pikachu&lang=en&include_prices=true' \
-H "Authorization: Bearer $POKEMON_API_KEY"Rutas disponibles
/cards?name=Pikachu&lang=es&include_prices=trueCartas, filtros e imágenes
/setsCatálogo de expansiones
/cards/:idUna carta por ID
/cards/:id/prices/historyHistorial de precios
Atributos y rareza
types contiene los atributos elementales impresos en la carta; una carta puede tener más de uno. rarity conserva la etiqueta de la fuente. Estos valores son independientes de lang. Usa attribute y rarity para filtrar; /public/catalog publica las opciones disponibles. Si falta información, types es [] y rarity es null.
Autenticación
Usa una clave pkt_live_ para cartas, expansiones e historial. La sesión JWT se utiliza para tu panel; son credenciales diferentes.
Dos tipos de créditos
Cada GET válido de datos consume un crédito de carta. Pedir precios actuales consume créditos por los registros devueltos; una consulta de historial consume un crédito de precio adicional.
Siete idiomas, un contrato
Usa lang=en, es, jp, fr, de, it o pt. all_languages=true incluye los nombres disponibles. La cobertura de nombres e imágenes depende de cada carta.
Explorador público
Las rutas /public no necesitan clave ni consumen créditos. Admiten hasta 24 cartas por página, paginación por cursor y límites de 60 consultas por minuto y 10 por 10 segundos por IP y ubicación de Cloudflare.
GET /public/cards?q=Pikachu&lang=es&limit=24
GET /public/cards/:id?lang=es
GET /public/cards/:id/prices/history?source=tcgplayer&from=2026-01-01
GET /public/catalog
GET /public/plansLímites y errores
Un 429 indica que debes esperar: respeta Retry-After. Los errores incluyen error.code y error.message. El histórico público comparte el límite por IP y ofrece hasta 400 puntos por serie; la API autenticada devuelve todas las observaciones del periodo.