Anuncios de Cardmarket
Ofertas de Cardmarket en vivo, en EUR, para cartas y productos sellados Pokémon, con paginación por cursor.
Anuncios de Cardmarket en vivo
/v1/cards/:id/listings/cardmarket1 crédito por elemento devueltoOfertas actuales de vendedores de Cardmarket, en EUR. Los resultados se limitan al idioma de la expansión de la carta: una carta en inglés nunca devuelve anuncios en alemán. Paginación por keyset de precio y los nombres de estado propios de Cardmarket. "Reverse Holo" y "Reverse Holofoil" se aceptan como la misma variante.
Las ofertas marcadas como firmadas, alteradas o gradadas se devuelven igualmente, pero no cuentan para el precio de mercado de la carta. grader y grade se extraen de los comentarios del vendedor cuando es posible, así que una oferta gradada puede mostrar null en cualquiera de los dos. Para excluir los anuncios marcados, pasa graded=false&signed=false&altered=false.
seller_country es el país del vendedor como código de dos letras, o null cuando no lo sabemos. Incluye las ofertas recogidas antes de que existiera el campo; se rellenan a medida que se actualiza cada carta.
sell_count son las ventas completadas del vendedor, tal como las informa Cardmarket. Explica por qué un precio de mercado puede estar por encima de la oferta más barata: la oferta de un vendedor sin ventas completadas no fija precio. null significa que no se registró ningún recuento para la fila, lo que no es lo mismo que cero; 0 significa que Cardmarket indica que el vendedor no ha vendido nada.
Parámetros
idstringobligatorioEl ID único de la carta.
conditionstringEstado según Cardmarket (p. ej. "Mint", "Near Mint", "Excellent", "Good", "Light Played", "Played", "Poor").
variantstringVariante de impresión (p. ej. "Normal", "Holofoil", "Reverse Holofoil"). También se acepta "Reverse Holo".
min_pricenumberPrecio mínimo de la oferta (EUR).
max_pricenumberPrecio máximo de la oferta (EUR).
seller_countrystringSolo ofertas de vendedores de estos países, como códigos ISO 3166-1 alfa-2 separados por comas (p. ej. "IT,DE"). No distingue mayúsculas, máximo 30. Las ofertas sin país de vendedor conocido se omiten.
exclude_seller_countrystringOmite las ofertas de vendedores de estos países, en el mismo formato (p. ej. "CN,HK"). Las ofertas sin país de vendedor conocido se mantienen.
gradedboolean"true" para solo anuncios gradados, "false" para solo anuncios sin gradar.
graderstringSolo anuncios gradados por esta empresa (p. ej. "PSA", "CGC", "BGS"). No distingue mayúsculas.
gradestringSolo anuncios gradados con esta nota (p. ej. "10", "9.5").
signedboolean"true" para solo anuncios firmados, "false" para excluirlos.
alteredboolean"true" para solo anuncios alterados, "false" para excluirlos.
min_sell_countintegerSolo anuncios de vendedores con al menos este número de ventas completadas. Los anuncios sin sell_count registrado quedan fuera.
sortstringOrden. Uno de "price_asc", "price_desc". Por defecto: price_asc.
limitnumberNúmero de anuncios por página (máximo 20). Por defecto: 20.
cursorstringCursor de paginación opaco devuelto por una respuesta anterior.
Pruébalo
curl -H "X-API-Key: YOUR_API_KEY" \https://api.pkmnprices.com/v1/cards/{id}/listings/cardmarket
Anuncios de Cardmarket de productos sellados
/v1/sealed/:id/listings/cardmarket1 crédito por elemento devueltoOfertas actuales de vendedores de Cardmarket para un producto sellado, en EUR. No hay filtro de variante: cada oferta de producto sellado se guarda con una variante vacía. Y los resultados no se limitan a un idioma: un producto sellado tiene sus propias ofertas en lugar de compartir un artículo de Cardmarket entre idiomas, así que revisa el campo language en cada fila. condition también suele ser null aquí.
Los anuncios marcados como firmados, alterados, gradados o abiertos se devuelven igualmente, pero no cuentan para el precio de mercado. Para excluirlos, pasa graded=false&signed=false&altered=false&opened=false.
seller_country es el país del vendedor como código de dos letras, o null cuando no lo sabemos. Incluye las ofertas recogidas antes de que existiera el campo; se rellenan a medida que se actualiza cada carta.
sell_count son las ventas completadas del vendedor, tal como las informa Cardmarket. Explica por qué un precio de mercado puede estar por encima de la oferta más barata: la oferta de un vendedor sin ventas completadas no fija precio. null significa que no se registró ningún recuento para la fila, lo que no es lo mismo que cero; 0 significa que Cardmarket indica que el vendedor no ha vendido nada.
Parámetros
idstringobligatorioEl ID único del producto sellado.
conditionstringEstado según Cardmarket. Rara vez útil aquí, porque las ofertas de productos sellados no suelen llevar estado.
min_pricenumberPrecio mínimo de la oferta (EUR).
max_pricenumberPrecio máximo de la oferta (EUR).
seller_countrystringSolo ofertas de vendedores de estos países, como códigos ISO 3166-1 alfa-2 separados por comas (p. ej. "IT,DE"). No distingue mayúsculas, máximo 30. Las ofertas sin país de vendedor conocido se omiten.
exclude_seller_countrystringOmite las ofertas de vendedores de estos países, en el mismo formato (p. ej. "CN,HK"). Las ofertas sin país de vendedor conocido se mantienen.
gradedboolean"true" para solo anuncios gradados, "false" para solo anuncios sin gradar.
graderstringSolo anuncios gradados por esta empresa (p. ej. "PSA", "CGC", "BGS"). No distingue mayúsculas.
gradestringSolo anuncios gradados con esta nota (p. ej. "10", "9.5").
signedboolean"true" para solo anuncios firmados, "false" para excluirlos.
alteredboolean"true" para solo anuncios alterados, "false" para excluirlos.
min_sell_countintegerSolo anuncios de vendedores con al menos este número de ventas completadas. Los anuncios sin sell_count registrado quedan fuera.
openedboolean"true" para anuncios cuyo vendedor dice que el producto no está sellado, "false" para excluirlos.
sortstringOrden. Uno de "price_asc", "price_desc". Por defecto: price_asc.
limitnumberNúmero de anuncios por página (máximo 20). Por defecto: 20.
cursorstringCursor de paginación opaco devuelto por una respuesta anterior.
Pruébalo
curl -H "X-API-Key: YOUR_API_KEY" \https://api.pkmnprices.com/v1/sealed/{id}/listings/cardmarket