Alibaba Listings Scraper

Alibaba Listings Scraper is an Apify Actor for searching Alibaba.com B2B listings by keyword or Alibaba search/category URL. It returns one record per product card, which means each dataset item represents a listing shown in search results rather than a single product-detail page. The output includes title, price range, MOQ, supplier name, supplier country, years on Alibaba, Verified / Gold Supplier / Trade Assurance flags, rating, image, product URL, and related supplier signals when available. It is usable through Apify MCP and through the Apify platform UI and API.

Best fit and connected workflows

This Actor fits workflows that start with Alibaba search results and end with structured supplier research.

Use it when you want to:

• collect B2B product cards for sourcing analysis,
• compare supplier indicators such as country, years on Alibaba, and verification flags,
• build lists for procurement review or marketplace monitoring,
• feed a downstream enrichment step with Alibaba product URLs and supplier details.

Use A practical next-step pairing is Alibaba Products Scraper - Suppliers, Prices & MOQ when your workflow moves from search-result discovery to a more focused product and supplier contract.

Example scenario

Mina, a sourcing manager, starts with the keyword stainless steel water bottle and wants a shortlist of listings for review. She runs the Actor with maxResults, verifiedOnly, and tradeAssuranceOnly enabled, then reviews returned fields such as priceMin, minOrderQuantity, supplierName, supplierCountry, supplierYearsOnAlibaba, and rating. She uses those records to decide which suppliers deserve a manual quote request, then opens the product URLs for the selected listings.

Input

Field	Type	What it controls
searchQuery	string	Keyword search for Alibaba B2B product listings.
startUrls	array	Alibaba search or category URLs to scrape directly.
maxResults	integer	Maximum number of product records to return.
sortBy	string	Result order: relevance, transactionDesc, responseRate, priceAsc, priceDesc, or newest.
minPrice	integer	Lower bound for unit price in USD.
maxPrice	integer	Upper bound for unit price in USD.
minMoq	integer	MOQ lower bound passed to Alibaba search.
maxMoq	integer	MOQ upper bound applied after extraction.
verifiedOnly	boolean	Keeps Verified or Gold Supplier listings.
tradeAssuranceOnly	boolean	Keeps listings with Trade Assurance.
minSupplierYears	integer	Supplier age floor on Alibaba.
supplierCountries	array	ISO-2 supplier country whitelist.
minRating	integer	Supplier rating floor from 0 to 5.
minOrders	integer	Minimum recorded orders or transactions.
site	string	Alibaba domain, currently www.alibaba.com.
proxyConfiguration	object	Proxy settings, with Apify proxy enabled by default.

Valid input example

{
  "searchQuery": "wireless earbuds",
  "maxResults": 25,
  "sortBy": "transactionDesc",
  "verifiedOnly": true,
  "tradeAssuranceOnly": true,
  "minSupplierYears": 3,
  "supplierCountries": ["CN"],
  "minRating": 4,
  "minOrders": 50
}

Output

One dataset record represents one Alibaba product listing card.

Field	Type	Meaning
recordType	string	Always product.
productId	string	Alibaba product identifier.
title	string	Listing title.
productUrl	string	Product URL.
imageUrl	string	Listing image URL.
priceMin	number	Lower value from the displayed price range.
priceMax	number	Upper value from the displayed price range.
currency	string	Price currency.
minOrderQuantity	integer	MOQ value.
moqUnit	string	MOQ unit such as piece.
supplierName	string	Supplier name.
supplierId	string	Supplier identifier.
supplierUrl	string	Supplier storefront URL.
supplierCountry	string	Supplier country code or value.
supplierCountryInferred	boolean	Indicates inferred supplier country.
supplierYearsOnAlibaba	integer	Years the supplier has been on Alibaba.
isVerifiedSupplier	boolean	Verified supplier flag.
isGoldSupplier	boolean	Gold Supplier flag.
isTradeAssurance	boolean	Trade Assurance flag.
responseRatePercent	number	Supplier response rate.
rating	number	Supplier rating.
reviewsCount	integer	Review count.
ordersCount	integer	Recorded orders or transactions.
position	integer	Listing position in results.
searchQuery	string	Original query used for the run.
site	string	Alibaba domain used.
scrapedAt	string	Timestamp for the record.
_warnings	array	Optional extraction notes.

Illustrative output record

