TCGplayer-Angebote

Aktuelle TCGplayer-Angebote in USD für Pokémon-Karten und Sealed-Produkte, mit Cursor-Paginierung.

Aktuelle TCGplayer-Angebote

GET/v1/cards/:id/listings/tcgplayer1 Credit pro zurückgegebenem Eintrag

Aktuelle Angebote auf dem TCGplayer-Marktplatz für eine Karte: derzeitige Angebotspreise in USD, keine abgeschlossenen Verkäufe. Enthält die Reputation des Verkäufers (Bewertung, Anzahl der Verkäufe, Gold/Direct/Verified-Abzeichen) und die Versandkosten. Cursor-basierte Paginierung.

updated_at sagt nichts über die Aktualität aus. Der Wert ändert sich nur, wenn sich Preis, Menge oder Verkäuferangaben des Angebots selbst ändern. Ein unverändertes Angebot behält also einen Monat alten Zeitstempel, egal wie kürzlich wir es geprüft haben. Nimm stattdessen snapshot_at: den Zeitpunkt, zu dem die Angebote des Produkts zuletzt mit TCGplayer abgeglichen wurden, in jeder Zeile einer Antwort derselbe Wert. Angebote werden täglich aktualisiert. Ist snapshot_at älter als einen Tag, ist der letzte Abruf fehlgeschlagen und du siehst den vorherigen Snapshot. Der Wert ist null, wenn seit Einführung des Feldes noch kein Snapshot gelungen ist.

Wir erfassen von einem Standort in den USA aus, ohne Filter für das Versandziel. Ein Snapshot kann deshalb Angebote enthalten, die TCGplayers eigene Seite vor Besuchern außerhalb der USA verbirgt.

Ein Snapshot enthält höchstens die 500 günstigsten vorrätigen englischsprachigen Angebote, sortiert nach Preis plus Versand zum Zeitpunkt der Erfassung. Darüber hinaus summiert quantity nur diese 500 Angebote, nicht TCGplayers eigene Current Quantity. price_asc (Standard) sortiert nach Artikelpreis; total_asc entspricht der Reihenfolge der Seite selbst.

Parameter

idstringPflicht

Die eindeutige Karten-ID.

conditionstring

Zustandsfilter (z. B. "Near Mint", "Lightly Played", "Moderately Played").

languagestring

Filter nach Angebotssprache (z. B. "English", "German", "Japanese"). Das ist die Sprache des Marktplatz-Angebots, nicht der Karte.

printingstring

Filter nach Druck/Variante (z. B. "Holofoil", "Normal", "Reverse Holofoil").

min_pricenumber

Mindestpreis des Angebots (USD).

max_pricenumber

Höchstpreis des Angebots (USD).

sortstring

Sortierung. Einer der Werte "price_asc", "price_desc", "total_asc", "total_desc". Die price-Sortierungen ordnen nur nach Artikelpreis. Die total-Sortierungen ordnen nach Preis plus shipping_price: Das ist, was ein Käufer zahlt, so ordnet TCGplayers eigene Seite die Angebote, und in dieser Reihenfolge wurde der Snapshot erfasst. total_asc gibt also die Liste der Seite wieder, und die erste Zeile ist das tatsächlich günstigste Angebot. Ein Cursor ist an die Sortierfamilie gebunden, unter der er ausgegeben wurde; einen total-Cursor unter einer price-Sortierung zu verwenden oder umgekehrt liefert 400. min_price und max_price filtern bei jeder Sortierung nach Artikelpreis. Standard: price_asc.

limitnumber

Anzahl der Einträge pro Seite (max. 20). Standard: 20.

cursorstring

Paginierungs-Cursor aus einer vorherigen Antwort.

Ausprobieren

API-Schlüssel

id *

condition

language

printing

min_price

max_price

sort

limit

cursor

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}/listings/tcgplayer

Antwort

{
  "data": [
    {
      "id": 7890,
      "listing_id": 1234567890,
      "printing": "Holofoil",
      "condition": "Near Mint",
      "language": "English",
      "price": 279.99,
      "shipping_price": 0,
      "seller_name": "TopTierCards",
      "seller_id": "a1b2c3d4",
      "seller_rating": 99.8,
      "seller_sales": "50,000+",
      "quantity": 3,
      "listing_type": "standard",
      "direct_seller": true,
      "gold_seller": true,
      "verified_seller": true,
      "custom_title": "PSA-ready, pack fresh",
      "updated_at": "2026-06-10T14:22:00+00:00",
      "snapshot_at": "2026-09-03T02:41:12Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "Nzg5MA==",
    "count": 20
  }
}