Vendite eBay

Singole vendite eBay, gradate e non gradate, di carte e prodotti sigillati Pokémon, ognuna con il link all'inserzione da cui proviene.

Vendite eBay

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

Vendite eBay recenti per una carta, gradate e non gradate. Ogni riga ha la propria valuta ("USD" o "EUR"): leggila riga per riga invece di dare per scontato USD. Paginazione a cursore per insiemi di risultati grandi.

attribution vale "exact", "shared" o "unknown". Una variante può condividere una pagina di origine con la carta base; in quel caso entrambe ricevono le stesse vendite, intitolate secondo la stampa effettivamente venduta. "shared" indica che quelle righe valgono come riferimento per il gruppo, non per questa carta in particolare. "unknown" significa che la vendita risale a prima che registrassimo da quale stampa proveniva.

Per interrogare le nuove vendite, tieni traccia dell'ingested_at più alto che hai visto e ripassalo come since. È l'ora di raccolta, non sold_at: una raccolta può portare dentro vendite di settimane prima, e un filtro sulla data di vendita le salterebbe. Il limite è esclusivo e il timestamp termina già con Z, quindi inseriscilo così com'è nella query string. Per stimare un prezzo dalle vendite recenti, passa invece period=90d, che filtra su sold_at.

grade_qualifier indica il livello quando un grader ne assegna più di uno con lo stesso voto: "Pristine" è una CGC Pristine 10 e "Black Label" è una BGS Black Label 10. È null per tutto il resto, comprese una CGC Gem Mint 10 e una BGS 10 normale. grade resta "10" per tutte, quindi grade=10 restituisce ogni livello. Per ottenerne uno solo, usa il filtro grade_qualifier: grader=BGS&grade=10&grade_qualifier=black_label restituisce le Black Label, e grade_qualifier=none le BGS 10 normali. Una Pristine 10 di solito si vende ben sopra una Gem Mint 10.

sale_type indica come è stato venduto l'articolo: "auction", "fixed_price" o "best_offer_accepted". Prezzo fisso comprende gli annunci che accettavano offerte ma sono stati venduti al prezzo di listino. Per "best_offer_accepted", price è quanto ha pagato l'acquirente, che leggiamo dalla pagina dell'articolo perché i risultati di ricerca di eBay mostrano solo il prezzo richiesto. Gli annunci con più quantità venduti tramite offerta sono esclusi, perché la loro pagina non mostra l'importo accettato. sale_type è null per le vendite raccolte prima che esistesse, quindi una riga null può ancora riportare il prezzo richiesto di un'offerta accettata. È null anche per le vendite replicate da PriceCharting e per quelle di prodotti sigillati.

seller_country è la posizione del venditore come codice ISO di due lettere, ad esempio "US", "JP" o "GB". Porto Rico è "PR", quindi seller_country=US,PR include entrambi. Vale null quando non conosciamo la posizione: vendite meno recenti, alcune vendite riprese da PriceCharting e posizioni che non sappiamo associare a un paese.

Parametri

idstringobbligatorio

L'ID univoco della carta.

gradedboolean

true = solo gradate; false = solo non gradate; omesso = entrambe. I due valori sono esattamente complementari: ogni vendita viene restituita da uno solo dei due.

graderstring

Filtro per società di grading (es. "PSA", "BGS", "CGC").

gradestring

Filtro per voto (es. "10", "9.5", "9").

grade_qualifierstring

Solo le vendite di un livello del loro voto: "pristine" (CGC Pristine 10), "black_label" (BGS Black Label 10) o "none" per le vendite senza un livello con nome, comprese le CGC e BGS 10 normali. "none" restituisce anche le vendite raccolte prima che registrassimo il livello.

sale_typestring

Solo vendite concluse in questo modo, come valori separati da virgole tra "auction", "fixed_price" e "best_offer_accepted" (ad es. "auction,best_offer_accepted"). Senza distinzione tra maiuscole e minuscole. Le vendite senza un tipo di vendita noto vengono escluse, quindi passare tutti e tre i valori restituisce ogni vendita il cui tipo è noto. Un valore sconosciuto restituisce 400.

seller_countrystring

Solo vendite di venditori in questi paesi, come codici ISO 3166-1 alpha-2 separati da virgole (ad es. "US,JP"). Senza distinzione tra maiuscole e minuscole, al massimo 30. Le vendite senza un paese del venditore noto vengono escluse.

exclude_seller_countrystring

Esclude le vendite di venditori in questi paesi, nello stesso formato (ad es. "CN,HK"). Le vendite senza un paese del venditore noto restano incluse.

min_pricenumber

Prezzo di vendita minimo.

max_pricenumber

Prezzo di vendita massimo.

variantstring

Filtra per la stampa con cui è stata raccolta la vendita (es. "Holofoil", "Reverse Holofoil").

sincestring

Solo vendite raccolte dopo questo istante. Accetta un timestamp RFC 3339 o YYYY-MM-DD (mezzanotte UTC). Un valore malformato restituisce 400 invece di essere ignorato. Filtra su ingested_at, non su sold_at.

periodstring

Solo vendite degli ultimi N giorni: "90d", o semplicemente "90" (da 1 a 365). Filtra su sold_at, mentre since filtra su ingested_at.

sortstring

Ordinamento. Uno tra "date_desc", "date_asc", "price_desc", "price_asc". Predefinito: date_desc.

limitnumber

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

cursorstring

Cursore di paginazione restituito da una risposta precedente.

Provalo

Chiave 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

Risposta

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

Vendite eBay di prodotti sigillati

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

Vendite eBay recenti per un prodotto sigillato. Qui currency è sempre "USD". Stessa struttura delle carte, senza i filtri di grading. Paginazione a cursore. Solo piani a pagamento.

attribution ha lo stesso significato, ma un prodotto sigillato corrisponde a una sola pagina di origine senza stampe da distinguere, quindi il valore descrive l'intero prodotto ed è identico su ogni riga. variant è sempre null; non esiste un filtro per variante.