Cartas

Lista y filtra 80.000+ cartas Pokémon por nombre, expansión, rareza, idioma y precio, u obtén una carta con cada estado e impresión en que se vende.

Listar cartas

GET/v1/cards1 crédito por elemento devuelto

Busca y filtra cartas Pokémon de todas las expansiones e idiomas: búsqueda por nombre, filtro por rango de precios, ordenación. No devuelve datos de precios. Para eso, obtén una carta con GET /v1/cards/:id. Plan Free: solo inglés; el japonés, el alemán y el español requieren un plan de pago.

Parámetros

namestring

Filtra por nombre de carta (admite coincidencia parcial).

numberstring

Filtra por número de carta dentro de la expansión.

total_set_numberstring

Filtra por el número total de la expansión (p. ej. "102" para Base Set).

set_idstring

Filtra por ID de expansión.

tcg_player_idinteger

Filtra por ID de producto de TCGPlayer.

languagestring

Idioma de la carta (p. ej. "English", "Japanese", "German", "Spanish"). Plan Free: solo inglés; el japonés, el alemán y el español requieren un plan de pago.

raritystring

Rareza de la carta (p. ej. "Rare Holo", "Common").

stagestring

Fase de evolución (p. ej. "Basic", "Stage 1", "Stage 2").

card_typestring

Tipo de carta (p. ej. "Fire", "Water", "Trainer").

weaknessstring

Tipo de debilidad (p. ej. "Water").

energy_typestring

Tipo de Energía que usan los ataques de la carta (p. ej. "Fire"). Devuelve las cartas cuyos tipos de Energía incluyen el valor.

artiststring

Nombre del ilustrador, coincidencia parcial sin distinguir mayúsculas (p. ej. "arita").

hpinteger

PS exactos (p. ej. 120).

currencystring

Moneda que usan los filtros de precio y la ordenación. "usd" usa TCGPlayer; "eur" usa Cardmarket y requiere Pro o superior.

conditionstring

Estado de la carta (p. ej. "Near Mint", "Lightly Played", "Moderately Played").

variantstring

Variante de la carta (p. ej. "Normal", "Reverse Holo", "1st Edition").

gradestring

Nota de PSA/BGS/CGC.

min_pricenumber

Precio de mercado mínimo en la moneda seleccionada.

max_pricenumber

Precio de mercado máximo en la moneda seleccionada.

sortstring

Orden. Uno de "price_asc", "price_desc", "name_asc", "name_desc".

pagenumber

Número de página para la paginación. Por defecto: 1.

per_pagenumber

Resultados por página. Máximo 100. Por defecto: 50.

Pruébalo

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards
Respuesta
{
  "data": [
    {
      "id": 4521,
      "tcg_player_id": 89356,
      "name": "Charizard",
      "image_url": "https://images.pkmnprices.com/cards/4521.jpg",
      "number": "4",
      "total_set_number": "102",
      "rarity": "Rare Holo",
      "artist": "Mitsuhiro Arita",
      "hp": 120,
      "set": {
        "id": 1,
        "name": "Base Set"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

Obtener carta

GET/v1/cards/:id1 crédito

Una carta Pokémon por ID, con todos los datos de precios y los atributos de juego: fase, tipo, PS, debilidad, resistencia, coste de retirada, tipo de Energía, habilidad, ataques, texto de ambientación. Estos campos extra solo están en este endpoint, no en los de listado.

cardmarket_url y cardmarket_product_id identifican el producto exacto de Cardmarket asociado, cuando existe. Los precios vienen de TCGPlayer (USD) y Cardmarket (EUR); elige la fuente con el parámetro currency. Cada objeto de precio tiene un único market_price para su propio estado y su variante de impresión.

Parámetros

idintegerobligatorio

El ID único de la carta.

currencystring

Fuente y moneda del precio. "usd" devuelve precios de TCGPlayer, "eur" devuelve precios de Cardmarket. Si lo omites, recibes todas las monedas que permite tu plan. Las cartas sin datos de Cardmarket devuelven un array prices vacío para "eur".

Pruébalo

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}
Respuesta
{
  "id": 789,
  "tcg_player_id": 519184,
  "name": "Charizard ex",
  "image_url": "https://images.pkmnprices.com/cards/789.jpg",
  "number": "006",
  "total_set_number": "197",
  "rarity": "Double Rare",
  "artist": "PLANETA CG Works",
  "hp": 330,
  "stage": "Stage 2",
  "card_type": "Pokemon",
  "weakness": "R",
  "resistance": null,
  "retreat_cost": 2,
  "energy_type": [
    "Fire"
  ],
  "ability": "<strong>Ability — Infernal Reign</strong> ...",
  "flavor_text": null,
  "attacks": [
    "[2RR] Burning Darkness (180+) ..."
  ],
  "cardmarket_url": "https://www.cardmarket.com/en/Pokemon/Products/Singles/Obsidian-Flames/Charizard-ex-OBF006",
  "cardmarket_product_id": 733537,
  "set": {
    "id": 123,
    "name": "Obsidian Flames"
  },
  "prices": [
    {
      "source": "tcgplayer",
      "currency": "USD",
      "condition": "Near Mint",
      "variant": "Holofoil",
      "market_price": 285,
      "created_at": "2026-04-15T00:00:00Z"
    },
    {
      "source": "cardmarket",
      "currency": "EUR",
      "condition": "Near Mint",
      "variant": "Holofoil",
      "market_price": 247.5,
      "created_at": "2026-08-11T14:22:00Z"
    }
  ]
}