Alibaba Supplier Shortlist by Price, MOQ and Trust: how to get the data as JSON/CSV (API, Python, no code)

Q: How do I use the Alibaba Supplier Shortlist by Price, MOQ and Trust from Python?

Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/alibaba-supplier-shortlist with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.

Q: How do I limit the number of results?

Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.

Get a ranked shortlist of Alibaba.com suppliers for each product you name: each supplier scored on price against the market median, fit to your minimum order, Verified, Trade Assurance, years, rating and units sold, with its best offer and the reasons. This guide shows the output fields, a working input, and Python, JavaScript and cURL code for the Actor v0iddo/alibaba-supplier-shortlist on Apify.

Open Alibaba Supplier Shortlist by Price, MOQ and Trust on Apify

What data you get

One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.

Field	Label	Type	Example
`rank`	Rank	number	1
`score`	Score	number	94.3
`supplierName`	Supplier	text	Shenzhen OPTO365 Technology Co., Ltd.
`supplierCountry`	Country	text	China
`bestPrice`	Best price	number	0.69
`bestMinOrder`	Min order	number	10
`fitsTargets`	Fits targets	true/false	true
`verifiedSupplier`	Verified	true/false	true
`supplierYears`	Years	number	12
`why`	Why	text	from $0.69, 59% under the median $1.67 of the 87 offers read; withi...
`bestOfferUrl`	Best offer	URL	https://www.alibaba.com/product-detail/High-Lumen-Black-FPC-12V-24V...
`searchTerm`		text	led strip lights
`scoreParts`		object	{"price": 30.2, "order": 15, "trust": 34.9, "proof": 14.2}
`priceFit`		true/false	true
`moqFit`		true/false	true
`supplierCountryCode`		text	CN
`tradeAssurance`		true/false	true
`goldSupplier`		true/false	true
`responseRate`		number	99.1
`supplierRating`		number	4.8
`supplierReviews`		number	227
`bestPriceMax`		number	0.99
`currency`		text	USD
`minOrderUnit`		text	meters
`bestOfferTitle`		text	2-Year Warranty High Lumen Black Copper 12V LED Strip Light SMD5050...
`image`		text	https://s.alicdn.com/@sc04/kf/HTB1hwKpJpXXXXa4XpXXq6xXFXXXv.jpg
`marketMedianPrice`		number	1.67
`priceVsMedianPct`		number	-59
`offersRead`		number	87
`suppliersSeen`		number	83
`suppliersMatched`		number	83
`offersOfSupplier`		number	1
`unitsSold`		number	1372
`certifications`		list	["CE", "DECLARATION OF CONFORMITY", "ROHS"]
`chargeUnits`		number	1

Input example

This is the input that is pre-filled on the Actor page. Change the values for your own run.

{
  "searchTerms": [
    "led strip lights"
  ],
  "targetPrice": 5,
  "targetMOQ": 50,
  "maxPages": 2,
  "shortlistSize": 10,
  "maxItems": 20
}

Input field	Type	What it does
`searchTerms`	array	Products as a buyer would type them, one per line, for example led strip lights.
`targetPrice`	number	The most you want to pay per unit.
`targetMOQ`	integer	How many units you plan to order first.
`shortlistSize`	integer	How many suppliers each product's shortlist names.
`maxPages`	integer	Alibaba result pages (about 47 offers each) read for each product.
`supplierCountries`	array	Only suppliers from these countries: names or codes, for example China, Vietnam, IN, Hong Kong.
`verifiedSupplier`	boolean	Only suppliers with Alibaba's verified badge.
`tradeAssurance`	boolean	Only suppliers that take Trade Assurance orders.
`minSupplierRating`	string	Only suppliers rated at least this (out of 5).
`certifications`	array	Only offers with any of these certifications, for example CE, RoHS, FCC.
`maxItems`	integer	The run stops after this many result rows.

Output sample

Real rows from a run of the Actor. Fields that name people are left out of the sample.

