Tmall product data API

ShopAPIS extracts structured product data from Tmall — Alibaba’s B2C brand marketplace — and returns it as clean JSON. For any Tmall flagship-store listing you get title, live and promo price, full SKU variant matrix, seller (flagship/authorized-store) identity, brand authorization status, rating, review count with image reviews, category taxonomy and the image gallery, without building or hosting a China-based scraper.

Tmall is where global and Chinese brands sell direct, with roughly $683B GMV in 2024 (estimate) and close to 1 billion annual buyers across the Alibaba ecosystem (plan2 research). It is the cleaner, brand-verified counterpart to Taobao — strongest in electronics, beauty and FMCG.

Why Tmall data is hard to get

Tmall sits behind the same Alibaba anti-bot wall as Taobao. Expect GeeTest v4 slider CAPTCHAs, behavioral device fingerprinting and Great Firewall (GFW) geo-blocking of non-mainland traffic, with prices and SKUs rendered client-side from rotating, token-verified endpoints (GeeTest ). The Alibaba Open Platform is partial and gated and will not return arbitrary competitor catalogs. ShopAPIS handles the slider, fingerprint and geo layers in-region and returns the parsed fields directly.

Data fields returned

• Identity — item ID, title, brand, category path, flagship-store flag
• Price — current price, list price, promo price, currency (CNY)
• Variants — SKU matrix (color/size/spec), per-SKU price and stock
• Availability — in-stock flag, per-SKU stock
• Sales signal — monthly sales volume, cumulative sold
• Seller — flagship vs authorized store, shop name, brand authorization
• Reviews — count, average rating, review text, image reviews
• Media — image gallery, SKU thumbnails, detail images
• Logistics — ships-from, free-shipping flag

Sample response

{
  "platform": "tmall",
  "item_id": "789012345678",
  "url": "https://detail.tmall.com/item.htm?id=789012345678",
  "title": "兰蔻小黑瓶精华肌底液 50ml",
  "brand": "LANCOME / 兰蔻",
  "category_path": ["美妆", "护肤", "精华"],
  "store_type": "官方旗舰店",
  "brand_authorized": true,
  "price": { "current": 1080.00, "list": 1280.00, "promo": 999.00, "currency": "CNY" },
  "monthly_sales": 12650,
  "skus": [
    { "sku_id": "30ml", "spec": "30ml", "price": 720.00, "stock": 540 },
    { "sku_id": "50ml", "spec": "50ml", "price": 1080.00, "stock": 0 }
  ],
  "seller": { "shop_name": "兰蔻官方旗舰店", "shop_id": "lancome-flagship", "dsr": { "description": 4.9, "service": 4.9, "logistics": 4.9 } },
  "reviews": { "count": 86420, "rating": 4.9, "with_images": 9210 },
  "free_shipping": true,
  "images": ["https://img.alicdn.com/.../a.jpg", "https://img.alicdn.com/.../b.jpg"]
}

Markets and domains covered

Tmall is China-domestic: domains tmall.com and detail.tmall.com, plus Tmall Global (tmall.hk) for cross-border import listings. Pricing is CNY; ShopAPIS returns original and normalized fields and resolves by item ID or URL.

Use cases

• Brand MAP compliance — verify authorized-store pricing against your minimum advertised price (/solutions/map-compliance).
• Competitive intelligence — monitor brand flagship assortment and promo cadence (/solutions/competitive-intelligence).
• Price monitoring — track list vs promo spreads on branded SKUs (/solutions/price-monitoring).
• Review analytics — analyze verified-brand review sentiment.

Related