Anuncios de TCGplayer

Ofertas de TCGplayer en vivo, en USD, para cartas y productos sellados Pokémon, con paginación por cursor.

Anuncios de TCGplayer en vivo

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

Ofertas en vivo del marketplace de TCGplayer para una carta: precios de oferta actuales en USD, no ventas completadas. Incluye la reputación del vendedor (valoración, número de ventas, insignias Gold/Direct/Verified) y el coste de envío. Paginación por cursor.

updated_at no indica lo recientes que son los datos. Solo cambia cuando cambian el precio, la cantidad o los datos del vendedor del propio anuncio, así que un anuncio sin cambios conserva una marca de tiempo de hace un mes por muy reciente que sea nuestra última comprobación. Usa snapshot_at en su lugar: cuándo se confirmaron por última vez los anuncios del producto contra TCGplayer, el mismo valor en todas las filas de una respuesta. Los anuncios se actualizan a diario, así que un snapshot_at de más de un día significa que la última descarga falló y estás viendo el snapshot anterior. Es null si ningún snapshot ha salido bien desde que se añadió el campo.

Recopilamos desde Estados Unidos sin filtro de destino de envío, así que un snapshot puede incluir ofertas que la propia web de TCGplayer oculta a quien navega desde fuera de EE. UU.

Un snapshot contiene como máximo los 500 anuncios en stock más baratos, en inglés, ordenados por precio más envío en el momento de la recopilación. Por encima de eso, quantity suma esos 500 anuncios, no la Current Quantity de TCGplayer. price_asc (por defecto) ordena por precio del artículo; total_asc coincide con el orden de la propia web.

Parámetros

idstringobligatorio

El ID único de la carta.

conditionstring

Filtro por estado (p. ej. "Near Mint", "Lightly Played", "Moderately Played").

languagestring

Filtro por idioma del anuncio (p. ej. "English", "German", "Japanese"). Es el idioma de la oferta en el marketplace, no el de la carta.

printingstring

Filtro por impresión/variante (p. ej. "Holofoil", "Normal", "Reverse Holofoil").

min_pricenumber

Precio mínimo de la oferta (USD).

max_pricenumber

Precio máximo de la oferta (USD).

sortstring

Orden. Uno de "price_asc", "price_desc", "total_asc", "total_desc". Los órdenes price ordenan solo por el precio del artículo. Los órdenes total ordenan por precio más shipping_price, que es lo que paga el comprador, como ordena las ofertas la propia web de TCGplayer y el orden en que se recopiló el snapshot; así, total_asc reproduce la lista de la web y su primera fila es la oferta realmente más barata. Un cursor queda ligado a la familia de orden con la que se emitió; reutilizar un cursor total con un orden price, o al revés, devuelve 400. min_price y max_price filtran por el precio del artículo con cualquier orden. Por defecto: price_asc.

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 *

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

Respuesta

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

Anuncios de TCGplayer de productos sellados

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

Ofertas en vivo del marketplace de TCGplayer para un producto sellado: precios de oferta actuales en USD, no ventas completadas. Misma estructura, filtros y paginación por cursor que el endpoint de cartas. Las ofertas de productos sellados suelen tener el estado "Unopened" y una impresión vacía, así que esos dos filtros rara vez acotan algo aquí.

snapshot_at funciona igual que en el endpoint de cartas: para saber lo recientes que son los datos, mira snapshot_at, no updated_at.