E-commerce
Costco Scraper
costco.com
La web de Costco construye sus resultados de búsqueda en el navegador a partir de su propia API de búsqueda del catálogo, y esa API está protegida por Kasada, que responde con un simple 429 a cualquier petición que no lleve los tokens que genera su script en la página. El plugin costco-search ejecuta la búsqueda de Costco dentro de una página real de costco.com y devuelve los resultados ya procesados: para cada producto, el id de producto de Costco y el número de artículo que muestra el sitio, el título, la marca, el enlace y la imagen, el precio (y el máximo de un rango de precios), el precio anterior y el texto de la promoción, como $5 OFF o una nota de validez del precio, si es solo para socios, solo online o solo en almacén, la valoración y el número de reseñas, el número de modelo y las características principales, la ruta de categorías, el número de variantes y su disponibilidad para la ubicación de entrega que usa Costco, que la respuesta indica. Ordena por relevancia, precio, valoración, novedad o marca, empieza en cualquier página de 24 y recoge hasta 240 productos en una llamada; una palabra clave que Costco envía a una página de categoría o de marca, como tv o samsung, devuelve ese listado e indica adónde fue. El plugin costco-product acepta un id de producto, un número de artículo o un enlace de producto y devuelve la página de producto completa: precio y descuento, descripción y detalles, características, la tabla de especificaciones, todas las imágenes, fabricante y referencia, UPC, límites de pedido, texto de envío, las opciones entre las que elige el comprador (colores, tallas) y cada variante con su número de artículo y su UPC. Ambos funcionan en costco.com en USD y en costco.ca en CAD. No hace falta membresía de Costco, inicio de sesión ni clave de API.
Qué puedes extraer
- Id de producto y número de artículo de Costco, título, marca, enlace del producto e imagen
- Precio (y el máximo de un rango de precios), precio anterior y moneda (USD en costco.com, CAD en costco.ca)
- Promociones como $5 OFF, la nota de validez del precio y si el precio solo se muestra en el carrito
- Indicadores de solo para socios, solo online y solo en almacén, venta en almacenes, envío y las insignias que muestra Costco
- Disponibilidad (en stock o agotado) para la ubicación de entrega que usa Costco, indicada en la respuesta
- Valoración y número de reseñas, número de modelo, características principales, categoría y ruta de categorías, número de variantes
- Búsqueda ordenada por relevancia, precio, valoración, novedad o marca, desde cualquier página, hasta 240 productos por llamada; sigue las redirecciones a categorías y marcas
- Detalle de producto: precio y descuento, descripción y detalles, características, especificaciones, todas las imágenes, fabricante y referencia, UPC, límites de pedido, texto de envío, opciones y cada variante con su número de artículo y su UPC
Endpoints dedicados
/marketplace/costco-search Búsqueda de productos en Costco
Productos que coinciden con query en costco.com (domain=com, por defecto) o costco.ca (domain=ca). Devuelve query, domain, sort, page, pageSize, totalResults, resultsCollected, redirectedTo (cuando Costco envía la palabra clave a una página de categoría o de marca, cuyos productos se devuelven), correctedQuery, deliveryLocation (postalCode, state, city: la ubicación para la que se calcula la disponibilidad), url y products con productId, itemNumber, title, brand, url, image, price, priceMax, wasPrice, currency, promotions, marketingStatement, rating, reviewCount, memberOnly, onlineOnly, warehouseOnly, badges, availability, inWarehouse, shipIt, buyableOnline, priceShownInCartOnly, model, features, category, categoryPath y variantCount. sort es relevance, price_low, price_high, rating, newest o brand; page empieza en una página de 24; max_results va de 1 a 240 (hasta 120 productos son una petición); include_out_of_stock añade los productos que Costco oculta.
/marketplace/costco-product Página de producto de Costco
Un producto por product (un id de producto de Costco, un número de artículo o un enlace de producto de costco.com o costco.ca; domain=ca para un id de costco.ca). Devuelve product con productId, itemNumber, title, brand, url, price, discount, currency, rating, reviewCount, memberOnly, onlineOnly, buyable, inWarehouse, shipIt, description, details, features, marketingStatement, promotionalStatement, shipping, manufacturer, manufacturerPartNumber, upc, minQuantity, maxQuantity, categoryPath, specifications, images, options (todos los valores de cada opción, como Color y Size) y variants (itemNumber, options, upc, buyable). Un producto desconocido es un 404.
Cómo rastrearlo
curl -X POST \
-H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
"https://api.scrapeunblocker.com/marketplace/costco-search?query=paper%20towels"import requests
resp = requests.post(
"https://api.scrapeunblocker.com/marketplace/costco-search",
headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
params={"query": "paper towels"},
)
print(resp.text)import { ScrapeUnblockerClient } from 'scrapeunblocker';
const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });
const results = await su.costcoSearch('paper towels', {
sort: 'price_low',
maxResults: 48,
});
const product = await su.costcoProduct('100361434');
console.log(results);
console.log(product); Las peticiones son POST y sus parámetros van en la query string. El renderizado en navegador siempre ocurre: no hay ningún flag que activar.
Ejemplo de respuesta
{
"query": "kirkland signature coffee",
"domain": "com",
"sort": "relevance",
"page": 1,
"pageSize": 24,
"totalResults": 376,
"resultsCollected": 1,
"redirectedTo": null,
"correctedQuery": null,
"deliveryLocation": {
"postalCode": "98101",
"state": "WA",
"city": "Times Square"
},
"url": "https://www.costco.com/s?keyword=kirkland+signature+coffee",
"products": [
{
"productId": "100401327",
"itemNumber": "1217294",
"title": "Kirkland Signature Organic Ethiopia Whole Bean Coffee, 2 lbs",
"brand": "Kirkland Signature",
"url": "https://www.costco.com/p/-/kirkland-signature-organic-ethiopia-whole-bean-coffee-2-lbs/100401327",
"image": "https://gdx-assets.costco.com/adobe/assets/urn:aaid:aem:16132a61-a1d8-4792-a339-038fe800dd53/as/bq8pnhw946j79pbn9n9kcg4n__1217294-847__1.avif",
"price": 49.99,
"priceMax": null,
"wasPrice": null,
"currency": "USD",
"promotions": [],
"marketingStatement": null,
"rating": 4.49,
"reviewCount": 1944,
"memberOnly": false,
"onlineOnly": false,
"warehouseOnly": false,
"badges": [],
"availability": "in_stock",
"inWarehouse": true,
"shipIt": true,
"buyableOnline": true,
"priceShownInCartOnly": false,
"model": null,
"features": [],
"category": "Whole Bean Coffee",
"categoryPath": [
"Grocery & Household Essentials",
"Coffee",
"Whole Bean Coffee"
],
"variantCount": 1
}
]
} Preguntas frecuentes
¿Es legal hacer scraping de Costco?
Recopilar datos públicos de Costco como nombres de productos, precios y promociones es lícito en muchas jurisdicciones, pero las normas dependen de tu país, de los datos que recopiles y de cómo los uses. ScrapeUnblocker devuelve los datos públicos de los productos; qué recopilas y cómo lo usas es responsabilidad tuya.
¿Cómo hago scraping de Costco sin que me bloqueen?
Los resultados de búsqueda de Costco salen de su API de búsqueda del catálogo, y Kasada responde con un simple 429 a cada petición que no lleve los tokens que genera la propia página de Costco, el último de ellos una prueba de trabajo calculada para cada petición; la página de búsqueda llega vacía. El plugin /marketplace/costco-search abre una página de costco.com en un navegador real, espera a que el script de Kasada esté listo y llama a la búsqueda de Costco desde dentro de la página, así que cada petición lleva tokens válidos; las páginas de producto se generan en los servidores de Costco y se leen directamente. En el benchmark de ScrapeUnblocker devolvió datos en el 99,3 % de 1.006 llamadas (587 búsquedas en costco.com y costco.ca, cada una con un término, un orden o una página distintos, y 419 páginas de producto), unos 6,8 s por búsqueda y 2,1 s por página de producto.
¿Qué datos de Costco puedo obtener?
Para cada producto de una búsqueda: el id de producto y el número de artículo, título, marca, enlace e imagen, el precio, el máximo de un rango de precios, el precio anterior, el texto de la promoción, si el precio solo se muestra en el carrito, los indicadores de solo para socios, solo online y solo en almacén, la disponibilidad para una ubicación de entrega, la valoración y el número de reseñas, el número de modelo, las características principales, la ruta de categorías y el número de variantes. El endpoint de producto añade la descripción, los detalles, la tabla de especificaciones, todas las imágenes, fabricante y referencia, UPC, límites de pedido, el texto de envío, las opciones y el número de artículo y el UPC de cada variante.
¿Cubre Costco Canadá?
Sí. Pasa domain=ca para buscar en costco.ca o para leer un producto de costco.ca por id; un enlace de producto de costco.ca elige la tienda canadiense por sí mismo. Los precios de costco.ca están en CAD y la disponibilidad se calcula para una ubicación de entrega canadiense.
¿Necesito una membresía de Costco?
No. Los precios, las promociones y los detalles de producto de la web de Costco son públicos, y no interviene ninguna cuenta de Costco, número de socio ni inicio de sesión. Los artículos cuyo precio Costco solo muestra en el carrito llevan el indicador priceShownInCartOnly; el precio devuelto es el que guarda el catálogo de Costco.
¿Cuánto cuesta hacer scraping de Costco?
Una búsqueda de hasta 120 productos es una petición (240 productos son dos), y una página de producto es una petición. 1 petición = 1 crédito, 1,00 EUR por cada 1.000 en Pay as you go, bajando hasta unos 0,55 EUR por cada 1.000 en el plan Ultimate. No se facturan los bloqueos ni los timeouts, y la prueba gratuita incluye 500 peticiones sin tarjeta.
Scrapers relacionados
Costco y los demás nombres y marcas de costco.com pertenecen a su titular y aquí se usan solo para identificar el sitio web con el que funciona esta API. ScrapeUnblocker es un servicio independiente: no está afiliado al titular de costco.com ni cuenta con su respaldo o patrocinio.
Empieza a rastrear este sitio hoy
Plan gratuito incluido. No necesitas tarjeta para probarlo.