Karten

80.000+ Pokémon-Karten nach Name, Set, Seltenheit, Sprache und Preis auflisten und filtern, oder eine Karte mit jedem Zustand und Druck abrufen, in dem sie verkauft wird.

Karten auflisten

GET/v1/cards1 Credit pro zurückgegebenem Eintrag

Pokémon-Karten über alle Sets und Sprachen hinweg suchen und filtern: Namenssuche, Filter nach Preisspanne, Sortierung. Preisdaten liefert dieser Endpoint nicht. Die bekommst du über GET /v1/cards/:id für eine einzelne Karte. Im Free-Tarif nur Englisch; Japanisch, Deutsch und Spanisch brauchen einen kostenpflichtigen Tarif.

Parameter

namestring

Nach Kartennamen filtern (Teiltreffer möglich).

numberstring

Nach Kartennummer innerhalb des Sets filtern.

total_set_numberstring

Nach der Gesamtzahl des Sets filtern (z. B. "102" für Base Set).

set_idstring

Nach Set-ID filtern.

tcg_player_idinteger

Nach TCGPlayer-Produkt-ID filtern.

languagestring

Kartensprache (z. B. "English", "Japanese", "German", "Spanish"). Im Free-Tarif nur Englisch; Japanisch, Deutsch und Spanisch erfordern einen kostenpflichtigen Tarif.

raritystring

Seltenheit der Karte (z. B. "Rare Holo", "Common").

stagestring

Entwicklungsstufe (z. B. "Basic", "Stage 1", "Stage 2").

card_typestring

Kartentyp (z. B. "Fire", "Water", "Trainer").

weaknessstring

Typ der Schwäche (z. B. "Water").

energy_typestring

Energietyp, den die Attacken der Karte nutzen (z. B. "Fire"). Trifft auf Karten zu, deren Energietypen den Wert enthalten.

artiststring

Name des Illustrators, Teiltreffer ohne Beachtung der Groß-/Kleinschreibung (z. B. "arita").

hpinteger

Exakte KP (z. B. 120).

currencystring

Währung für Preisfilter und Sortierung. "usd" nutzt TCGPlayer; "eur" nutzt Cardmarket und erfordert Pro oder höher.

conditionstring

Zustand der Karte (z. B. "Near Mint", "Lightly Played", "Moderately Played").

variantstring

Variante der Karte (z. B. "Normal", "Reverse Holo", "1st Edition").

gradestring

Grading-Note von PSA/BGS/CGC.

min_pricenumber

Mindest-Marktpreis in der gewählten Währung.

max_pricenumber

Höchst-Marktpreis in der gewählten Währung.

sortstring

Sortierung. Einer der Werte "price_asc", "price_desc", "name_asc", "name_desc".

pagenumber

Seitennummer für die Paginierung. Standard: 1.

per_pagenumber

Ergebnisse pro Seite. Maximal 100. Standard: 50.

Ausprobieren

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

Karte abrufen

GET/v1/cards/:id1 Credit

Eine einzelne Pokémon-Karte per ID, mit allen Preisdaten und Spielattributen: Stufe, Typ, KP, Schwäche, Resistenz, Rückzugskosten, Energietyp, Fähigkeit, Attacken, Flavor-Text. Diese zusätzlichen Felder gibt es nur bei diesem Endpoint, nicht bei den Listen-Endpoints.

cardmarket_url und cardmarket_product_id kennzeichnen das genau zugeordnete Cardmarket-Produkt, falls es eines gibt. Die Preise kommen von TCGPlayer (USD) und Cardmarket (EUR); die Quelle wählst du mit dem Parameter currency. Jedes Preisobjekt enthält genau einen market_price für seinen eigenen Zustand und seine Druckvariante.

Parameter

idintegerPflicht

Die eindeutige Karten-ID.

currencystring

Preisquelle/Währung. "usd" liefert TCGPlayer-Preise, "eur" liefert Cardmarket-Preise. Lässt du den Parameter weg, bekommst du alle Währungen, die dein Tarif erlaubt. Karten ohne Cardmarket-Daten liefern bei "eur" ein leeres prices-Array.

Ausprobieren

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