Inserzioni TCGplayer

Offerte TCGplayer in tempo reale, in USD, per carte e prodotti sigillati Pokémon, con paginazione a cursore.

Inserzioni TCGplayer in tempo reale

GET/v1/cards/:id/listings/tcgplayer1 credito per elemento restituito

Offerte in tempo reale sul marketplace TCGplayer per una carta: prezzi richiesti attuali in USD, non vendite concluse. Include la reputazione del venditore (valutazione, numero di vendite, badge Gold/Direct/Verified) e il costo di spedizione. Paginazione a cursore.

updated_at non dice quanto sono aggiornati i dati. Cambia solo quando cambiano prezzo, quantità o dati del venditore dell'inserzione stessa, quindi un'inserzione invariata mantiene un timestamp vecchio di un mese, per quanto di recente l'abbiamo controllata. Usa invece snapshot_at: il momento in cui le inserzioni del prodotto sono state confermate l'ultima volta su TCGplayer, lo stesso valore su ogni riga di una risposta. Le inserzioni si aggiornano ogni giorno, quindi uno snapshot_at più vecchio di un giorno significa che l'ultimo recupero non è riuscito e stai vedendo lo snapshot precedente. È null se nessuno snapshot è andato a buon fine da quando il campo è stato introdotto.

Raccogliamo dagli Stati Uniti senza filtro sulla destinazione di spedizione, quindi uno snapshot può includere offerte che il sito di TCGplayer nasconde a chi naviga da fuori degli Stati Uniti.

Uno snapshot contiene al massimo le 500 inserzioni disponibili più economiche, in inglese, ordinate per prezzo più spedizione al momento della raccolta. Oltre questa soglia, quantity somma quelle 500 inserzioni, non la Current Quantity di TCGplayer. price_asc (predefinito) ordina per prezzo dell'articolo; total_asc corrisponde all'ordine del sito.

Parametri

idstringobbligatorio

L'ID univoco della carta.

conditionstring

Filtro per condizione (es. "Near Mint", "Lightly Played", "Moderately Played").

languagestring

Filtro per lingua dell'inserzione (es. "English", "German", "Japanese"). È la lingua dell'offerta sul marketplace, non quella della carta.

printingstring

Filtro per stampa/variante (es. "Holofoil", "Normal", "Reverse Holofoil").

min_pricenumber

Prezzo minimo dell'offerta (USD).

max_pricenumber

Prezzo massimo dell'offerta (USD).

sortstring

Ordinamento. Uno tra "price_asc", "price_desc", "total_asc", "total_desc". Gli ordinamenti price ordinano solo per prezzo dell'articolo. Gli ordinamenti total ordinano per prezzo più shipping_price, cioè quanto paga l'acquirente, l'ordine in cui il sito di TCGplayer mostra le offerte e l'ordine in cui è stato raccolto lo snapshot: total_asc riproduce quindi l'elenco del sito, e la sua prima riga è davvero l'offerta più economica. Un cursore è legato alla famiglia di ordinamento con cui è stato emesso; riusare un cursore total con un ordinamento price, o viceversa, restituisce 400. min_price e max_price filtrano sul prezzo dell'articolo con qualsiasi ordinamento. Predefinito: price_asc.

limitnumber

Numero di inserzioni per pagina (massimo 20). Predefinito: 20.

cursorstring

Cursore di paginazione restituito da una risposta precedente.

Provalo

Chiave 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

Risposta

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

Inserzioni TCGplayer di prodotti sigillati

GET/v1/sealed/:id/listings/tcgplayer1 credito per elemento restituito

Offerte in tempo reale sul marketplace TCGplayer per un prodotto sigillato: prezzi richiesti attuali in USD, non vendite concluse. Stessa struttura, filtri e paginazione a cursore dell'endpoint delle carte. Le offerte di prodotti sigillati hanno normalmente la condizione "Unopened" e una stampa vuota, quindi quei due filtri qui restringono raramente qualcosa.

snapshot_at funziona come nell'endpoint delle carte: per sapere quanto sono aggiornati i dati guarda snapshot_at, non updated_at.