eBay-Verkäufe

Einzelne gegradete und ungegradete eBay-Verkäufe von Pokémon-Karten und Sealed-Produkten, jeweils mit Link auf das Angebot, aus dem sie stammen.

eBay-Verkäufe

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

Die neuesten eBay-Verkäufe einer Karte, gegradet und ungegradet. Jede Zeile trägt ihre eigene Währung ("USD" oder "EUR"): Lies sie pro Zeile, statt USD anzunehmen. Cursor-basierte Paginierung für große Ergebnismengen.

attribution ist "exact", "shared" oder "unknown". Eine Variante kann sich eine Quellseite mit ihrer Basiskarte teilen; dann bekommen beide dieselben Verkäufe, betitelt nach dem Druck, der tatsächlich verkauft wurde. "shared" markiert diese Zeilen als Beleg für die Gruppe, nicht speziell für diese Karte. "unknown" heißt, dass der Verkauf aus der Zeit stammt, bevor wir erfasst haben, zu welchem Druck er gehört.

Um neue Verkäufe abzufragen, merk dir den höchsten ingested_at-Wert, den du gesehen hast, und übergib ihn als since. Das ist der Zeitpunkt der Erfassung, nicht sold_at: Ein Erfassungslauf kann Wochen alte Verkäufe hereinholen, und ein Filter nach Verkaufsdatum würde sie überspringen. Die Grenze ist exklusiv, und der Zeitstempel endet bereits auf Z, du kannst ihn also direkt in den Query-String setzen. Um stattdessen nach aktuellen Verkäufen zu bepreisen, übergib period=90d; das filtert auf sold_at.

grade_qualifier nennt die Stufe, wenn ein Grader auf derselben Note mehr als eine vergibt: "Pristine" ist eine CGC Pristine 10, "Black Label" eine BGS Black Label 10. Bei allem anderen ist der Wert null, auch bei CGC Gem Mint 10 und einer normalen BGS 10. grade steht bei allen weiterhin auf "10", grade=10 liefert also jede Stufe. Für eine einzelne Stufe nutze den Filter grade_qualifier: grader=BGS&grade=10&grade_qualifier=black_label liefert Black Labels, grade_qualifier=none normale BGS 10. Eine Pristine 10 verkauft sich meist deutlich über einer Gem Mint 10.

sale_type gibt an, wie der Artikel verkauft wurde: "auction", "fixed_price" oder "best_offer_accepted". Festpreis umfasst Angebote, die Preisvorschläge erlaubten, aber zum Angebotspreis verkauft wurden. Bei "best_offer_accepted" ist price der Betrag, den der Käufer gezahlt hat; den lesen wir von der Artikelseite ab, weil die eBay-Suchergebnisse nur den Angebotspreis zeigen. Angebote mit mehreren Exemplaren, die per Preisvorschlag verkauft wurden, fehlen, da ihre Seite keinen akzeptierten Betrag zeigt. sale_type ist null bei Verkäufen, die vor seiner Einführung erfasst wurden; eine Zeile mit null kann also trotzdem den Angebotspreis eines akzeptierten Vorschlags tragen. Null ist es auch bei Verkäufen, die von PriceCharting übernommen wurden, und bei Sealed-Verkäufen.

seller_country ist der Standort des Verkäufers als zweistelliger ISO-Code wie "US", "JP" oder "GB". Puerto Rico ist "PR", daher deckt seller_country=US,PR beide ab. Es ist null, wenn wir den Standort nicht kennen: bei älteren Verkäufen, einigen von PriceCharting übernommenen Verkäufen und Standorten, die wir keinem Land zuordnen können.

Parameter

idstringPflicht

Die eindeutige Karten-ID.

gradedboolean

true = nur gegradet; false = nur ungegradet; weglassen = beides. Die beiden Werte ergänzen sich exakt: Jeder Verkauf wird von genau einem der beiden geliefert.

graderstring

Filter nach Grading-Firma (z. B. "PSA", "BGS", "CGC").

gradestring

Filter nach Grading-Note (z. B. "10", "9.5", "9").

grade_qualifierstring

Nur Verkäufe einer Stufe ihrer Note: "pristine" (CGC Pristine 10), "black_label" (BGS Black Label 10) oder "none" für Verkäufe ohne benannte Stufe, also auch normale CGC- und BGS-10. "none" liefert außerdem Verkäufe, die erfasst wurden, bevor wir die Stufe gespeichert haben.

sale_typestring

