Alibaba Scraper data API: fields, sample output and cost per 1,000 rows

Scrape Alibaba.com product offers by keyword: title, price range and quantity price tiers, minimum order, units sold, ratings, certifications, and the supplier's name, country, years, Gold and verified badges, Trade Assurance and response rate.

This is the reference for the Actor v0iddo/alibaba-scraper: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.

At a glance

Actor	v0iddo/alibaba-scraper
Store page	Alibaba Scraper
Output	one row per result, as JSON, CSV, Excel or HTML
Fields per row	29 (12 text, 11 number, 3 true/false, 2 list, 1 URL)
Cap on results	maxItems in the input
Price	$0.75 per 1,000 results

Output fields

Each result is one row with these fields (fields that name people are left out):

Field	Type	Meaning	Sample value
productId	text	Product ID	1601209913000
title	text	Title	Wholesale Custom Print logo Curve Arch Oval Shape Eco-friendly Yoga...
priceMin	number	Price from	13.9
priceMax	number	Price to	13.9
minOrder	number	Min order	1
minOrderUnit	text	Unit	piece
sold	number	Sold	655
supplierName	text	Supplier	Hunan Sanmo Sports Goods Co., Ltd.
supplierCountry	text	Country	China
url	URL	Product URL	https://www.alibaba.com/product-detail/wholesale-eco-friendly-custo...
searchTerm	text		yoga mat
page	number		1
position	number		1
currency	text		USD
priceText	text		US $13.90
minOrderText	text		1 piece
quantityPrices	list		[{"minQuantity": 1, "maxQuantity": null, "price": 13.9, "unit": "Pi...
soldText	text		655 sold
productRating	number		4.9
supplierRating	number		4.8
supplierReviews	number		122
certifications	list		["REACH"]
supplierCountryCode	text		CN
supplierYears	number		3
goldSupplier	true/false		true
verifiedSupplier	true/false		true
tradeAssurance	true/false		true
responseRate	number		99.9
image	text		https://s.alicdn.com/@sc04/kf/H5f8e09fbf6ac46dc8186def59e788754q.jpg

One record

{
  "searchTerm": "yoga mat",
  "page": 1,
  "position": 1,
  "productId": "1601209913000",
  "title": "Wholesale Custom Print logo Curve Arch Oval Shape Eco-friendly Yoga Mats Pu Rubber Non-slip Pilates Mat Tapis Yoga Workout Mats",
  "priceMin": 13.9,
  "priceMax": 13.9,
  "currency": "USD",
  "priceText": "US $13.90",
  "minOrder": 1,
  "minOrderUnit": "piece",
  "minOrderText": "1 piece",
  "quantityPrices": [
    {
      "minQuantity": 1,
      "maxQuantity": null,
      "price": 13.9,
      "unit": "Piece"
    }
  ],
  "sold": 655,
  "soldText": "655 sold",
  "productRating": 4.9,
  "supplierRating": 4.8,
  "supplierReviews": 122,
  "certifications": [
    "REACH"
  ],
  "supplierName": "Hunan Sanmo Sports Goods Co., Ltd.",
  "supplierCountry": "China",
  "supplierCountryCode": "CN",
  "supplierYears": 3,
  "goldSupplier": true,
  "verifiedSupplier": true,
  "tradeAssurance": true,
  "responseRate": 99.9,
  "image": "https://s.alicdn.com/@sc04/kf/H5f8e09fbf6ac46dc8186def59e788754q.jpg",
  "url": "https://www.alibaba.com/product-detail/wholesale-eco-friendly-custom-print-logo_1601209913000.html"
}

Input parameters

Parameter	Type	Required	Default	What it does
searchTerms	array	no	["led strip lights"]	Products as a buyer would type them, one per line, for example led strip lights.
searchUrls	array	no		Optional alibaba.com keyword pages (https://www.alibaba.com/wholesale/....html).
maxPages	integer	no	2	How many result pages (about 47 offers each) to read per keyword.
maxItems	integer	no	200	The run stops after this many result rows.
onlyNew	boolean	no	false	Skip rows that an earlier run with the same input already returned, so a scheduled run gives each new row once.

Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

• Alibaba yoga mat suppliers with prices and MOQ
• Alibaba phone case manufacturers with MOQ and price tiers
• Alibaba LED strip lights wholesale prices and suppliers

Cost per 1,000 rows

$0.75 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $0.53 per 1,000.

Results	Cost at the listed price	Cost at the lowest plan price
100	$0.07	$0.05
1,000	$0.75	$0.53
10,000	$7.50	$5.25
100,000	$75.00	$52.50

The figures are the listed price times the number of results. The maxItems limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.

Get the rows as CSV over HTTP

One request starts a run, waits for it and returns the dataset. The format parameter picks the file type and fields picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.

curl -X POST "https://api.apify.com/v2/acts/v0iddo~alibaba-scraper/run-sync-get-dataset-items?format=csv&fields=productId,title,priceMin" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["led strip lights"], "maxPages": 1, "maxItems": 20}'

Good to know

• Reads Alibaba's public keyword pages (alibaba.com/wholesale/...). Its search box pages are closed to automated access in robots.txt, so filters such as price range or supplier type are not offered.
• Most product keywords have a page. When one has none, the run tries the plural once and logs the keyword if that has none either.
• Prices are as shown to a visitor of the English site, usually in US dollars; quantityPrices lists the price per quantity tier when the offer has tiers.
• Supplier contact details are not collected.

Links

• Actor on the Apify Store: Alibaba Scraper
• Guide with the Python and JavaScript code: https://voidd0.github.io/alibaba-scraper/
• Step by step: https://voiddo.com/export/alibaba-scraper/