Carte

Elenca e filtra 80.000+ carte Pokémon per nome, espansione, rarità, lingua e prezzo, oppure recupera una carta con ogni condizione e stampa in cui viene venduta.

Elenca carte

GET/v1/cards1 credito per elemento restituito

Cerca e filtra le carte Pokémon di tutte le espansioni e lingue: ricerca per nome, filtro per fascia di prezzo, ordinamento. Non restituisce dati di prezzo: per quelli, recupera una singola carta con GET /v1/cards/:id. Piano Free: solo inglese; giapponese, tedesco e spagnolo richiedono un piano a pagamento.

Parametri

namestring

Filtra per nome della carta (supporta corrispondenze parziali).

numberstring

Filtra per numero della carta nell'espansione.

total_set_numberstring

Filtra per numero totale dell'espansione (es. "102" per Base Set).

set_idstring

Filtra per ID dell'espansione.

tcg_player_idinteger

Filtra per ID prodotto TCGPlayer.

languagestring

Lingua della carta (es. "English", "Japanese", "German", "Spanish"). Piano Free: solo inglese; giapponese, tedesco e spagnolo richiedono un piano a pagamento.

raritystring

Rarità della carta (es. "Rare Holo", "Common").

stagestring

Fase evolutiva (es. "Basic", "Stage 1", "Stage 2").

card_typestring

Tipo di carta (es. "Fire", "Water", "Trainer").

weaknessstring

Tipo di debolezza (es. "Water").

energy_typestring

Tipo di Energia usato dagli attacchi della carta (es. "Fire"). Restituisce le carte i cui tipi di Energia includono il valore.

artiststring

Nome dell'illustratore, corrispondenza parziale senza distinzione tra maiuscole e minuscole (es. "arita").

hpinteger

PS esatti (es. 120).

currencystring

Valuta usata dai filtri di prezzo e dall'ordinamento. "usd" usa TCGPlayer; "eur" usa Cardmarket e richiede Pro o superiore.

conditionstring

Condizione della carta (es. "Near Mint", "Lightly Played", "Moderately Played").

variantstring

Variante della carta (es. "Normal", "Reverse Holo", "1st Edition").

gradestring

Voto PSA/BGS/CGC.

min_pricenumber

Prezzo di mercato minimo nella valuta selezionata.

max_pricenumber

Prezzo di mercato massimo nella valuta selezionata.

sortstring

Ordinamento. Uno tra "price_asc", "price_desc", "name_asc", "name_desc".

pagenumber

Numero di pagina per la paginazione. Predefinito: 1.

per_pagenumber

Risultati per pagina. Massimo 100. Predefinito: 50.

Provalo

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards
Risposta
{
  "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
  }
}

Ottieni carta

GET/v1/cards/:id1 credito

Una singola carta Pokémon per ID, con tutti i dati di prezzo e gli attributi di gioco: fase, tipo, PS, debolezza, resistenza, costo di ritirata, tipo di Energia, abilità, attacchi, testo descrittivo. Questi campi extra esistono solo su questo endpoint, non sugli endpoint di elenco.

cardmarket_url e cardmarket_product_id identificano il prodotto Cardmarket esatto associato, quando esiste. I prezzi provengono da TCGPlayer (USD) e Cardmarket (EUR); scegli la fonte con il parametro currency. Ogni oggetto prezzo contiene un solo market_price per la propria condizione e variante di stampa.

Parametri

idintegerobbligatorio

L'ID univoco della carta.

currencystring

Fonte e valuta del prezzo. "usd" restituisce i prezzi TCGPlayer, "eur" quelli Cardmarket. Se lo ometti, ricevi tutte le valute consentite dal tuo piano. Le carte senza dati Cardmarket restituiscono un array prices vuoto per "eur".

Provalo

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}
Risposta
{
  "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"
    }
  ]
}