EL MANUAL DE TU AVENTURA

De la idea a la primera consulta.

Todo lo que necesitas para trabajar con pokemon-tcg.dev.

Consola API
Inicio rápido

Inicio rápido

Crea una cuenta, copia tu clave del panel y envíala como Bearer token. Guarda las claves privadas en tu servidor.

HTTP / cURL
curl 'https://api.pokemon-tcg.dev/v1/cards?name=Pikachu&lang=en&include_prices=true' \
  -H "Authorization: Bearer $POKEMON_API_KEY"
Crear cuenta

Rutas disponibles

GET
/cards?name=Pikachu&lang=es&include_prices=true

Cartas, filtros e imágenes

GET
/sets

Catálogo de expansiones

GET
/cards/:id

Una carta por ID

GET
/cards/:id/prices/history

Historial de precios

Abrir referencia OpenAPI ↗

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/plans

Lí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.