Nur Verkäufe, die auf diese Weise zustande kamen, als kommagetrennte Werte aus "auction", "fixed_price" und "best_offer_accepted" (z. B. "auction,best_offer_accepted"). Groß-/Kleinschreibung egal. Verkäufe ohne bekannte Verkaufsart werden ausgelassen; wer alle drei Werte angibt, erhält also jeden Verkauf mit bekannter Verkaufsart. Ein unbekannter Wert liefert 400.

seller_countrystring

Nur Verkäufe von Verkäufern in diesen Ländern, als kommagetrennte ISO-3166-1-alpha-2-Codes (z. B. "US,JP"). Groß-/Kleinschreibung egal, höchstens 30. Verkäufe ohne bekanntes Verkäuferland werden ausgelassen.

exclude_seller_countrystring

Verkäufe von Verkäufern in diesen Ländern auslassen, im selben Format (z. B. "CN,HK"). Verkäufe ohne bekanntes Verkäuferland bleiben enthalten.

min_pricenumber

Mindest-Verkaufspreis.

max_pricenumber

Höchst-Verkaufspreis.

variantstring

Nach dem Druck filtern, unter dem der Verkauf erfasst wurde (z. B. "Holofoil", "Reverse Holofoil").

sincestring

Nur Verkäufe, die nach diesem Zeitpunkt erfasst wurden. Akzeptiert einen RFC-3339-Zeitstempel oder YYYY-MM-DD (Mitternacht UTC). Ein ungültiger Wert liefert 400, statt ignoriert zu werden. Filtert auf ingested_at, nicht auf sold_at.

periodstring

Nur Verkäufe aus den letzten N Tagen: "90d" oder einfach "90" (1 bis 365). Filtert auf sold_at, während since auf ingested_at filtert.

sortstring

Sortierung. Einer der Werte "date_desc", "date_asc", "price_desc", "price_asc". Standard: date_desc.

limitnumber

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

cursorstring

Paginierungs-Cursor aus einer vorherigen Antwort.

Ausprobieren

API-Schlüssel

id *

graded

grader

grade

grade_qualifier

sale_type

seller_country

exclude_seller_country

min_price

max_price

variant

since

period

sort

limit

cursor

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

Antwort

{
  "data": [
    {
      "id": 5678,
      "title": "PSA 10 Charizard ex 006/197 Obsidian Flames",
      "price": 275,
      "currency": "USD",
      "sale_type": "fixed_price",
      "grader": "PSA",
      "grade": "10",
      "grade_qualifier": null,
      "variant": "Holofoil",
      "attribution": "exact",
      "sold_at": "2025-01-14",
      "ingested_at": "2025-01-16T04:12:07Z",
      "listing_url": "https://www.ebay.com/itm/123456789012",
      "seller_country": "US"
    },
    {
      "id": 5680,
      "title": "CGC Pristine 10 Charizard ex 006/197 Obsidian Flames",
      "price": 610,
      "currency": "USD",
      "sale_type": "auction",
      "grader": "CGC",
      "grade": "10",
      "grade_qualifier": "Pristine",
      "variant": "Holofoil",
      "attribution": "exact",
      "sold_at": "2025-01-14",
      "ingested_at": "2025-01-16T04:12:07Z",
      "listing_url": "https://www.ebay.com/itm/123456789015",
      "seller_country": "JP"
    },
    {
      "id": 5679,
      "title": "Charizard ex 006/197 Obsidian Flames",
      "price": 42.5,
      "currency": "USD",
      "sale_type": null,
      "grader": null,
      "grade": null,
      "grade_qualifier": null,
      "variant": "Holofoil",
      "attribution": "shared",
      "sold_at": "2025-01-13",
      "ingested_at": "2025-01-16T04:12:07Z",
      "listing_url": "https://www.ebay.com/itm/123456789013",
      "seller_country": null
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "NTY3OQ==",
    "count": 20
  }
}

eBay-Verkäufe für Sealed-Produkte

GET/v1/sealed/:id/listings/ebay1 Credit pro zurückgegebenem Eintrag

Die neuesten eBay-Verkäufe eines Sealed-Produkts. currency ist hier immer "USD". Gleiche Struktur wie bei den Karten, nur ohne die Grading-Filter. Cursor-basierte Paginierung. Nur in kostenpflichtigen Tarifen.

attribution bedeutet dasselbe, aber ein Sealed-Produkt gehört zu genau einer Quellseite, ohne Druck, den man unterscheiden müsste. Der Wert beschreibt also das ganze Produkt und ist in jeder Zeile gleich. variant ist immer null; einen variant-Filter gibt es nicht.