Ventas de eBay

Ventas individuales de eBay, gradadas y sin gradar, de cartas y productos sellados Pokémon, cada una con enlace al anuncio de origen.

Ventas de eBay

GET/v1/cards/:id/listings/ebay1 crédito por elemento devuelto

Ventas recientes de eBay de una carta, gradadas y sin gradar. Cada fila lleva su propia moneda ("USD" o "EUR"): léela fila a fila en lugar de dar por hecho USD. Paginación por cursor para conjuntos de resultados grandes.

attribution es "exact", "shared" o "unknown". Una variante puede compartir una página de origen con su carta base; cuando ocurre, ambas reciben las mismas ventas, tituladas según la impresión que realmente se vendió. "shared" marca esas filas como referencia para el grupo, no para esta carta en concreto. "unknown" significa que la venta es anterior a que registráramos de qué impresión procedía.

Para consultar ventas nuevas, guarda el ingested_at más alto que hayas visto y pásalo como since. Es la hora de recopilación, no sold_at: una recopilación puede traer ventas de hace semanas, y un filtro por fecha de venta se las saltaría. El límite es exclusivo y la marca de tiempo ya termina en Z, así que envíala tal cual en la query string. Para fijar precios a partir de ventas recientes, pasa period=90d, que filtra por sold_at.

grade_qualifier nombra el nivel cuando una casa de gradación emite más de uno con la misma nota: "Pristine" es una CGC Pristine 10 y "Black Label" es una BGS Black Label 10. Es null para todo lo demás, incluidas una CGC Gem Mint 10 y una BGS 10 normal. grade sigue siendo "10" en todas, así que grade=10 devuelve todos los niveles. Para obtener uno solo, usa el filtro grade_qualifier: grader=BGS&grade=10&grade_qualifier=black_label devuelve las Black Label, y grade_qualifier=none las BGS 10 normales. Una Pristine 10 suele venderse bastante por encima de una Gem Mint 10.

sale_type indica cómo se vendió el artículo: "auction", "fixed_price" o "best_offer_accepted". Precio fijo incluye los anuncios que admitían ofertas pero se vendieron al precio publicado. En "best_offer_accepted", price es lo que pagó el comprador, que leemos de la página del artículo porque los resultados de búsqueda de eBay solo muestran el precio pedido. Se omiten los anuncios de varias unidades vendidos por oferta, ya que su página no muestra el importe aceptado. sale_type es null en las ventas recopiladas antes de que existiera, así que una fila null aún puede llevar el precio pedido de una oferta aceptada. También es null en las ventas replicadas de PriceCharting y en las de productos sellados.

seller_country es la ubicación del vendedor como código ISO de dos letras, como "US", "JP" o "GB". Puerto Rico es "PR", así que seller_country=US,PR cubre ambos. Es null cuando no conocemos la ubicación: ventas antiguas, algunas ventas copiadas de PriceCharting y ubicaciones que no sabemos asignar a un país.

Parámetros

idstringobligatorio

El ID único de la carta.

gradedboolean

true = solo gradadas; false = solo sin gradar; omitido = ambas. Los dos valores son complementarios exactos: cada venta la devuelve exactamente uno de ellos.

graderstring

Filtro por empresa de gradación (p. ej. "PSA", "BGS", "CGC").

gradestring

Filtro por nota (p. ej. "10", "9.5", "9").

grade_qualifierstring

Solo ventas de un nivel de su nota: "pristine" (CGC Pristine 10), "black_label" (BGS Black Label 10) o "none" para ventas sin nivel con nombre, lo que incluye las CGC y BGS 10 normales. "none" también devuelve ventas recopiladas antes de que registráramos el nivel.

sale_typestring

Solo ventas cerradas de esta forma, como valores separados por comas entre "auction", "fixed_price" y "best_offer_accepted" (p. ej. "auction,best_offer_accepted"). No distingue mayúsculas. Las ventas sin tipo de venta conocido se omiten, así que pasar los tres valores devuelve todas las ventas cuyo tipo se conoce. Un valor desconocido devuelve 400.

seller_countrystring

Solo ventas de vendedores de estos países, como códigos ISO 3166-1 alfa-2 separados por comas (p. ej. "US,JP"). No distingue mayúsculas, máximo 30. Las ventas sin país de vendedor conocido se omiten.

exclude_seller_countrystring

Omite las ventas de vendedores de estos países, en el mismo formato (p. ej. "CN,HK"). Las ventas sin país de vendedor conocido se mantienen.

min_pricenumber

Precio de venta mínimo.

max_pricenumber

Precio de venta máximo.

variantstring

Filtra por la impresión con la que se recopiló la venta (p. ej. "Holofoil", "Reverse Holofoil").

sincestring

Solo ventas recopiladas después de este instante. Acepta una marca de tiempo RFC 3339 o YYYY-MM-DD (medianoche UTC). Un valor mal formado devuelve 400 en lugar de ignorarse. Filtra por ingested_at, no por sold_at.

periodstring

Solo ventas de los últimos N días: "90d", o simplemente "90" (de 1 a 365). Filtra por sold_at, mientras que since filtra por ingested_at.

sortstring

Orden. Uno de "date_desc", "date_asc", "price_desc", "price_asc". Por defecto: date_desc.

limitnumber

Número de anuncios por página (máximo 20). Por defecto: 20.

cursorstring

Cursor de paginación devuelto por una respuesta anterior.

Pruébalo

Clave de 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

Respuesta

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

Ventas de eBay de productos sellados

GET/v1/sealed/:id/listings/ebay1 crédito por elemento devuelto

Ventas recientes de eBay de un producto sellado. Aquí currency siempre es "USD". La misma estructura que en las cartas, sin los filtros de gradación. Paginación por cursor. Solo planes de pago.

attribution significa lo mismo, pero un producto sellado corresponde a una sola página de origen sin impresión que distinguir, así que el valor describe todo el producto y es idéntico en cada fila. variant siempre es null; no hay filtro de variante.