E-commerce
1688 Scraper
1688.com
1688.com es el marketplace mayorista de Alibaba Group para el mercado chino, donde fábricas y mayoristas venden en yuanes y por cantidad. 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, en chino para obtener más ofertas o en inglés, y devuelve las ofertas ya analizadas: id de la oferta, título, URL e imágenes, el precio en yuanes con la escala de precios por cantidad, las unidades vendidas, la tasa de recompra, las etiquetas de servicio y de promoción, un indicador de patrocinado y el proveedor: nombre de la empresa, URL de la tienda, años en 1688, provincia y ciudad, inspección de fábrica y de empresa, el indicador de super factory y las puntuaciones de servicio comercial. Ordena por relevancia, por ventas de los últimos 30 días o por precio, filtra por un rango de precios en yuanes o por la provincia del proveedor, y recoge hasta 300 ofertas por llamada a 60 por página, continuando desde nextPage. El endpoint de oferta acepta un id o un enlace de oferta y devuelve una oferta completa: la escala de precios por cantidad o los precios por SKU con los precios anteriores a cualquier promoción, el pedido mínimo y la unidad, el stock, las unidades vendidas, la matriz de SKU con los nombres de opción, los valores y las imágenes y cada SKU con su precio y su stock, los atributos, las imágenes y el vídeo, el origen del envío y el compromiso de despacho, las garantías de servicio, el resumen de valoraciones de los compradores y el proveedor. El texto vuelve en chino, tal como lo publica 1688. No hace falta cuenta de 1688, inicio de sesión ni clave de API.
Qué puedes extraer
- Id de la oferta, título, URL, imágenes y vídeo
- Precio en yuanes (CNY) con la escala de precios por cantidad (precio por tramo de cantidad)
- Unidades vendidas, tasa de recompra, etiquetas de servicio y de promoción y un indicador de patrocinado
- Proveedor: nombre de la empresa, URL de la tienda, años en 1688, provincia y ciudad, inspección de fábrica y de empresa, indicador de super factory y puntuaciones de servicio comercial
- Búsqueda por palabra clave en chino o en inglés, ordenada por relevancia, ventas o precio, filtrada por un rango de precios en yuanes o por la provincia del proveedor; hasta 300 ofertas por llamada
- Detalle de la oferta: precios por SKU, precios anteriores a una promoción, pedido mínimo (MOQ) y unidad, stock y unidades vendidas
- Detalle de la oferta: la matriz de SKU con nombres de opción, valores e imágenes, cada SKU con su precio y su stock, y los atributos
- Detalle de la oferta: origen del envío, compromiso de despacho, garantías de servicio, resumen de valoraciones de los compradores y puntuaciones de servicio del proveedor
Endpoints dedicados
/marketplace/1688-search Búsqueda mayorista en 1688.com
Ofertas de 1688 para una palabra clave (q, en chino o en inglés): un array products con offerId, title, url, image, images, price, currency (CNY), priceTiers (quantityText, minQuantity, maxQuantity, price), soldText, sold, repurchaseRatePercent, serviceTags, promotionTags, tags, brand, sponsored y supplier (name, loginId, memberId, shopUrl, yearsOnPlatform, province, city, factoryInspected, businessInspected, superFactory, tradeScores), además de totalResults, pagesFetched, lastPageFetched, droppedFromLastPage, hasMore y nextPage. sort es relevance, sales, price_asc o price_desc; price_min y price_max (yuanes) y province filtran los resultados; max_results de 1 a 300 a 60 por página, y page (1-34) fija desde dónde empezar.
/marketplace/1688-product Una oferta de 1688.com completa
Una oferta por offer_id o url: title, status, brand, category, priceText con priceMin y priceMax en yuanes, pricing (tiers o sku), priceTiers, originalPriceTiers, unit, moq, available, sold, soldText y soldPeriod, variantOptions (nombres y valores de opción con imágenes), variants (skuId, options, price, available), attributes, images, video, descriptionUrl, shipping (from, dispatch, unitWeightKg, freeShipping), services, labels, rating (goodRatePercent, score, reviewCount, reviewsWithPhotos, tags), favorites y supplier (name, loginId, memberId, userId, shopUrl, serviceScore, repeatPurchaseRate3m, factory, tpMember, location). Una oferta retirada o desconocida responde 404.
Cómo rastrearlo
curl -X POST \
-H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
"https://api.scrapeunblocker.com/marketplace/1688-search?q=%E6%89%8B%E6%9C%BA%E5%A3%B3"import requests
resp = requests.post(
"https://api.scrapeunblocker.com/marketplace/1688-search",
headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
params={"q": "手机壳"},
)
print(resp.text)import { ScrapeUnblockerClient } from 'scrapeunblocker';
const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });
const results = await su.alibaba1688Search('手机壳', {
sort: 'sales',
maxResults: 120,
});
const offer = await su.alibaba1688Product('735353578254');
console.log(results);
console.log(offer);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": "手机壳",
"filters": { "sort": "relevance", "price_min": null, "price_max": null, "province": null },
"page": 1,
"products": [
{
"offerId": "1042303890832",
"title": "适用iPhone17promax渐变磁吸手机壳磨砂苹果16高级感15防摔保护套",
"url": "https://detail.1688.com/offer/1042303890832.html",
"image": "https://cbu01.alicdn.com/img/ibank/O1CN01yp9iTc1gezw62LhMZ_!!2212690464168-0-cib.jpg",
"images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01yp9iTc1gezw62LhMZ_!!2212690464168-0-cib.jpg" ],
"price": 14.5,
"currency": "CNY",
"priceTiers": [
{ "quantityText": "1~199个", "minQuantity": 1, "maxQuantity": 199, "price": 14.5 },
{ "quantityText": "200~7999个", "minQuantity": 200, "maxQuantity": 7999, "price": 14.0 },
{ "quantityText": "≥8000个", "minQuantity": 8000, "maxQuantity": null, "price": 13.0 }
],
"soldText": "已售100+件",
"sold": 100,
"repurchaseRatePercent": 55.0,
"serviceTags": [ "深度验商" ],
"promotionTags": [],
"tags": [ "退货包运费", "先采后付", "回头率55%" ],
"brand": null,
"sponsored": false,
"supplier": {
"name": "深圳市罗湖区洪星电子商行",
"loginId": "深圳洪星生产",
"memberId": "b2b-22126904641686ef2e",
"shopUrl": "https://shop306x909028029.1688.com",
"yearsOnPlatform": 5,
"province": "广东",
"city": "深圳市",
"factoryInspected": false,
"businessInspected": true,
"superFactory": false,
"tradeScores": {
"composite": 4.0,
"consultation": 1.5,
"logistics": 4.0,
"disputes": 4.0,
"returns": 4.0,
"goods": 3.0
}
}
},
{
"offerId": "735353578254",
"title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套",
"url": "https://detail.1688.com/offer/735353578254.html",
"image": "https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg",
"images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg" ],
"price": 9.0,
"currency": "CNY",
"priceTiers": [
{ "quantityText": "2~499个", "minQuantity": 2, "maxQuantity": 499, "price": 9.0 },
{ "quantityText": "500~4999个", "minQuantity": 500, "maxQuantity": 4999, "price": 8.5 },
{ "quantityText": "≥5000个", "minQuantity": 5000, "maxQuantity": null, "price": 7.5 }
],
"soldText": "已售1.7万+件",
"sold": 17000,
"repurchaseRatePercent": 57.0,
"serviceTags": [ "深度验商" ],
"promotionTags": [],
"tags": [ "退货包运费", "先采后付", "回头率57%" ],
"brand": null,
"sponsored": false,
"supplier": {
"name": "深圳市亿佳合兴科技有限公司",
"loginId": "深圳亿佳合兴科技有限公司",
"memberId": "b2b-38721316754ec7c",
"shopUrl": "https://shop764420m281617.1688.com",
"yearsOnPlatform": 9,
"province": "广东",
"city": "深圳市",
"factoryInspected": false,
"businessInspected": true,
"superFactory": false,
"tradeScores": {
"composite": 4.0,
"consultation": 3.5,
"logistics": 3.14,
"disputes": 4.0,
"returns": 4.0,
"goods": 3.67
}
}
}
],
"resultsCollected": 60,
"totalResults": 2000,
"currency": "CNY",
"pagesFetched": 1,
"lastPageFetched": 1,
"droppedFromLastPage": 0,
"hasMore": true,
"nextPage": 2
}Preguntas frecuentes
¿Es legal hacer scraping de 1688?
Recopilar datos públicos de 1688.com como títulos de ofertas, precios mayoristas, pedidos mínimos y datos de proveedores 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 las fichas públicas; qué recopilas y cómo lo usas es responsabilidad tuya.
¿Cómo hago scraping de 1688 sin que me bloqueen?
1688 responde a una dirección de la que no se fía con su página de captcha deslizante, o con un error de validación de su servicio de búsqueda, y ambos llegan como una respuesta 200 normal, así que un scraper simple guarda el captcha como si fueran datos. El endpoint de búsqueda llama al mismo servicio JSON de búsqueda que usa la página de búsqueda de 1688, un intercambio firmado de dos peticiones dentro de una misma sesión, desde exits ISP; cuando 1688 responde con el captcha, pasa a un exit nuevo un número limitado de veces y después responde 502 en lugar de devolver el captcha. El endpoint de oferta lee la página de la oferta renderizada en el servidor a través de los tramos sin navegador de la cadena que hay detrás de /getPageSource. No interviene ningún navegador. En el benchmark de ScrapeUnblocker devolvió datos en el 90,1 % de 1.200 llamadas (750 búsquedas, cada una con una consulta distinta, y 450 ofertas), unos 2,9 s por llamada; la mayoría de los fallos fueron búsquedas hechas mientras 1688 rechazaba las búsquedas durante un rato tras una larga serie de ellas.
¿Qué datos de 1688 puedo obtener?
El endpoint de búsqueda devuelve, para cada oferta, su id, título, URL e imágenes, el precio en yuanes con la escala de precios por cantidad, las unidades vendidas, la tasa de recompra, las etiquetas de servicio y de promoción, un indicador de patrocinado y el proveedor: nombre de la empresa, login id, URL de la tienda, años en 1688, provincia y ciudad, inspección de fábrica y de empresa, el indicador de super factory y las puntuaciones de servicio comercial de atención, logística, disputas, devoluciones y producto. El endpoint de oferta añade la ficha completa: precios por SKU o la escala por cantidad, precios anteriores a una promoción, el pedido mínimo y la unidad, el stock, las unidades vendidas, la matriz de SKU con el precio y el stock de cada SKU, los atributos, las imágenes y el vídeo, el origen del envío y el compromiso de despacho, las garantías de servicio, el resumen de valoraciones de los compradores y la puntuación de servicio y la tasa de recompra del proveedor.
¿Cuántas ofertas de 1688 puedo obtener por búsqueda?
1688 sirve 60 ofertas por página de resultados e informa como máximo de 2.000 resultados por búsqueda, es decir, 34 páginas. Una llamada recoge hasta 300 ofertas (max_results de 1 a 300, cinco páginas); para ir más allá, vuelve a llamar con page igual al nextPage de la respuesta anterior. nextPage es siempre la siguiente página de la que no se devolvió ninguna oferta, así que cuando max_results termina dentro de una página el resto de esa página se omite (droppedFromLastPage lo cuenta); pide múltiplos de 60 para obtener todas las ofertas. Ordena por relevance, sales (las más vendidas de los últimos 30 días primero), price_asc o price_desc, y filtra con price_min y price_max en yuanes, o con province, el nombre chino de una provincia como 广东 (Guangdong) o 浙江 (Zhejiang).
¿En qué idioma y moneda vienen los datos de 1688?
1688 es un marketplace en chino: los títulos, atributos, etiquetas y nombres de proveedores vuelven en chino tal como los publica 1688, así que tradúcelos por tu cuenta si los necesitas en otro idioma. Los precios están en yuanes (CNY), y priceTiers enumera los escalones mayoristas, por ejemplo de 2 a 499 unidades a un precio y de 500 a 4.999 a otro más bajo; moq con su unidad es el pedido más pequeño que acepta el proveedor. Las palabras clave funcionan en chino y en inglés, pero las palabras clave en chino coinciden con más ofertas.
¿Cuánto cuesta hacer scraping de 1688?
Una búsqueda se factura como una petición por cada página de resultados servida: hasta 60 ofertas es 1 petición, 300 ofertas hasta 5, y pagesFetched muestra el número exacto. Una oferta 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
1688 y los demás nombres y marcas de 1688.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 1688.com ni cuenta con su respaldo o patrocinio.
Empieza a rastrear este sitio hoy
Plan gratuito incluido. No necesitas tarjeta para probarlo.