E-commerce
Shopee Scraper
shopee.sg
Shopee tiene una web de marketplace distinta para cada uno de sus mercados, y se sirve mediante dos endpoints de plugin dedicados en lugar de la obtención de página genérica. Dale al endpoint de búsqueda una palabra clave (como 'air fryer') y un mercado (Singapur, Indonesia, Malasia, Tailandia, Vietnam, Filipinas, Taiwán o Brasil), y devuelve una página de resultados de hasta 40 productos, ya analizados: ids del artículo y de la tienda, nombre, enlace e imagen, el precio en la moneda del mercado, el precio tachado y el descuento cuando Shopee los muestra, la valoración media en estrellas, desde dónde envía el vendedor y las etiquetas de promoción. Ordena por relevancia, ventas, novedad o precio, filtra por un rango de precios, quédate con los productos de una tienda con shop_id, o pasa tal cual un enlace de búsqueda o de categoría de Shopee. El endpoint de producto acepta un enlace de producto, o un id de tienda y un id de artículo, y devuelve el producto con su precio, valoración, etiquetas e imágenes y el perfil público de la tienda: nombre, valoración y número de valoraciones, seguidores, número de productos, tasa de respuesta, indicadores de tienda oficial y vendedor preferido, y fecha de alta. En Singapur, Malasia, Taiwán y Brasil devuelve además la ficha completa: descripción, marca, estado, categorías, vídeos, variaciones y modelos, atributos, indicador de preventa, días de envío estimados y fecha de publicación; en los otros cuatro mercados el producto llega solo con su título y su imagen principal, y dataLevel indica cuál de los dos recibiste. Shopee deja fuera el stock, las unidades vendidas, el número de valoraciones de un producto y las reseñas de todas las páginas que muestra a los visitantes sin sesión iniciada, así que no se incluyen. No hace falta cuenta de Shopee, inicio de sesión ni clave de API.
Qué puedes extraer
- Id del artículo, id de la tienda, nombre, enlace, imagen y posición en los resultados
- Precio en la moneda del mercado, el precio original tachado y el porcentaje de descuento
- Valoración media en estrellas, desde dónde envía el vendedor y etiquetas de promoción
- Ocho mercados: Singapur, Indonesia, Malasia, Tailandia, Vietnam, Filipinas, Taiwán y Brasil
- Búsqueda por palabra clave, por tienda o por enlace de categoría, ordenada por relevancia, ventas, novedad o precio y filtrada por precio; hasta 40 productos por llamada
- Producto: precio, valoración, etiquetas, imágenes, origen del envío y el perfil público de la tienda (valoración, número de valoraciones, seguidores, productos, tasa de respuesta, indicadores de tienda oficial y vendedor preferido, fecha de alta)
- Ficha completa del producto en Singapur, Malasia, Taiwán y Brasil: descripción, marca, estado, categorías, vídeos, variaciones, modelos, atributos, indicador de preventa, días de envío estimados y fecha de publicación
Endpoints dedicados
/marketplace/shopee-search Búsqueda de productos en Shopee
Una página de resultados de Shopee para una palabra clave (q) en un mercado (country: sg, id, my, th, vn, ph, tw o br; por defecto sg): un array products con position, itemId, shopId, name, url, image, price, originalPrice, discountPercent, currency, rating, location y labels, además de country, url, currency y resultsCollected. sort es relevance, sales, newest, price_asc o price_desc, min_price y max_price filtran en la moneda del mercado, shop_id se queda con los productos de una tienda (o lista la tienda sin q), y url acepta en su lugar un enlace de búsqueda o de categoría de Shopee; max_results de 1 a 40. Una búsqueda sin productos responde 404.
/marketplace/shopee-product Un producto de Shopee
Un producto por url (un enlace de producto de Shopee) o por shop_id + item_id + country: product con itemId, shopId, url, title, price, originalPrice, discountPercent, currency, rating, labels, images, shopLocation y shop (shopId, name, username, url, rating, ratingCount, followers, itemCount, responseRatePercent, isOfficialShop, isPreferredPlusSeller, location, joinedAt), además de dataLevel. Con dataLevel full (Singapur, Malasia, Taiwán y Brasil) añade description, brand, condition, categories, videos, variations, models, attributes, isOfficialShop, isPreOrder, estimatedShippingDays y createdAt. Un producto desconocido responde 404.
Cómo rastrearlo
curl -X POST \
-H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
"https://api.scrapeunblocker.com/marketplace/shopee-search?q=air%20fryer&country=sg&max_results=10"import requests
resp = requests.post(
"https://api.scrapeunblocker.com/marketplace/shopee-search",
headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
params={"q": "air fryer", "country": "sg", "max_results": "10"},
)
print(resp.text)import { ScrapeUnblockerClient } from 'scrapeunblocker';
const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });
const results = await su.shopeeSearch('air fryer', {
country: 'sg',
maxResults: 10,
});
const product = await su.shopeeProduct('https://shopee.sg/product/269639798/25278923908');
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": "air fryer",
"shopId": null,
"sort": "relevance",
"minPrice": null,
"maxPrice": null,
"country": "sg",
"url": "https://shopee.sg/search?keyword=air%20fryer",
"currency": "SGD",
"resultsCollected": 10,
"products": [
{
"position": 1,
"itemId": 25278923908,
"shopId": 269639798,
"name": "Philips NA120/09 | 12-in-1 Airfryer | 4.2L | Fry, Grill, Bake, Roast... ++ | Up to 90% Less Fat | Cooks 50% Faster",
"url": "https://shopee.sg/Philips-NA120-09-12-in-1-Airfryer-4.2L-Fry-Grill-Bake-Roast...-Up-to-90-Less-Fat-Cooks-50-Faster-i.269639798.25278923908",
"image": "https://down-sg.img.susercontent.com/file/sg-11134201-7rasr-mar9klgawj0w1c",
"price": 87.11,
"originalPrice": null,
"discountPercent": 27,
"currency": "SGD",
"rating": 4.9,
"location": "SG",
"labels": [ "Add-on Deal" ]
},
{
"position": 2,
"itemId": 16594802766,
"shopId": 13436301,
"name": "Mayer 5.5L Digital Glass Air Fryer MMGAF539D - White / Dark Grey",
"url": "https://shopee.sg/Mayer-5.5L-Digital-Glass-Air-Fryer-MMGAF539D-White-Dark-Grey-i.13436301.16594802766",
"image": "https://down-sg.img.susercontent.com/file/sg-11134207-7rcdo-lr3yn9bgswmz76",
"price": 113.9,
"originalPrice": null,
"discountPercent": 43,
"currency": "SGD",
"rating": 4.9,
"location": null,
"labels": []
}
]
} Preguntas frecuentes
¿Es legal hacer scraping de Shopee?
Recopilar datos públicos de Shopee como nombres de productos, precios, valoraciones y perfiles de tiendas 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. Algunos vendedores son particulares, así que los nombres de tienda y de usuario pueden ser datos personales; sigue las normas de privacidad que te apliquen. ScrapeUnblocker devuelve las fichas públicas; qué recopilas y cómo lo usas es responsabilidad tuya.
¿Cómo hago scraping de Shopee sin que me bloqueen?
La app web de Shopee lee sus datos de una API que exige una firma que su script antibots calcula dentro de un navegador real; una llamada sin firmar recibe un 403. Los plugins leen en su lugar las páginas que Shopee renderiza en su servidor (listados de búsqueda, de tienda y de categoría, la página de producto y el perfil de la tienda) por HTTP simple a través de exits ISP. Un exit que Shopee rechaza, o al que responde con una página vacía, queda en reposo y el siguiente intento toma otro, así que un 200 nunca lleva una página vacía. No interviene ningún navegador. En el benchmark de ScrapeUnblocker devolvió datos reales en el 99,8 % de 1.008 llamadas, unos 3,2 s por llamada.
¿Qué datos de Shopee puedo obtener?
Cada resultado de búsqueda trae los ids del artículo y de la tienda, el nombre, el enlace y la imagen, el precio en la moneda del mercado, el precio tachado y el descuento cuando Shopee los muestra, la valoración media en estrellas, desde dónde envía el vendedor y las etiquetas de promoción. El endpoint de producto añade la galería de imágenes y el perfil público de la tienda: nombre, nombre de usuario, valoración y número de valoraciones, seguidores, número de productos, tasa de respuesta, indicadores de tienda oficial y vendedor preferido, y fecha de alta; en Singapur, Malasia, Taiwán y Brasil también la descripción, la marca, el estado, las categorías, los vídeos, las variaciones y los modelos, los atributos, el indicador de preventa, los días de envío estimados y la fecha de publicación. El stock, las unidades vendidas, el número de valoraciones de un producto y las reseñas no están disponibles: Shopee los deja fuera de todas las páginas que muestra a los visitantes sin sesión iniciada.
¿Qué mercados de Shopee se admiten?
Ocho: Singapur (shopee.sg, SGD), Indonesia (shopee.co.id, IDR), Malasia (shopee.com.my, MYR), Tailandia (shopee.co.th, THB), Vietnam (shopee.vn, VND), Filipinas (shopee.ph, PHP), Taiwán (shopee.tw, TWD) y Brasil (shopee.com.br, BRL). Pasa el mercado como country (por defecto sg); los precios llegan en su moneda. La búsqueda funciona igual en los ocho. El endpoint de producto devuelve la ficha completa en Singapur, Malasia, Taiwán y Brasil; en los otros cuatro el producto llega con su título y su imagen principal, el precio, la valoración y el perfil de la tienda, marcado con dataLevel: meta.
¿Cuántos productos de Shopee puedo obtener por búsqueda?
Hasta 40, una página de resultados de Shopee: Shopee renderiza una sola página por búsqueda. Para obtener más productos de la misma palabra clave, repítela con otros órdenes (sales, newest, price_asc, price_desc) o con rangos de precios más estrechos mediante min_price y max_price, o lista una tienda con shop_id o una categoría con su enlace.
¿Qué precio devuelve Shopee?
price es lo que Shopee muestra a un comprador sin sesión iniciada, en la moneda del mercado. Puede ser un precio promocional o para nuevos clientes: labels lleva las insignias de promoción, y originalPrice y discountPercent el precio tachado y el descuento cuando Shopee los muestra.
¿Cuánto cuesta hacer scraping de Shopee?
Cada llamada es una petición: una búsqueda con hasta 40 productos, o un producto con el perfil de su tienda. 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
Shopee y los demás nombres y marcas de shopee.sg 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 shopee.sg ni cuenta con su respaldo o patrocinio.
Empieza a rastrear este sitio hoy
Plan gratuito incluido. No necesitas tarjeta para probarlo.