{
  "recordType": "product",
  "productId": "1600123456789",
  "title": "Bluetooth 5.3 Wireless Earbuds TWS",
  "productUrl": "https://www.alibaba.com/product-detail/example_1600123456789.html",
  "imageUrl": "https://s.alicdn.com/example.jpg",
  "priceMin": 2.5,
  "priceMax": 4.8,
  "currency": "USD",
  "minOrderQuantity": 10,
  "moqUnit": "piece",
  "supplierName": "Shenzhen Audio Tech Co., Ltd.",
  "supplierId": "220123456789",
  "supplierUrl": "https://shenzhen-audio.en.alibaba.com",
  "supplierCountry": "CN",
  "supplierCountryInferred": true,
  "supplierYearsOnAlibaba": 7,
  "isVerifiedSupplier": true,
  "isGoldSupplier": true,
  "isTradeAssurance": true,
  "responseRatePercent": 98.5,
  "rating": 4.8,
  "reviewsCount": 342,
  "ordersCount": 1250,
  "position": 1,
  "searchQuery": "wireless earbuds",
  "site": "www.alibaba.com",
  "scrapedAt": "2026-06-20T17:30:00.000Z"
}

How it works

The Actor opens Alibaba search-result pages from a keyword or from supplied search/category URLs, then collects product listing cards across pages until maxResults is reached. The live contract specifies a PlaywrightCrawler implementation with Chromium, embedded JSON first parsing, DOM fallback, session pool, and fingerprints. It also auto-paginates through result pages and respects the result cap as the cost ceiling. The proxy setup prefers Apify residential proxy when available and falls back to Apify datacenter proxy through the default configuration.

Pricing

This Actor uses Pay per event plus Apify platform usage. The live contract charges one event for Actor start and one event for each Alibaba product scraped into the dataset. Filtered-out products are not billed.

Example: a run that returns one hundred product records charges one start event plus one hundred product events. For current billing details, open the live Pricing tab on the Apify Actor page.

Use with AI agents (MCP)

This Actor is available through Apify MCP as a tool for Alibaba listing discovery and supplier signal extraction.

Tool description: retrieve Alibaba B2B search-result listings by keyword or Alibaba search/category URL and return structured product cards with pricing, MOQ, supplier, verification, and rating fields.

Exact Actor identity: khadinakbar/alibaba-listings-scraper

Find Alibaba B2B listings for "wireless earbuds", keep Verified or Gold Suppliers with Trade Assurance, and return the first 25 product cards with price range, MOQ, supplier country, years on Alibaba, rating, and product URLs.

Output interpretation:

• Each dataset record is one product card from Alibaba search results.
• productId identifies the listing.
• supplierName, supplierCountry, supplierYearsOnAlibaba, isVerifiedSupplier, isGoldSupplier, and isTradeAssurance support supplier screening.
• priceMin and priceMax reflect the listing's displayed unit price range.
• position shows the listing order in the source results.
• scrapedAt supports freshness checks in agent workflows.

Provenance and scope:

• Source pages are Alibaba search or category pages.
• Product-detail URLs and non-Alibaba URLs are outside the search contract for this Actor.
• The output is a dataset that can be read through the Apify API and reused in downstream agent steps.

Pagination and cost guidance:

• maxResults sets the upper bound for returned product cards.
• The Actor auto-paginates until that cap is met.
• Each returned product card is a billable event, so the cap also works as a budget control.

Apify API example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
  token: process.env.APIFY_TOKEN,
});

const run = await client.actor('khadinakbar/alibaba-listings-scraper').call({
  searchQuery: 'wireless earbuds',
  maxResults: 10,
  verifiedOnly: true,
  tradeAssuranceOnly: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);

Set APIFY_TOKEN in your environment before running the example. The dataset readback returns the product records collected by the Actor.

Best results and outcome guidance

Use a keyword when you want broad discovery. Use startUrls when you already have a curated Alibaba search or category page. Pair verifiedOnly, tradeAssuranceOnly, minSupplierYears, supplierCountries, minRating, and minOrders when your review process benefits from supplier signals as part of the first pass. Keep maxResults aligned with the number of records you want to review downstream. If the search task is country-specific, set supplierCountries with ISO-2 codes such as CN or VN.

Design note

I found that the output schema requires recordType, productId, and scrapedAt, which makes each dataset row easy to treat as a timestamped product event.

FAQ

Can I use a keyword and a search URL together?

Yes. The input schema accepts both searchQuery and startUrls, and both can be used to shape discovery.

What kind of pages work with startUrls?

Alibaba search and category pages fit the input contract. Product-detail URLs sit outside the listing-scrape workflow for this Actor.

What fields help with supplier screening?

supplierCountry, supplierYearsOnAlibaba, isVerifiedSupplier, isGoldSupplier, isTradeAssurance, rating, reviewsCount, and ordersCount are the key supplier-facing fields in the dataset.

How does maxResults relate to cost?

The Actor stops at the maxResults cap, and each returned product card counts as one billable event.

Is this Actor usable through MCP?

Yes. It is MCP-ready and exposed as khadinakbar/alibaba-listings-scraper for agent workflows.

Responsible use

Use Alibaba Listings Scraper for compliant sourcing, catalog analysis, and supplier research on publicly accessible search-result pages. Follow Alibaba's terms, local laws, and your organization's data handling rules when storing or reusing results.