Cartes

Listez et filtrez 80 000+ cartes Pokémon par nom, extension, rareté, langue et prix, ou récupérez une carte avec chaque état et chaque impression sous lesquels elle se vend.

Lister les cartes

GET/v1/cards1 crédit par élément renvoyé

Recherchez et filtrez les cartes Pokémon de toutes les extensions et de toutes les langues : recherche par nom, filtre par fourchette de prix, tri. Cet endpoint ne renvoie pas de données de prix. Pour cela, récupérez une carte via GET /v1/cards/:id. Offre Free : anglais uniquement ; le japonais, l'allemand et l'espagnol nécessitent une offre payante.

Paramètres

namestring

Filtrer par nom de carte (correspondance partielle acceptée).

numberstring

Filtrer par numéro de carte dans l'extension.

total_set_numberstring

Filtrer par nombre total de cartes de l'extension (p. ex. "102" pour Base Set).

set_idstring

Filtrer par ID d'extension.

tcg_player_idinteger

Filtrer par ID de produit TCGPlayer.

languagestring

Langue de la carte (p. ex. "English", "Japanese", "German", "Spanish"). Offre Free : anglais uniquement ; le japonais, l'allemand et l'espagnol nécessitent une offre payante.

raritystring

Rareté de la carte (p. ex. "Rare Holo", "Common").

stagestring

Stade d'évolution (p. ex. "Basic", "Stage 1", "Stage 2").

card_typestring

Type de carte (p. ex. "Fire", "Water", "Trainer").

weaknessstring

Type de faiblesse (p. ex. "Water").

energy_typestring

Type d'énergie utilisé par les attaques de la carte (p. ex. "Fire"). Renvoie les cartes dont les types d'énergie incluent cette valeur.

artiststring

Nom de l'illustrateur, correspondance partielle sans tenir compte de la casse (p. ex. "arita").

hpinteger

PV exacts (p. ex. 120).

currencystring

Devise utilisée par les filtres de prix et le tri. "usd" utilise TCGPlayer ; "eur" utilise Cardmarket et nécessite l'offre Pro ou supérieure.

conditionstring

État de la carte (p. ex. "Near Mint", "Lightly Played", "Moderately Played").

variantstring

Variante de la carte (p. ex. "Normal", "Reverse Holo", "1st Edition").

gradestring

Note PSA/BGS/CGC.

min_pricenumber

Prix du marché minimum dans la devise choisie.

max_pricenumber

Prix du marché maximum dans la devise choisie.

sortstring

Ordre de tri. Une valeur parmi "price_asc", "price_desc", "name_asc", "name_desc".

pagenumber

Numéro de page pour la pagination. Par défaut : 1.

per_pagenumber

Résultats par page. 100 maximum. Par défaut : 50.

Essayer

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

Obtenir une carte

GET/v1/cards/:id1 crédit

Une carte Pokémon par ID, avec toutes les données de prix et les attributs de jeu : stade, type, PV, faiblesse, résistance, coût de retraite, type d'énergie, talent, attaques, texte d'ambiance. Ces champs supplémentaires n'existent que sur cet endpoint, pas sur les endpoints de liste.

cardmarket_url et cardmarket_product_id identifient le produit Cardmarket exact associé, quand il existe. Les prix viennent de TCGPlayer (USD) et de Cardmarket (EUR) ; choisissez la source avec le paramètre currency. Chaque objet de prix contient un seul market_price, pour son propre état et sa propre variante d'impression.

Paramètres

idintegerobligatoire

L'ID unique de la carte.

currencystring

Source et devise des prix. "usd" renvoie les prix TCGPlayer, "eur" les prix Cardmarket. Sans ce paramètre, vous recevez toutes les devises autorisées par votre offre. Les cartes sans données Cardmarket renvoient un tableau prices vide pour "eur".

Essayer

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