Annonces TCGplayer

Offres TCGplayer en direct, en USD, pour les cartes et les produits scellés Pokémon, avec pagination par curseur.

Annonces TCGplayer en direct

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

Offres en direct de la marketplace TCGplayer pour une carte : prix demandés actuels en USD, pas des ventes conclues. Inclut la réputation du vendeur (note, nombre de ventes, badges Gold/Direct/Verified) et les frais de port. Pagination par curseur.

updated_at n'indique pas la fraîcheur des données. Il ne change que lorsque le prix, la quantité ou les informations vendeur de l'annonce elle-même changent : une annonce inchangée garde un horodatage vieux d'un mois, même si nous l'avons vérifiée récemment. Utilisez plutôt snapshot_at : le moment où les annonces du produit ont été confirmées pour la dernière fois auprès de TCGplayer, avec la même valeur sur chaque ligne d'une réponse. Les annonces sont actualisées chaque jour : un snapshot_at de plus d'un jour signifie que la dernière récupération a échoué et que vous voyez le snapshot précédent. Il vaut null si aucun snapshot n'a réussi depuis l'ajout du champ.

Nous collectons depuis les États-Unis, sans filtre de destination de livraison : un snapshot peut donc inclure des offres que le site de TCGplayer masque à un visiteur situé hors des États-Unis.

Un snapshot contient au plus les 500 annonces en stock les moins chères, en anglais, triées par prix plus frais de port au moment de la collecte. Au-delà, quantity additionne ces 500 annonces, pas la Current Quantity de TCGplayer. price_asc (par défaut) trie par prix de l'article ; total_asc reproduit l'ordre du site.

Paramètres

idstringobligatoire

L'ID unique de la carte.

conditionstring

Filtre d'état (p. ex. "Near Mint", "Lightly Played", "Moderately Played").

languagestring

Filtre de langue de l'annonce (p. ex. "English", "German", "Japanese"). Il s'agit de la langue de l'offre sur la marketplace, pas de celle de la carte.

printingstring

Filtre d'impression/variante (p. ex. "Holofoil", "Normal", "Reverse Holofoil").

min_pricenumber

Prix minimum de l'offre (USD).

max_pricenumber

Prix maximum de l'offre (USD).

sortstring

Ordre de tri. Une valeur parmi "price_asc", "price_desc", "total_asc", "total_desc". Les tris price ordonnent par prix de l'article seul. Les tris total ordonnent par prix plus shipping_price, c'est-à-dire ce que paie l'acheteur, l'ordre du site de TCGplayer et l'ordre dans lequel le snapshot a été collecté : total_asc reproduit donc la liste du site, et sa première ligne est réellement l'offre la moins chère. Un curseur est lié à la famille de tri sous laquelle il a été émis ; réutiliser un curseur total sous un tri price, ou l'inverse, renvoie 400. min_price et max_price filtrent sur le prix de l'article quel que soit le tri. Par défaut : price_asc.

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 *

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

Réponse

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

Annonces TCGplayer de produits scellés

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

Offres en direct de la marketplace TCGplayer pour un produit scellé : prix demandés actuels en USD, pas des ventes conclues. Même structure, mêmes filtres et même pagination par curseur que l'endpoint des cartes. Les offres de produits scellés ont normalement l'état "Unopened" et une impression vide, donc ces deux filtres affinent rarement quoi que ce soit ici.

snapshot_at fonctionne comme pour l'endpoint des cartes : lisez snapshot_at pour la fraîcheur, pas updated_at.