E-commerce
Taobao & Tmall Scraper
taobao.com
Taobao et Tmall, les marketplaces grand public d'Alibaba Group en Chine, sont servis par deux endpoints de plugin dédiés plutôt que par la récupération de page générique. Donnez à l'endpoint de recherche un mot-clé - en chinois pour obtenir le plus d'annonces, comme '手机壳', ou en anglais - ou un identifiant de catégorie, et il renvoie les produits que Taobao liste pour lui, déjà analysés : identifiant et clé de catalogue de l'article, titre, lien et image, le prix en yuans avec l'étiquette de prix de Taobao (comme un prix remisé) et le même prix en devises locales, l'identifiant et le nom de la boutique, la note de description de la boutique, la livraison gratuite, les identifiants de catégorie, les arguments de vente et les extraits d'avis mis en avant, ainsi que le nombre d'annonces correspondantes selon Taobao et les filtres de marque et de propriété que vous pouvez appliquer ensuite. Triez par pertinence, ventes ou prix, filtrez par fourchette de prix en yuans ou par une marque ou une propriété, et obtenez jusqu'à 20 produits par mot-clé. Un mot-clé pour lequel Taobao n'a pas de liste publique reçoit la liste du mot-clé le plus proche que Taobao suggère lui-même, et la réponse le signale. L'endpoint article accepte la clé de catalogue que porte chaque résultat de recherche (itemKey), ou le lien de catalogue de l'article, et renvoie l'article : la plateforme (Taobao ou Tmall), le titre, le prix, le prix d'origine et la fourchette de prix en yuans, l'image, le lieu d'expédition, le chemin de catégories, la livraison gratuite, les moyens de paiement, la répartition des notes des acheteurs (articles Taobao uniquement, Tmall ne la publie pas), le dernier avis avec étoiles, texte, date, variante et médias mais sans l'identité de son auteur, et la boutique avec son type de vendeur, son niveau de crédit, sa date d'ouverture, son nombre d'articles et ses notes de description, de service et de livraison. Il lit le catalogue que Taobao publie pour les visiteurs non connectés, aucune connexion Taobao n'intervient donc, et les SKU, le stock et les ventes mensuelles, que Taobao ne montre qu'après connexion, ne sont pas inclus. Le texte revient en chinois, tel que les vendeurs l'écrivent.
Ce que vous pouvez extraire
- Identifiant et clé de catalogue de l'article (itemKey), titre, lien et lien de catalogue, image et position dans la liste
- Prix en yuans (CNY) avec l'étiquette de prix de Taobao, et prix locaux en SGD, HKD et TWD
- Identifiant et nom de la boutique, note de description, livraison gratuite, identifiants de catégorie, arguments de vente et extraits d'avis mis en avant
- Le nombre d'annonces correspondantes selon Taobao, et des filtres de marque et de propriété pour la recherche suivante
- Recherche par mot-clé en chinois ou en anglais, ou par catégorie, triée par pertinence, ventes ou prix et filtrée par une fourchette de prix en yuans ou par une marque ou une propriété ; jusqu'à 20 produits par mot-clé
- Article : plateforme (Taobao ou Tmall), prix, prix d'origine et fourchette de prix, image, lieu d'expédition, chemin de catégories, livraison gratuite et moyens de paiement
- Article : répartition des notes des acheteurs (articles Taobao) et le dernier avis avec étoiles, texte, date, variante et médias (sans l'identité de son auteur)
- Article : nom, lien et logo de la boutique, type de vendeur, niveau de crédit, date d'ouverture, nombre d'articles et notes de description, de service et de livraison
Endpoints dédiés
/marketplace/taobao-search Une liste Taobao par mot-clé ou catégorie
Les produits que Taobao liste pour un mot-clé (q, en chinois ou en anglais, ou un lien de recherche Taobao) ou une catégorie (category : un identifiant ou un lien de liste de catégorie) : un tableau products avec position, itemId, itemKey (la clé de catalogue de l'article, que l'endpoint article accepte comme item_id), title, url, catalogueUrl (la page publique de l'article dans le catalogue), image, price (yuans), currency, priceLabel, localPrices (le même prix dans la devise de la vitrine, en HKD et en TWD), shopId, shopName, descriptionMatchScore, freeShipping, categoryId, rootCategoryId, sellingPoints et reviewHighlights, ainsi que totalResults, filterOptions (facettes de marque et de propriété ; renvoyez la valeur filter d'une option dans filter), matchedKeyword et keywordSubstituted. sort vaut relevance, sales, price_asc ou price_desc, et price_min et price_max (yuans) ainsi que filter affinent une recherche par mot-clé ; une catégorie renvoie ses meilleures ventes. Jusqu'à 20 produits par appel.
/marketplace/taobao-product Un article Taobao ou Tmall
Un article par item_id, l'itemKey que taobao-search renvoie pour chaque produit, ou par url, le lien de catalogue de l'article (catalogueUrl, ou le lien world.taobao.com avec la même clé) : itemId, itemKey, url, catalogueUrl, platform (taobao ou tmall), title (titleTruncated quand Taobao le raccourcit, comme pour les articles Tmall), price, originalPrice et priceMax (pour une fourchette de prix) en yuans, image, location (lieu d'expédition), categoryId, rootCategoryId, categoryPath, freeShipping, paymentMethods, sellableLanguages, rating (répartition positive, neutre et négative avec les nombres ; articles Taobao uniquement), latestReview (rating, content, date, variant, hasMedia et followUps ; sans l'identité de son auteur) et shop (shopId, name, url, logo, sellerType B = Tmall ou C = Taobao, creditLevel, openedAt, itemCount et scores de description, de service et de livraison). Le catalogue public de Taobao n'ouvre les articles que par cette clé, si bien qu'un identifiant numérique ou un lien item.taobao.com ou detail.tmall.com répond le plus souvent 404. Un 404, comme un article sans page publique, n'est pas facturé.
Comment le scraper
curl -X POST \
-H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
"https://api.scrapeunblocker.com/marketplace/taobao-search?q=%E6%89%8B%E6%9C%BA%E5%A3%B3&sort=sales"import requests
resp = requests.post(
"https://api.scrapeunblocker.com/marketplace/taobao-search",
headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
params={"q": "手机壳", "sort": "sales"},
)
print(resp.text)import { ScrapeUnblockerClient } from 'scrapeunblocker';
const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });
const results = await su.taobaoSearch('手机壳', {
sort: 'sales',
});
const item = await su.taobaoProduct('M3hoaXBUL3N4L2VnVUJncG9JWFphZz09');
console.log(results);
console.log(item); 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": { "q": "手机壳", "category": null, "sort": "sales", "priceMin": null, "priceMax": null, "filter": null },
"matchedKeyword": "手机壳",
"keywordSubstituted": false,
"source": "sg.world.taobao.com",
"sort": "sales",
"currency": "CNY",
"localCurrency": "SGD",
"totalResults": 59366,
"resultsCollected": 20,
"products": [
{
"position": 1,
"itemId": "1078907312106",
"itemKey": "SnA2dmxGcWpIZXRWLzJoZ0tCQjdXQT09",
"title": "【新款18勃艮第红色】图拉斯雪雾适用iPhone18ProMax手机壳苹果17磁吸外壳16pm高级磨砂15Pro保护套14P全包13",
"url": "https://item.taobao.com/item.htm?id=1078907312106",
"catalogueUrl": "https://www.taobao.com/list/item/SnA2dmxGcWpIZXRWLzJoZ0tCQjdXQT09.htm",
"image": "https://img.alicdn.com/imgextra/O1CN01MD26uLjX8UC1chua_!!6000000000818-2-yinhe.png",
"price": 116.0,
"currency": "CNY",
"priceLabel": "优惠价",
"localPrices": [
{ "currency": "SGD", "price": 22.56 },
{ "currency": "HKD", "price": 137.78 },
{ "currency": "TWD", "price": 580.38 }
],
"shopId": "72104903",
"shopName": "图拉斯数码旗舰店",
"descriptionMatchScore": 4.76,
"freeShipping": false,
"areaLimit": false,
"categoryId": "150704",
"rootCategoryId": "50008090",
"sellingPoints": [],
"reviewHighlights": []
},
{
"position": 2,
"itemId": "582890145005",
"itemKey": "SmFWQlNHc2lpUGEzZHVBTlJ6eS9RQT09",
"title": "绿联适用苹果iPhone18ProMax气囊柔盾17手机壳防摔16Pro透明保护套全包+15镜头14超薄13软壳散热高级12xr11",
"url": "https://item.taobao.com/item.htm?id=582890145005",
"catalogueUrl": "https://www.taobao.com/list/item/SmFWQlNHc2lpUGEzZHVBTlJ6eS9RQT09.htm",
"image": "https://img.alicdn.com/imgextra/O1CN01H6TunABXd6C1chua_!!6000000000337-2-yinhe.png",
"price": 29.9,
"currency": "CNY",
"priceLabel": "热销款",
"localPrices": [
{ "currency": "SGD", "price": 5.82 },
{ "currency": "HKD", "price": 35.52 },
{ "currency": "TWD", "price": 149.6 }
],
"shopId": "67095450",
"shopName": "绿联数码旗舰店",
"descriptionMatchScore": 4.87,
"freeShipping": false,
"areaLimit": false,
"categoryId": "150704",
"rootCategoryId": "50008090",
"sellingPoints": [ "全面防护 双C大气囊防摔", "军工级认证 升级气囊防摔" ],
"reviewHighlights": []
}
],
"filterOptions": [
{
"name": "品牌",
"propertyId": "20000",
"options": [
{ "name": "ISIDO/艾思度", "filter": "20000-127298092", "count": 92 },
{ "name": "TORRAS/图拉斯", "filter": "20000-16374678", "count": 101 },
{ "name": "X-IT", "filter": "20000-26061730", "count": 6 }
]
}
]
} Lire la documentation de l'API
Questions fréquentes
Est-il légal de scraper Taobao ?
Collecter des données publiques de Taobao et Tmall comme les titres d'articles, les prix, les noms de boutiques et les notes est licite dans de nombreuses juridictions, mais les règles dépendent de votre pays, des données collectées et de leur usage. Les avis sont renvoyés sans l'identité de leur auteur. ScrapeUnblocker renvoie le catalogue public ; ce que vous collectez et la façon dont vous l'utilisez relèvent de votre responsabilité.
Comment scraper Taobao sans être bloqué ?
Les pages d'article, la page de recherche et les API de données de Taobao demandent toutes une connexion, et une adresse dont Taobao se méfie reçoit sa page intermédiaire - un curseur ou une invitation à se connecter - comme une réponse 200 normale, si bien qu'un scraper simple enregistre cette page comme s'il s'agissait de données. Les plugins lisent le catalogue que Taobao publie pour les visiteurs non connectés, avec une session sans navigateur via des sorties ISP hors de Chine continentale et d'Europe, où Taobao sert ce catalogue ; quand Taobao répond par la page intermédiaire, ils passent à une sortie neuve un nombre limité de fois, puis répondent 502 plutôt que de la renvoyer. Dans le benchmark de ScrapeUnblocker, il a renvoyé de vraies données sur 93,5 % de 1 018 appels, environ 3,8 s par appel. Les mots-clés en chinois ont renvoyé des produits sur 99,4 % des appels ; les mots-clés anglais seulement quand Taobao a une liste publique pour eux (58 %), donc cherchez en chinois quand c'est possible.
Quelles données Taobao puis-je obtenir ?
L'endpoint de recherche renvoie, pour chaque produit, l'identifiant de l'article, le titre, le lien et l'image, le prix en yuans avec l'étiquette de prix de Taobao, le même prix en devises locales, l'identifiant et le nom de la boutique, la note de description de la boutique, la livraison gratuite, les identifiants de catégorie, les arguments de vente et les extraits d'avis mis en avant, ainsi que le nombre d'annonces correspondantes selon Taobao et les filtres de marque et de propriété utilisables ensuite. L'endpoint article renvoie la plateforme (Taobao ou Tmall), le titre, le prix, le prix d'origine et la fourchette de prix, l'image, le lieu d'expédition, le chemin de catégories, la livraison gratuite, les moyens de paiement, la répartition des notes des acheteurs pour les articles Taobao, le dernier avis avec étoiles, texte, date, variante et médias, et la boutique avec son type de vendeur, son niveau de crédit, sa date d'ouverture, son nombre d'articles et ses notes de description, de service et de livraison.
Pourquoi les SKU, le stock et les ventes mensuelles manquent-ils ?
Taobao ne les montre qu'aux visiteurs connectés. Les plugins lisent le catalogue que Taobao publie pour les visiteurs non connectés et n'utilisent aucun compte Taobao, donc les variantes (SKU), le stock et les ventes mensuelles ne sont pas inclus. Les articles Tmall y apparaissent avec un titre raccourci et reviennent avec titleTruncated: true.
Combien de produits puis-je obtenir par recherche ?
Jusqu'à 20 par mot-clé ou catégorie : Taobao ne montre aux visiteurs non connectés que les 20 premiers produits d'une liste. Pour atteindre plus d'annonces sur un mot-clé, découpez-le avec des fourchettes de prix (price_min, price_max) ou avec les filtres de marque et de propriété de filterOptions, et changez l'ordre de tri ; totalResults indique combien d'annonces Taobao annonce. Quand Taobao n'a pas de liste publique pour un mot-clé, l'appel renvoie la liste du mot-clé le plus proche que Taobao suggère lui-même, avec keywordSubstituted: true et le mot-clé utilisé dans matchedKeyword.
Puis-je chercher sur Taobao en anglais ?
Oui, q accepte l'anglais comme le chinois, mais les mots-clés en chinois correspondent à bien plus d'annonces, car les vendeurs Taobao écrivent leurs titres en chinois. Les titres et les textes reviennent tels que les vendeurs les écrivent, en chinois. Un lien de recherche Taobao fonctionne aussi comme q.
Combien coûte le scraping de Taobao ?
Chaque appel qui renvoie des données est une requête : une liste de jusqu'à 20 produits ou un article. 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 mots-clés et les articles sans page publique chez Taobao (404), les blocages et les timeouts ne sont pas facturés, et l'essai gratuit inclut 500 requêtes sans carte bancaire.
Scrapers similaires
Taobao & Tmall et les autres noms et marques de taobao.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 taobao.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.