E-commerce
1688 Scraper
1688.com
1688.com est la place de marché de gros d'Alibaba Group destinée au marché chinois, où usines et grossistes vendent en yuans et par quantité. Elle est servie via deux endpoints de plugin dédiés plutôt que par la récupération de page générique. Donnez au endpoint de recherche un mot-clé, en chinois pour obtenir le plus d'offres ou en anglais, et il renvoie les offres déjà parsées : identifiant de l'offre, titre, URL et images, le prix en yuans avec l'échelle de prix par quantité, les unités vendues, le taux de rachat, les tags de service et de promotion, un indicateur sponsorisé et le fournisseur : nom de l'entreprise, URL de la boutique, années sur 1688, province et ville, inspection de l'usine et de l'entreprise, l'indicateur super factory et les notes de service commercial. Triez par pertinence, par ventes des 30 derniers jours ou par prix, filtrez par fourchette de prix en yuans ou par province du fournisseur, et collectez jusqu'à 300 offres par appel à raison de 60 par page, en reprenant depuis nextPage. Le endpoint offre prend un identifiant ou un lien d'offre et renvoie une offre complète : l'échelle de prix par quantité ou les prix par SKU avec les prix avant une éventuelle promotion, la commande minimale et l'unité, le stock, les unités vendues, la matrice des SKU avec les noms d'options, les valeurs et les images et chaque SKU avec son prix et son stock, les attributs, les images et la vidéo, le lieu d'expédition et la promesse d'expédition, les garanties de service, le résumé des évaluations des acheteurs et le fournisseur. Les textes sont renvoyés en chinois, tels que 1688 les publie. Aucun compte 1688, connexion ni clé d'API n'est nécessaire.
Ce que vous pouvez extraire
- Identifiant de l'offre, titre, URL, images et vidéo
- Prix en yuans (CNY) avec l'échelle de prix par quantité (prix par palier de quantité)
- Unités vendues, taux de rachat, tags de service et de promotion et un indicateur sponsorisé
- Fournisseur : nom de l'entreprise, URL de la boutique, années sur 1688, province et ville, inspection de l'usine et de l'entreprise, indicateur super factory et notes de service commercial
- Recherche par mot-clé en chinois ou en anglais, triée par pertinence, ventes ou prix, filtrée par fourchette de prix en yuans ou par province du fournisseur ; jusqu'à 300 offres par appel
- Détail de l'offre : prix par SKU, prix avant une promotion, commande minimale (MOQ) et unité, stock et unités vendues
- Détail de l'offre : la matrice des SKU avec noms d'options, valeurs et images, chaque SKU avec son prix et son stock, et les attributs
- Détail de l'offre : lieu d'expédition, promesse d'expédition, garanties de service, résumé des évaluations des acheteurs et notes de service du fournisseur
Endpoints dédiés
/marketplace/1688-search Une recherche de gros sur 1688.com
Les offres 1688 pour un mot-clé (q, en chinois ou en anglais) : un tableau products avec offerId, title, url, image, images, price, currency (CNY), priceTiers (quantityText, minQuantity, maxQuantity, price), soldText, sold, repurchaseRatePercent, serviceTags, promotionTags, tags, brand, sponsored et supplier (name, loginId, memberId, shopUrl, yearsOnPlatform, province, city, factoryInspected, businessInspected, superFactory, tradeScores), plus totalResults, pagesFetched, lastPageFetched, droppedFromLastPage, hasMore et nextPage. sort vaut relevance, sales, price_asc ou price_desc ; price_min et price_max (en yuans) et province filtrent les résultats ; max_results de 1 à 300 à raison de 60 par page, et page (1-34) fixe le point de départ.
/marketplace/1688-product Une offre 1688.com complète
Une offre par offer_id ou url : title, status, brand, category, priceText avec priceMin et priceMax en yuans, pricing (tiers ou sku), priceTiers, originalPriceTiers, unit, moq, available, sold, soldText et soldPeriod, variantOptions (noms d'options et valeurs avec images), variants (skuId, options, price, available), attributes, images, video, descriptionUrl, shipping (from, dispatch, unitWeightKg, freeShipping), services, labels, rating (goodRatePercent, score, reviewCount, reviewsWithPhotos, tags), favorites et supplier (name, loginId, memberId, userId, shopUrl, serviceScore, repeatPurchaseRate3m, factory, tpMember, location). Une offre retirée ou inconnue répond 404.
Comment le scraper
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);Les requêtes sont en POST et passent leurs paramètres dans la query string. Le rendu navigateur a toujours lieu : aucun flag à activer.
Exemple de réponse
{
"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
}Lire la documentation de l'API
Questions fréquentes
Le scraping de 1688 est-il légal ?
Collecter des données publiques de 1688.com comme les titres des offres, les prix de gros, les commandes minimales et les informations sur les fournisseurs est licite dans de nombreuses juridictions, mais les règles dépendent de votre pays, des données collectées et de leur usage. ScrapeUnblocker renvoie les fiches publiques ; ce que vous collectez et comment vous l'utilisez relève de votre responsabilité.
Comment scraper 1688 sans se faire bloquer ?
1688 répond à une adresse dont il se méfie par sa page à curseur, ou par une erreur de validation de son service de recherche, et les deux arrivent comme une réponse 200 normale, si bien qu'un scraper simple enregistre la page à curseur comme s'il s'agissait de données. Le endpoint de recherche appelle le même service de recherche JSON que celui qu'utilise la page de recherche de 1688, un échange signé en deux requêtes maintenu sur une seule session, depuis des sorties ISP ; quand 1688 répond par la page à curseur, il passe à une sortie neuve un nombre limité de fois, puis répond 502 plutôt que de renvoyer la page à curseur. Le endpoint offre lit la page d'offre rendue côté serveur via les étapes sans navigateur de la chaîne qui sert /getPageSource. Aucun navigateur n'intervient. Dans le benchmark de ScrapeUnblocker, 90,1 % des 1 200 appels (750 recherches, chacune avec une requête différente, et 450 offres) ont renvoyé des données, en environ 2,9 s par appel ; la plupart des échecs sont des recherches faites pendant que 1688 refusait les recherches pendant un moment après une longue série.
Quelles données 1688 puis-je obtenir ?
Le endpoint de recherche renvoie pour chaque offre son identifiant, son titre, son URL et ses images, le prix en yuans avec l'échelle de prix par quantité, les unités vendues, le taux de rachat, les tags de service et de promotion, un indicateur sponsorisé et le fournisseur : nom de l'entreprise, identifiant de connexion, URL de la boutique, années sur 1688, province et ville, inspection de l'usine et de l'entreprise, l'indicateur super factory et les notes de service commercial pour le conseil, la logistique, les litiges, les retours et les marchandises. Le endpoint offre ajoute la fiche complète : prix par SKU ou échelle par quantité, prix avant une promotion, commande minimale et unité, stock, unités vendues, la matrice des SKU avec le prix et le stock de chaque SKU, les attributs, les images et la vidéo, le lieu et la promesse d'expédition, les garanties de service, le résumé des évaluations des acheteurs ainsi que la note de service et le taux de rachat du fournisseur.
Combien d'offres 1688 puis-je obtenir par recherche ?
1688 sert 60 offres par page de résultats et annonce au plus 2 000 résultats pour une recherche, soit 34 pages. Un appel collecte jusqu'à 300 offres (max_results de 1 à 300, cinq pages) ; pour aller plus loin, rappelez avec page égal au nextPage de la réponse précédente. nextPage est toujours la page suivante dont aucune offre n'a été renvoyée ; quand max_results s'arrête au milieu d'une page, le reste de cette page est ignoré (droppedFromLastPage le compte), demandez donc des multiples de 60 pour obtenir toutes les offres. Triez par relevance, sales (les plus vendues des 30 derniers jours d'abord), price_asc ou price_desc, et filtrez avec price_min et price_max en yuans, ou avec province, un nom de province chinoise comme 广东 (Guangdong) ou 浙江 (Zhejiang).
Dans quelle langue et quelle devise sont les données 1688 ?
1688 est une place de marché en langue chinoise : les titres, les attributs, les tags et les noms des fournisseurs sont renvoyés en chinois tels que 1688 les publie, traduisez-les donc de votre côté si vous avez besoin de l'anglais. Les prix sont en yuans (CNY), et priceTiers liste les paliers de gros, par exemple de 2 à 499 pièces à un prix et de 500 à 4 999 à un prix plus bas ; moq avec son unité est la plus petite commande acceptée par le fournisseur. Les mots-clés fonctionnent en chinois et en anglais, mais les mots-clés chinois trouvent le plus d'offres.
Combien coûte le scraping de 1688 ?
Une recherche est facturée une requête par page de résultats servie : jusqu'à 60 offres font 1 requête, 300 offres jusqu'à 5, et pagesFetched indique le nombre exact. Une offre est une requête. 1 requête = 1 crédit, 1,00 EUR pour 1 000 en paiement à l'usage, en descendant jusqu'à environ 0,55 EUR pour 1 000 sur l'offre Ultimate. Les blocages et les timeouts ne sont pas facturés, et l'essai gratuit inclut 500 requêtes sans carte bancaire.
Scrapers similaires
1688 et les autres noms et marques de 1688.com appartiennent à leur titulaire et ne servent ici qu'à désigner le site avec lequel cette API fonctionne. ScrapeUnblocker est un service indépendant, sans lien avec le titulaire de 1688.com, et n'est ni approuvé ni parrainé par lui.
Commencez à scraper ce site dès aujourd'hui
Palier gratuit inclus. Aucune carte bancaire requise pour tester.