Ventes eBay

Ventes eBay individuelles, gradées et non gradées, de cartes et de produits scellés Pokémon, chacune avec un lien vers l'annonce d'origine.

Ventes eBay

GET/v1/cards/:id/listings/ebay1 crédit par élément renvoyé

Ventes eBay récentes d'une carte, gradées et non gradées. Chaque ligne porte sa propre devise ("USD" ou "EUR") : lisez-la ligne par ligne au lieu de supposer USD. Pagination par curseur pour les gros volumes de résultats.

attribution vaut "exact", "shared" ou "unknown". Une variante peut partager une même page source avec sa carte de base ; dans ce cas, les deux reçoivent les mêmes ventes, intitulées selon l'impression réellement vendue. "shared" signale ces lignes comme des indices pour le groupe, pas pour cette carte en particulier. "unknown" signifie que la vente date d'avant que nous enregistrions l'impression dont elle provient.

Pour récupérer les nouvelles ventes, retenez le plus grand ingested_at que vous avez vu et renvoyez-le dans since. C'est l'heure de collecte, pas sold_at : une collecte peut ramener des ventes vieilles de plusieurs semaines, qu'un filtre sur la date de vente ignorerait. La borne est exclusive et l'horodatage se termine déjà par Z, vous pouvez donc le placer tel quel dans la query string. Pour estimer un prix à partir des ventes récentes, passez plutôt period=90d, qui filtre sur sold_at.

grade_qualifier nomme le palier lorsqu'un grader en émet plusieurs pour la même note : "Pristine" est une CGC Pristine 10, et "Black Label" une BGS Black Label 10. Il vaut null pour tout le reste, y compris une CGC Gem Mint 10 et une BGS 10 ordinaire. grade reste "10" pour tous, donc grade=10 renvoie tous les paliers. Pour n'en obtenir qu'un, utilisez le filtre grade_qualifier : grader=BGS&grade=10&grade_qualifier=black_label renvoie les Black Label, et grade_qualifier=none les BGS 10 classiques. Une Pristine 10 se vend souvent nettement au-dessus d'une Gem Mint 10.

sale_type indique comment l'article s'est vendu : "auction", "fixed_price" ou "best_offer_accepted". Le prix fixe inclut les annonces qui acceptaient les offres mais se sont vendues au prix affiché. Pour "best_offer_accepted", price est ce que l'acheteur a payé, relevé sur la page de l'article car les résultats de recherche d'eBay n'affichent que le prix demandé. Les annonces à plusieurs exemplaires vendues par offre sont exclues, leur page n'affichant aucun montant accepté. sale_type vaut null pour les ventes collectées avant son existence, si bien qu'une ligne null peut encore porter le prix demandé d'une offre acceptée. Il vaut aussi null pour les ventes reprises de PriceCharting et pour les ventes de produits scellés.

seller_country est la localisation du vendeur sous forme de code ISO à deux lettres, comme "US", "JP" ou "GB". Porto Rico est "PR", donc seller_country=US,PR couvre les deux. Il vaut null quand nous ne connaissons pas la localisation : anciennes ventes, certaines ventes reprises de PriceCharting et localisations que nous ne savons pas rattacher à un pays.

Paramètres

idstringobligatoire

L'ID unique de la carte.

gradedboolean

true = gradées uniquement ; false = non gradées uniquement ; omis = les deux. Les deux valeurs sont exactement complémentaires : chaque vente est renvoyée par une seule des deux.

graderstring

Filtre par société de gradation (p. ex. "PSA", "BGS", "CGC").

gradestring

Filtre par note (p. ex. "10", "9.5", "9").

grade_qualifierstring

Uniquement les ventes d'un palier de leur note : "pristine" (CGC Pristine 10), "black_label" (BGS Black Label 10) ou "none" pour les ventes sans palier nommé, ce qui inclut les CGC et BGS 10 classiques. "none" renvoie aussi les ventes collectées avant que nous enregistrions le palier.

sale_typestring

Uniquement les ventes conclues de cette façon, sous forme de valeurs séparées par des virgules parmi "auction", "fixed_price" et "best_offer_accepted" (p. ex. "auction,best_offer_accepted"). Insensible à la casse. Les ventes sans type de vente connu sont exclues : passer les trois valeurs renvoie donc toutes les ventes dont le type est connu. Une valeur inconnue renvoie 400.

seller_countrystring

Uniquement les ventes de vendeurs de ces pays, sous forme de codes ISO 3166-1 alpha-2 séparés par des virgules (p. ex. "US,JP"). Insensible à la casse, 30 au maximum. Les ventes sans pays vendeur connu sont exclues.

exclude_seller_countrystring

Exclut les ventes de vendeurs de ces pays, au même format (p. ex. "CN,HK"). Les ventes sans pays vendeur connu restent incluses.

min_pricenumber

Prix de vente minimum.

max_pricenumber

Prix de vente maximum.

variantstring

Filtrer par l'impression sous laquelle la vente a été collectée (p. ex. "Holofoil", "Reverse Holofoil").

sincestring

Uniquement les ventes collectées après cet instant. Accepte un horodatage RFC 3339 ou YYYY-MM-DD (minuit UTC). Une valeur mal formée renvoie 400 au lieu d'être ignorée. Filtre sur ingested_at, pas sur sold_at.

periodstring

Uniquement les ventes des N derniers jours : "90d", ou simplement "90" (1 à 365). Filtre sur sold_at, alors que since filtre sur ingested_at.

sortstring

Ordre de tri. Une valeur parmi "date_desc", "date_asc", "price_desc", "price_asc". Par défaut : date_desc.

limitnumber

Nombre d'annonces renvoyées par page (20 maximum). Par défaut : 20.

cursorstring

Curseur de pagination renvoyé par une réponse précédente.

Essayer

Clé API

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

Réponse

{
  "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
  }
}

Ventes eBay de produits scellés

GET/v1/sealed/:id/listings/ebay1 crédit par élément renvoyé

Ventes eBay récentes d'un produit scellé. currency vaut toujours "USD" ici. Même structure que pour les cartes, sans les filtres de gradation. Pagination par curseur. Offres payantes uniquement.

attribution a le même sens, mais un produit scellé correspond à une seule page source, sans impression à distinguer : la valeur décrit donc tout le produit et reste identique sur chaque ligne. variant vaut toujours null ; il n'y a pas de filtre variant.