Cardmarket-Angebote
Aktuelle Cardmarket-Angebote in EUR für Pokémon-Karten und Sealed-Produkte, mit Cursor-Paginierung.
Aktuelle Cardmarket-Angebote
/v1/cards/:id/listings/cardmarket1 Credit pro zurückgegebenem EintragAktuelle Angebote von Cardmarket-Verkäufern, in EUR. Die Ergebnisse sind auf die Sprache des Sets der Karte beschränkt: Eine englische Karte liefert nie deutsche Angebote. Paginierung per Preis-Keyset und Cardmarkets eigene Zustandsbezeichnungen. "Reverse Holo" und "Reverse Holofoil" gelten als dieselbe Variante.
Als signiert, verändert oder gegradet markierte Angebote werden trotzdem geliefert, zählen aber nicht zum Marktpreis der Karte. grader und grade werden nach Möglichkeit aus den Verkäuferkommentaren gelesen, deshalb kann auch ein gegradetes Angebot bei beiden null zeigen. Um markierte Angebote auszulassen, übergib graded=false&signed=false&altered=false.
seller_country ist das Land des Verkäufers als zweistelliger Code oder null, wenn wir es nicht kennen. Dazu zählen Angebote, die vor Einführung des Felds erfasst wurden; sie füllen sich, sobald die jeweilige Karte aktualisiert wird.
sell_count ist die Zahl der abgeschlossenen Verkäufe des Verkäufers, wie Cardmarket sie meldet. Sie erklärt, warum ein Marktpreis über dem günstigsten Angebot liegen kann: Ein Angebot von einem Verkäufer ohne abgeschlossene Verkäufe bestimmt keinen Preis. null heißt, für die Zeile wurde keine Zahl erfasst, und das ist nicht dasselbe wie null Verkäufe; 0 heißt, Cardmarket meldet, dass der Verkäufer nichts verkauft hat.
Parameter
idstringPflichtDie eindeutige Karten-ID.
conditionstringZustand in Cardmarkets eigener Bezeichnung (z. B. "Mint", "Near Mint", "Excellent", "Good", "Light Played", "Played", "Poor").
variantstringDruckvariante (z. B. "Normal", "Holofoil", "Reverse Holofoil"). "Reverse Holo" wird ebenfalls akzeptiert.
min_pricenumberMindestpreis des Angebots (EUR).
max_pricenumberHöchstpreis des Angebots (EUR).
seller_countrystringNur Angebote von Verkäufern in diesen Ländern, als kommagetrennte ISO-3166-1-alpha-2-Codes (z. B. "IT,DE"). Groß-/Kleinschreibung egal, höchstens 30. Angebote ohne bekanntes Verkäuferland werden ausgelassen.
exclude_seller_countrystringAngebote von Verkäufern in diesen Ländern auslassen, im selben Format (z. B. "CN,HK"). Angebote ohne bekanntes Verkäuferland bleiben enthalten.
gradedboolean"true" für nur gegradete Angebote, "false" für nur ungegradete.
graderstringNur gegradete Angebote dieser Grading-Firma (z. B. "PSA", "CGC", "BGS"). Groß-/Kleinschreibung egal.
gradestringNur gegradete Angebote mit dieser Grading-Note (z. B. "10", "9.5").
signedboolean"true" für nur signierte Angebote, "false", um sie auszulassen.
alteredboolean"true" für nur veränderte Angebote, "false", um sie auszulassen.
min_sell_countintegerNur Angebote von Verkäufern mit mindestens so vielen abgeschlossenen Verkäufen. Angebote ohne erfassten sell_count fallen weg.
sortstringSortierung. Einer der Werte "price_asc", "price_desc". Standard: price_asc.
limitnumberAnzahl der Einträge pro Seite (max. 20). Standard: 20.
cursorstringOpaker Paginierungs-Cursor aus einer vorherigen Antwort.
Ausprobieren
curl -H "X-API-Key: YOUR_API_KEY" \https://api.pkmnprices.com/v1/cards/{id}/listings/cardmarket
Cardmarket-Angebote für Sealed-Produkte
/v1/sealed/:id/listings/cardmarket1 Credit pro zurückgegebenem EintragAktuelle Angebote von Cardmarket-Verkäufern für ein Sealed-Produkt, in EUR. Einen variant-Filter gibt es nicht: Jedes Sealed-Angebot wird mit leerer Variante gespeichert. Und die Ergebnisse sind nicht auf eine Sprache beschränkt: Ein Sealed-Produkt hat seine eigenen Angebote, statt sich einen Cardmarket-Artikel mit anderen Sprachen zu teilen. Prüf deshalb das Feld language in jeder Zeile. Auch condition ist hier meist null.
Als signiert, verändert, gegradet oder geöffnet markierte Angebote werden trotzdem geliefert, zählen aber nicht zum Marktpreis. Um sie auszulassen, übergib graded=false&signed=false&altered=false&opened=false.
seller_country ist das Land des Verkäufers als zweistelliger Code oder null, wenn wir es nicht kennen. Dazu zählen Angebote, die vor Einführung des Felds erfasst wurden; sie füllen sich, sobald die jeweilige Karte aktualisiert wird.
sell_count ist die Zahl der abgeschlossenen Verkäufe des Verkäufers, wie Cardmarket sie meldet. Sie erklärt, warum ein Marktpreis über dem günstigsten Angebot liegen kann: Ein Angebot von einem Verkäufer ohne abgeschlossene Verkäufe bestimmt keinen Preis. null heißt, für die Zeile wurde keine Zahl erfasst, und das ist nicht dasselbe wie null Verkäufe; 0 heißt, Cardmarket meldet, dass der Verkäufer nichts verkauft hat.
Parameter
idstringPflichtDie eindeutige ID des Sealed-Produkts.
conditionstringZustand in Cardmarkets eigener Bezeichnung. Hier selten nützlich, denn Sealed-Angebote haben meist keinen Zustand.
min_pricenumberMindestpreis des Angebots (EUR).
max_pricenumberHöchstpreis des Angebots (EUR).
seller_countrystringNur Angebote von Verkäufern in diesen Ländern, als kommagetrennte ISO-3166-1-alpha-2-Codes (z. B. "IT,DE"). Groß-/Kleinschreibung egal, höchstens 30. Angebote ohne bekanntes Verkäuferland werden ausgelassen.
exclude_seller_countrystringAngebote von Verkäufern in diesen Ländern auslassen, im selben Format (z. B. "CN,HK"). Angebote ohne bekanntes Verkäuferland bleiben enthalten.
gradedboolean"true" für nur gegradete Angebote, "false" für nur ungegradete.
graderstringNur gegradete Angebote dieser Grading-Firma (z. B. "PSA", "CGC", "BGS"). Groß-/Kleinschreibung egal.
gradestringNur gegradete Angebote mit dieser Grading-Note (z. B. "10", "9.5").
signedboolean"true" für nur signierte Angebote, "false", um sie auszulassen.
alteredboolean"true" für nur veränderte Angebote, "false", um sie auszulassen.
min_sell_countintegerNur Angebote von Verkäufern mit mindestens so vielen abgeschlossenen Verkäufen. Angebote ohne erfassten sell_count fallen weg.
openedboolean"true" für Angebote, bei denen der Verkäufer sagt, dass das Produkt nicht versiegelt ist, "false", um sie auszulassen.
sortstringSortierung. Einer der Werte "price_asc", "price_desc". Standard: price_asc.
limitnumberAnzahl der Einträge pro Seite (max. 20). Standard: 20.
cursorstringOpaker Paginierungs-Cursor aus einer vorherigen Antwort.
Ausprobieren
curl -H "X-API-Key: YOUR_API_KEY" \https://api.pkmnprices.com/v1/sealed/{id}/listings/cardmarket