Alibaba B2B Product Scraper

Browser-first extraction for public Alibaba.com product search and product-detail pages. The Actor supports rich product fields, multiple sources, bounded pagination, global filtering/sorting/deduplication, optional product-detail enrichment, Apify Proxy routing, and fail-closed diagnostics.

The dataset is marketplace-focused. Product rows intentionally omit Actor-debugging wrappers such as recordId, recordType, status, success, ok, dataAvailable, found, fieldCoverage, dataQuality, extractionMethod, fallbackMode, and usedProxy. Operational counts remain in OUTPUT_SUMMARY.

Extracted fields

Depending on public availability, product rows can include:

• identity: productId, title, name, productUrl, url
• pricing and order terms: price, priceFormatted, priceMin, priceMax, currency, moq, minimumOrderQuantity, minimumOrderUnit
• supplier: supplierName, companyName, supplierSlug, supplierId, companyId, supplierProfileUrl, supplierHomepage, supplierCountry, supplierLocation, supplierYears, supplierYearsText
• ratings and engagement: supplierRating, productRating, supplierReviewCount, reviewCount, productScore, shippingScore, starLevel, soldCount, soldText, reorderRatePercent, reorderRateText
• delivery and merchandising: deliveryText, leadTime, shippingInfo, isAd, isCertified, certified, canAddToCart, canChatNow, badges, badgeTexts, badgeCount, promotions, sellingPoints
• media and details: imageUrl, thumbnail, images, imageUrls, imageCount, imageAlt, description, brand, sku, manufacturer, category, attributes, detailImageUrls, availability, detailPrice, detailCurrency, detailRating, detailReviewCount, detailCanonicalUrl
• provenance: source, sourceUrl, pageNumber, pageNum, position, keyword, country, locale, keywordMatchScore, scrapedAt

Missing values are omitted rather than guessed. thumbnail, imageUrl, and imageUrls[0] point to the same validated product image when media is available. Images are scoped to the product card/detail payload and filtered for common non-product assets.

Input examples

Keyword search

{
  "keyword": "wireless earbuds",
  "maxItems": 40,
  "maxPages": 3,
  "sortBy": "best_match",
  "includeMedia": true,
  "includeDetails": false
}

Filters and global sorting

{
  "keyword": "led work light",
  "maxItems": 100,
  "maxPages": 5,
  "sortBy": "rating_desc",
  "excludeAds": true,
  "certifiedOnly": true,
  "supplierCountry": "CN",
  "minPrice": 10,
  "maxPrice": 40,
  "minOrderQuantity": 5,
  "minSupplierRating": 4.7,
  "minReviewCount": 100,
  "minSoldCount": 300,
  "minReorderRatePercent": 30,
  "requiredBadges": ["certified"]
}

Multiple sources and detail enrichment

{
  "startUrls": [
    { "url": "https://www.alibaba.com/trade/search?SearchText=packaging&has4Tab=true&tab=all" },
    { "url": "https://www.alibaba.com/trade/search?SearchText=gift+bags&has4Tab=true&tab=all" },
    { "url": "https://www.alibaba.com/product-detail/Rechargeable-LED-Work-Light_1234567890123.html" }
  ],
  "maxItems": 100,
  "maxPages": 4,
  "includeDetails": true,
  "maxDetailItems": 20,
  "deduplicate": true,
  "includeDiagnostics": true
}

Developer options and Apify Proxy

{
  "keyword": "wireless earbuds",
  "requestDelayMs": 1200,
  "maxConcurrency": 2,
  "maxRequestRetries": 3,
  "requestTimeoutSecs": 60,
  "requestHandlerTimeoutSecs": 300,
  "selectorTimeoutSecs": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

maxPages: 0 enables automatic pagination with a hard 100-page cap. maxItems is global across every source and page. Pages within one source are sequential; maxConcurrency limits independent source work. Proxy routing only changes transport; it does not solve CAPTCHA or bypass an access control.

Deterministic local QA

{
  "keyword": "led light",
  "fixtureFile": "fixtures/sample.html",
  "maxItems": 10,
  "maxPages": 1,
  "requestDelayMs": 0,
  "includeDiagnostics": true
}

Product output example

{
  "productId": "1234567890123",
  "title": "Rechargeable LED Work Light",
  "name": "Rechargeable LED Work Light",
  "url": "https://www.alibaba.com/product-detail/Rechargeable-LED-Work-Light_1234567890123.html",
  "productUrl": "https://www.alibaba.com/product-detail/Rechargeable-LED-Work-Light_1234567890123.html",
  "price": "US $12.50 - US $18.75",
  "priceMin": 12.5,
  "priceMax": 18.75,
  "currency": "USD",
  "minimumOrderQuantity": 10,
  "minimumOrderUnit": "pieces",
  "supplierName": "Example Lighting Co., Ltd.",
  "supplierProfileUrl": "https://examplelighting.en.alibaba.com/company_profile.html",
  "supplierCountry": "CN",
  "supplierYears": 8,
  "supplierRating": 4.8,
  "productRating": 4.7,
  "reviewCount": 125,
  "soldCount": 320,
  "reorderRatePercent": 32,
  "isCertified": true,
  "badges": ["Certified", "CE"],
  "images": [
    "https://s.alicdn.com/@sc04/kf/rechargeable-led-work-light.jpg",
    "https://s.alicdn.com/@sc04/kf/rechargeable-led-work-light-side.jpg"
  ],
  "imageUrl": "https://s.alicdn.com/@sc04/kf/rechargeable-led-work-light.jpg",
  "thumbnail": "https://s.alicdn.com/@sc04/kf/rechargeable-led-work-light.jpg",
  "imageCount": 2,
  "source": "Alibaba.com",
  "sourceUrl": "https://www.alibaba.com/trade/search?SearchText=led+light&has4Tab=true&tab=all",
  "pageNumber": 1,
  "position": 1,
  "scrapedAt": "2026-09-05T00:00:00.000Z"
}

Blocked or unavailable public pages produce a minimal diagnostic row:

{
  "url": "https://www.alibaba.com/trade/search?SearchText=wireless+earbuds",
  "error": "Alibaba presented an access-control or challenge response.",
  "errorCode": "ACCESS_BARRIER_BLOCKED"
}

Local validation

npm ci --omit=dev
npm test
apify validate-schema
apify run --purge --input-file test-inputs/default.json
npm run validate

The validator checks canonical product URLs, product-scoped image URLs, thumbnail === images[0], and the absence of debugging wrappers. The Actor never fabricates product data when Alibaba returns a challenge, login wall, rate limit, or empty public response.