AliExpress Product Search Scraper

Search AliExpress by keyword (or paste a search/category URL) and export every product listing card as clean, structured JSON — price, original price, discount, rating, orders sold, store, image, and product URL — with built-in filters for sort order, price range, free shipping, minimum rating, and minimum orders. Built for product researchers, dropshippers, and AI agents. MCP-ready.

What you get

One record per product found in AliExpress search results:

Field	Description
position	Rank of the product across the result pages (1, 2, 3, …)
title	Product title
price	Current sale price (number)
originalPrice	Pre-discount price, when shown
discountPercent	Computed discount % (sale vs original)
currency	Currency code AliExpress served (e.g. USD, EUR)
rating	Average star rating, 0–5
reviewsCount	Number of reviews
ordersCount	Orders / units sold
storeName / storeId / storeUrl	Seller store (when present on the card)
imageUrl	Main product image
productUrl	Canonical product page URL
searchQuery	The keyword that produced this result
productId	AliExpress product id
site	The AliExpress domain searched
scrapedAt	ISO-8601 timestamp

When to use this Actor

• Use it to turn an AliExpress keyword (or category page) into a structured product list — for product research, price/discount monitoring, best-seller discovery, niche scouting, and feeding AI agents.
• Use it when you want filtering at the source: sort by best-selling or price, restrict to a price band, free shipping, a minimum rating, or a minimum number of orders.
• Don't use it to scrape a single product's full detail page (specs, SKU variants, full gallery, description) or its reviews — that's the job of the AliExpress All-in-One Scraper (khadinakbar/aliexpress-all-in-one-scraper), which accepts product URLs and includeReviews.

Pricing — Pay-per-event

Event	Price	When it fires
Actor start	$0.00005	Once per run (per GB RAM)
AliExpress product scraped	$0.002	Per product returned in the dataset

Products dropped by your filters (minRating, minOrders, minPrice, maxPrice) are not charged. maxResults is a hard cost ceiling — set it and you know the maximum spend before the run starts (the Actor also logs the cap up front). A typical 100-product run costs about $0.20.

Input

Field	Type	Default	Notes
searchQuery	string	wireless earbuds (prefill)	Keyword to search
startUrls	array	[]	AliExpress search/category URLs (product URLs ignored)
maxResults	integer	100	Cap on products + cost ceiling
sortBy	enum	relevance	relevance, ordersDesc, priceAsc, priceDesc, newest
minPrice / maxPrice	integer	—	Price band, in the site's currency
freeShipping	boolean	false	Free shipping to the ship-to country only
minRating	integer	—	Keep products at this star rating (0–5) or higher
minOrders	integer	—	Keep products with at least this many orders
site	enum	aliexpress.com	Regional domain (US, DE, FR, ES, IT, PT, RU)
shipCountry	string	US	Ship-to country + proxy country
proxyConfiguration	object	residential	Defaults to Apify residential; falls back to datacenter US

Example input

{
  "searchQuery": "mechanical keyboard",
  "maxResults": 50,
  "sortBy": "ordersDesc",
  "minPrice": 20,
  "maxPrice": 80,
  "minRating": 4,
  "minOrders": 100,
  "freeShipping": true,
  "site": "aliexpress.com",
  "shipCountry": "US"
}

Example output record

{
  "recordType": "product",
  "position": 1,
  "productId": "1005006789012345",
  "title": "Mechanical Keyboard 87 Keys Hot-Swappable RGB",
  "price": 34.99,
  "originalPrice": 69.99,
  "discountPercent": 50,
  "currency": "USD",
  "rating": 4.8,
  "reviewsCount": 1203,
  "ordersCount": 5400,
  "storeName": "Keyboard Official Store",
  "storeId": "1101234567",
  "storeUrl": "https://www.aliexpress.com/store/1101234567",
  "imageUrl": "https://ae01.alicdn.com/kf/Sxxxxxxxx.jpg",
  "productUrl": "https://www.aliexpress.com/item/1005006789012345.html",
  "searchQuery": "mechanical keyboard",
  "site": "aliexpress.com",
  "scrapedAt": "2026-06-19T08:00:00.000Z"
}

How it works

The Actor opens the AliExpress search results page (/w/wholesale-<keyword>.html) with your sort and filter parameters, then reads the products from the page's embedded SSR JSON (the same data AliExpress uses to render the grid), falling back to DOM parsing if the JSON shape shifts. It auto-paginates through result pages until maxResults is reached. Rating, orders, and price filters are re-checked on the parsed values so a filtered result is never billed.

It uses a real Chromium browser with rotating fingerprints and a session pool, and prefers residential proxies (strongly recommended — AliExpress blocks datacenter IPs). If residential isn't available on your account, it gracefully falls back to Apify datacenter (US).

Use with AI agents (MCP)

This Actor is MCP-ready. Connect it through the Apify MCP server and an agent can call it with a single keyword and get back a structured product list to reason over — ideal for shopping assistants, price comparison, and product-research agents. Input descriptions and the flat output schema are written for LLM consumption.

Tips

• For best-selling products, set sortBy: "ordersDesc" and minOrders to filter out untested listings.
• For regional pricing, set both site and shipCountry to the same market.
• To bulk-scrape several searches, run the Actor multiple times (one keyword each) or pass several search/category URLs in startUrls.

Reliability

• Soft-fail on bad input — missing keyword/URLs ends the run with a clear message, not a crash.
• Honest-fail on anti-bot exhaustion — if every request is blocked and nothing is collected, the run reports the block instead of silently succeeding empty.
• Cost-cap visibility — the maximum spend is logged before any charge fires, and a triple-guard counter never charges past your maxResults.
• Graceful degradation — partial pages still produce results; per-field gaps are flagged in _warnings, never thrown.

Limitations

• This Actor scrapes search/category result cards only. For a single product's full specs, SKU variants, gallery, description, and reviews, use the AliExpress All-in-One Scraper.
• storeName / storeId may be null on some search cards — AliExpress omits store data from certain result layouts (it's present on the product page). This is an upstream limitation, not a bug.
• currency reflects what AliExpress actually served; with residential proxies the IP geo can occasionally differ from the requested shipCountry.

Legal

This Actor collects only publicly available AliExpress search-results data. You are responsible for using the data in compliance with AliExpress's Terms of Service, applicable laws, and data-protection regulations (including the GDPR where relevant). Do not use it to collect personal data without a lawful basis. This Actor is provided for legitimate market-research, price-monitoring, and product-discovery use cases.