[
  {
    "searchTerm": "led strip lights",
    "rank": 1,
    "score": 94.3,
    "scoreParts": {
      "price": 30.2,
      "order": 15,
      "trust": 34.9,
      "proof": 14.2
    },
    "fitsTargets": true,
    "priceFit": true,
    "moqFit": true,
    "supplierName": "Shenzhen OPTO365 Technology Co., Ltd.",
    "supplierCountry": "China",
    "supplierCountryCode": "CN",
    "supplierYears": 12,
    "verifiedSupplier": true,
    "tradeAssurance": true,
    "goldSupplier": true,
    "responseRate": 99.1,
    "supplierRating": 4.8,
    "supplierReviews": 227,
    "bestPrice": 0.69,
    "bestPriceMax": 0.99,
    "currency": "USD",
    "bestMinOrder": 10,
    "minOrderUnit": "meters",
    "bestOfferTitle": "2-Year Warranty High Lumen Black Copper 12V LED Strip Light SMD5050 RGB Multicolor 60LED/M IP65 Waterproof Voice Control 5M/Roll",
    "bestOfferUrl": "https://www.alibaba.com/product-detail/High-Lumen-Black-FPC-12V-24V_60341772053.html",
    "image": "https://s.alicdn.com/@sc04/kf/HTB1hwKpJpXXXXa4XpXXq6xXFXXXv.jpg",
    "marketMedianPrice": 1.67,
    "priceVsMedianPct": -59,
    "offersRead": 87,
    "suppliersSeen": 83,
    "suppliersMatched": 83,
    "offersOfSupplier": 1,
    "unitsSold": 1372,
    "certifications": [
      "CE",
      "DECLARATION OF CONFORMITY",
      "ROHS"
    ],
    "why": "from $0.69, 59% under the median $1.67 of the 87 offers read; within your $5.00; minimum order 10 meters fits your 50; Verified; Trade As...",
    "chargeUnits": 1
  },
  {
    "searchTerm": "led strip lights",
    "rank": 2,
    "score": 89.8,
    "scoreParts": {
      "price": 26.1,
      "order": 15,
      "trust": 35,
      "proof": 13.7
    },
    "fitsTargets": true,
    "priceFit": true,
    "moqFit": true,
    "supplierName": "Shenzhen Hongtai World Lighting Co., Ltd.",
    "supplierCountry": "China",
    "supplierCountryCode": "CN",
    "supplierYears": 15,
    "verifiedSupplier": true,
    "tradeAssurance": true,
    "goldSupplier": true,
    "responseRate": 99.2,
    "supplierRating": 4.9,
    "supplierReviews": 54,
    "bestPrice": 0.9,
    "bestPriceMax": 1.2,
    "currency": "USD",
    "bestMinOrder": 1,
    "minOrderUnit": "meter",
    "bestOfferTitle": "Led Strip Silicone Profile Diffuser Silicone Neon Light Strips Led Strip Lights Driveway Lighting with Silicone",
    "bestOfferUrl": "https://www.alibaba.com/product-detail/Led-Strip-Silicone-Profile-Diffuser-Silicone_1601567633729.html",
    "image": "https://s.alicdn.com/@sc04/kf/H09f8b639fac84489a0f8ce01bca7d299k.jpg",
    "marketMedianPrice": 1.67,
    "priceVsMedianPct": -46,
    "offersRead": 87,
    "suppliersSeen": 83,
    "suppliersMatched": 83,
    "offersOfSupplier": 1,
    "unitsSold": 407,
    "certifications": [
      "CE",
      "DECLARATION OF CONFORMITY",
      "ROHS"
    ],
    "why": "from $0.90, 46% under the median $1.67 of the 87 offers read; within your $5.00; minimum order 1 meter fits your 50; Verified; Trade Assu...",
    "chargeUnits": 0
  }
]

Code: Python, JavaScript and cURL

Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/alibaba-supplier-shortlist.

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {'searchTerms': ['led strip lights'],
 'targetPrice': 5,
 'targetMOQ': 50,
 'maxPages': 2,
 'shortlistSize': 10,
 'maxItems': 20}

run = client.actor("v0iddo/alibaba-supplier-shortlist").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript (apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const input = {
  "searchTerms": [
    "led strip lights"
  ],
  "targetPrice": 5,
  "targetMOQ": 50,
  "maxPages": 2,
  "shortlistSize": 10,
  "maxItems": 20
};

const run = await client.actor('v0iddo/alibaba-supplier-shortlist').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

cURL

curl -X POST "https://api.apify.com/v2/acts/v0iddo~alibaba-supplier-shortlist/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["led strip lights"], "targetPrice": 5, "targetMOQ": 50, "maxPages": 2, "shortlistSize": 10, "maxItems": 20}'

Price

$490.00 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 $343.00 per 1,000. See the pricing tab for your plan. A new Apify account gets $5 of platform credit every month.

Good to know

Reads Alibaba's public keyword pages (alibaba.com/wholesale/...), the same pages as our Alibaba Scraper; its search box pages are closed to automated access in robots.txt. Supplier contact details...
The score, out of 100: price 35 (how many offers read cost the same or more), order size 15, trust 35 (Verified 10, Trade Assurance 8, Gold Supplier 3, years up to 8, response rate up to 6), proof...
With a target price or order size, the suppliers that fit both come first, then the score decides. Each supplier's best offer is the one that fits best and then costs least; otherOffers lists up...
The market median is that of the offers read, so more pages give a steadier median and more suppliers.

FAQ

What data does the Alibaba Supplier Shortlist by Price, MOQ and Trust return?

Each result is one row in an Apify dataset. Fields include rank, score, supplierName, supplierCountry, bestPrice, bestMinOrder, fitsTargets, verifiedSupplier, and more. The table above shows every field with an example value.

How do I use the Alibaba Supplier Shortlist by Price, MOQ and Trust from Python?

Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/alibaba-supplier-shortlist with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.

Can I use it without writing code?

Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.

How much does it cost?

$490.00 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 $343.00 per 1,000. A new Apify account gets $5 of platform credit every month.

How do I limit the number of results?

Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.

Can I send the results to Google Sheets, Make, Zapier or n8n?

Yes. Apify datasets connect to Google Sheets, Slack, Make, Zapier and n8n, and a webhook can call your own service when a run finishes. You can also export the dataset as JSON, CSV or Excel.

Open Alibaba Supplier Shortlist by Price, MOQ and Trust on Apify

Related guides

Myntra Product Scraper: Scrape Myntra category and search listing pages into product rows: product ID, name, brand, price, MRP, dis...
Rakuten Ichiba Listings Scraper: Scrape Rakuten Ichiba search results into product rows: title, JPY price, shop name, review score, review c...
CarGurus Zipcode Search Scraper: Scrape CarGurus vehicle search pages by ZIP code: VIN, make, model, year, trim, price, MSRP, mileage, fuel...