[$1.00/1k] AliExpress Everything

AliExpress Everything

Collect AliExpress listings, product details, seller data, and public reviews. Start with a search term or a search, category, or product URL. The Actor writes one dataset row per product or review. Use Apify Console to export JSON, CSV, Excel, or XML. You can also run the Actor through the Apify API or on a schedule.

Quick start

1. Enter a search term in searchQuery, or add URLs to startUrls.
2. Set shipCountry and maxResults.
3. Enable detailedItems for specifications and variants. Enable includeReviews for reviews.
4. Run the Actor. Check the run result and the dataset.

{
    "searchQuery": "wireless earbuds",
    "maxResults": 50,
    "shipCountry": "US"
}

For a known product and its reviews:

{
    "startUrls": [{ "url": "https://www.aliexpress.us/item/3256811621288203.html" }],
    "includeReviews": true,
    "maxReviews": 25,
    "shipCountry": "US"
}

Direct product URLs always request details. detailedItems controls whether the Actor opens products found on listing pages.

Input

Field	Function	Default
searchQuery	Search text. Set this or startUrls.	None
startUrls	HTTPS search, category, or product URLs.	[]
maxResults	Maximum unique listing and product rows, from 1 to 5,000.	50
detailedItems	Get details for products found in listings.	false
includeReviews	Get public review text, country, date, variant, and images.	false
maxReviews	Maximum reviews per product, from 1 to 1,000.	20
site	AliExpress regional site. See the input form for the list.	aliexpress.com
shipCountry	Two-letter delivery country.	US
currency	Optional currency override.	Country currency, or USD if no mapping exists
proxyConfiguration	Apify automatic proxy selection or custom proxy settings.	Apify automatic
maxConcurrency	Concurrent requests, from 1 to 5.	1
maxRequestRetries	Retries for a failed request.	2
requestDelaySecs	Delay before each HTTP request.	1
requestTimeoutSecs	Timeout for a network request or browser navigation.	60
maxPages	Maximum listing pages for each source URL.	100

The Actor sends the selected country and currency to AliExpress. Prices can depend on delivery address, stock, tax, sale conditions, and new-customer offers. The output currency comes from the response. The Actor does not convert prices. Conditional free-gift offers can have no standalone price. In that case, price is null, priceNote contains the condition, and the row has a warning. The site field identifies the selected site; AliExpress can redirect to another regional site.

Output

All rows contain recordType, productId, site, shipCountry, scrapedAt, and _warnings.

Listing and product rows contain:

• productUrl, title, price, originalPrice, discountPercent, currency, and priceNote.
• rating, reviewsCount, and ordersCount when the source supplies numeric values.
• imageUrl, images, storeName, storeUrl, and storeId.
• specifications, variants, description, and detailStatus.

Each specification contains name and value. Each variant contains skuId, attributes, price, currency, stock, and available. IDs remain strings. The Actor leaves an unknown scalar field as null and an unavailable list as []. Description text is available only when page data includes it. It does not download separate description documents.

Review rows contain reviewId, reviewRating, reviewText, reviewerCountry, reviewDate, reviewSku, reviewImages, and reviewScope. Ratings use a five-star scale. Dates keep the source format. Names, account IDs, profile images, and profile links are excluded. Review text and product photos are collected only when includeReviews is enabled.

AliExpress can combine reviews for similar items from different sellers. When it gives this notice, reviewScope stores the notice and _warnings includes reviews_may_include_similar_products.

Run result

The OUTPUT key-value record contains outcome, product and review counts, failed request count, partial product count, page count, warnings, and start and finish times.

• SUCCEEDED: requested pages completed without a known data failure.
• EMPTY: AliExpress returned a valid listing response with no products.
• PARTIAL: some data is incomplete, a page limit stopped the search, or a request failed.
• FAILED: no result could be obtained from the failed requests.
• ABORTED: the run was stopped. State was saved before exit.

MIGRATING is a temporary state while Apify moves the run. A request that exhausts its retries causes a failed platform run, even if other requests returned data. A blocked product page with valid listing data returns PARTIAL; it is not presented as a complete product.

Blocked or unavailable pages

AliExpress can return verification pages or remove a product. The Actor retries failed requests. If a product page stays blocked, it can use a previously collected listing, with detailStatus: "blocked" and detail_page_blocked_used_listing_data. If there is no matching listing, it records a failed request. It does not invent a title, price, seller, or variant. No scraper can guarantee access to every product at all times.

Cost and limits

Apify compute, storage, and proxy charges apply. This source does not charge a separate result event or call another paid Actor. Start with a small run. Browser requests cost more than listing and review requests. Keep concurrency at 1 for detail runs with 2 GB of memory. Increase memory before you increase browser concurrency. maxResults limits products; reviews have a separate per-product limit. A run can therefore produce up to maxResults × (1 + maxReviews) rows when reviews are enabled.

Development

Use Node.js 22 or later. The existing Docker image includes Camoufox and Playwright. Put local input in storage/key_value_stores/default/INPUT.json, then use apify run. Use apify run --no-purge to keep existing local storage. For a separate test, set CRAWLEE_STORAGE_DIR to a new folder that contains its own key_value_stores/default/INPUT.json.

Run npm test, npm run build, npm run lint, and apify validate-schema before deployment. Local files do not prove platform behavior. Check a platform run and its dataset after each deployment.

The crawler checks robots.txt and adds a request delay. Use public data within the site's terms and the permissions that apply to your use. This Actor is independent of AliExpress.