AliExpress Multi-Region Search, Store & Review Scraper

Collect AliExpress search results, customer reviews, and basic product or store lookups for 19 shopper regions. Prices, currency, and review language follow the region you choose. No AliExpress login, cookies, or manual proxy setup is required.

What this actor does

• Searches AliExpress by keyword and returns product cards (up to 60 per page before gift filtering), with price, original price, discount, rating, sold count, images, selling points, category, and ship-from country
• Supports 19 shopper regions and 42 currencies, with sort, price range, rating, ship-from, free-shipping, Choice, and 4-star filters
• Flags sponsored cards and $0.00 welcome-gift cards so you can keep or drop them
• Collects customer reviews page by page, including original text, translated text, rating, buyer country, photos, variant, shipping method, and follow-up reviews
• Looks up a product by ID or URL for its title, main image, canonical URL, and availability status
• Looks up a store by ID or URL for its store name, canonical store ID, seller ID, and description
• Omits empty fields from every record; dates are ISO when present and image URLs are absolute

Modes and output

Keyword search (mode=search)

One record per product card:

productId, title, productUrl, imageUrl, imageUrls[], salePrice{amount,currencyCode,formatted,discountPercent}, originalPrice{amount,currencyCode,formatted}, discountPercent, currencyCode, rating, ordersText, ordersCount, sellingPoints[], listedAt, productType, itemType, shipFromCountry, categoryId, isChoice, isSponsored, isWelcomeGift, region, sourceUrl, recordType, siteName, scrapedAt.

salePrice.amount is the lowest price shown for the listing on the search card, not a selected variant's price.

Product lookup (mode=byProduct, or an item URL in mode=byUrl)

One record per requested product:

productId, productUrl, canonicalUrl, title, imageUrl, status (ok, not_found, or blocked), region, recordType, siteName, scrapedAt.

With includeReviews enabled, a reviews[] array is attached. This mode is a title/image/existence lookup: AliExpress loads price, rating, variants, specifications, shipping, and seller statistics through a separate anti-bot API that this actor does not promise. Use keyword search for card price and rating.

Store lookup (mode=byStore, or a store URL in mode=byUrl)

One record per requested store:

storeId (canonical), storeNumber, storeName, storeUrl, storeDescription, sellerId, status, region, recordType, siteName, scrapedAt.

AliExpress's store statistics API (positive-feedback rate, opening date, 180-day sales, followers) is not publicly reachable without the same protected API. Those fields are deliberately not advertised.

Reviews (mode=byReviews, a product ID list, or a review URL in mode=byUrl)

One record per review:

productId, productRating, productReviewCount, reviewId, rating (1–5), reviewText, reviewTextTranslated, translationLanguage, reviewerName, reviewerCountry, reviewerHeadUrl, reviewedAt, skuInfo, imageUrls[], helpfulCount, logistics, isFollowUp, followUpText, followUpDate, recordType, siteName, scrapedAt.

Input

Field	Type	Default	Description
mode	string	search	search, byProduct, byStore, byReviews, or byUrl
searchQueries	array	–	Keywords for search; one to 50 queries (the prefill example is ["phone case"])
productIds	array	–	Product IDs or item URLs for byProduct / byReviews
storeIds	array	–	Store IDs or store URLs for byStore
urls	array	–	Any AliExpress search, item, store, or review URLs for byUrl
region	string	US	Shopper country: US, GB, DE, FR, ES, IT, NL, PT, PL, BR, MX, CA, AU, JP, KR, TR, SA, AE, IL, or GLOBAL
currency	string	region default	Optional ISO-4217 override, e.g. USD, EUR, BRL
language	string	en_US	Storefront language and review translation language
sortBy	string	default	default, orders_desc, price_asc, or price_desc
priceMin / priceMax	number	0	Price bounds in the selected currency; 0 disables a bound
ratingMin	number	0	Minimum stars from 0 to 5; unrated items are skipped when set
shipFrom	string	any	Warehouse country code, e.g. CN, US, ES
freeShippingOnly	boolean	false	Only items with free-shipping advertising
choiceOnly	boolean	false	Only AliExpress Choice items
fourStarPlus	boolean	false	Only items rated 4.0 or higher. AliExpress's own 4-star filter can include 3.x cards, so the actor enforces the 4.0 cutoff after the page is fetched
includeSponsored	boolean	true	Include promoted cards, marked isSponsored
includeWelcomeGifts	boolean	false	Include $0.00 new-shopper gift cards, marked isWelcomeGift
maxItems	integer	100	Hard cap on emitted records (1–10,000)
maxPages	integer	3	Pages per query (1–60; 60 cards per page)
includeReviews	boolean	false	Attach reviews to product records
maxReviewsPerProduct	integer	20	Review cap per product (0–200; 0 uses 20)
reviewFilter	string	all	all, withPhotos, or additional
includeProductStats	boolean	true	Add product average rating and review count to review rows

Example: search three regions

{
  "mode": "search",
  "searchQueries": ["phone case", "wireless earbuds"],
  "region": "ES",
  "currency": "EUR",
  "sortBy": "orders_desc",
  "freeShippingOnly": true,
  "maxItems": 200,
  "maxPages": 3
}

Example: collect translated reviews

{
  "mode": "byReviews",
  "productIds": ["1005010155028387", "1005012594256426"],
  "language": "es_ES",
  "maxReviewsPerProduct": 60,
  "reviewFilter": "withPhotos",
  "includeProductStats": true
}

Example: resolve mixed URLs

{
  "mode": "byUrl",
  "urls": [
    "https://www.aliexpress.com/item/1005010155028387.html",
    "https://www.aliexpress.com/store/1101493050",
    "https://www.aliexpress.com/w/wholesale-phone-case.html"
  ]
}

Use cases

• Compare keyword pricing and sales signals across countries and currencies
• Build a review corpus with translated text for sentiment analysis
• Monitor a product line's card prices and discounts on a schedule
• Resolve pasted AliExpress product or store links into structured records
• Feed product-card and review data into spreadsheets, databases, or AI pipelines

Limits

• No full item-detail scraping. AliExpress renders item price/rating/variants/specs/shipping/seller data through a protected client-side API. This actor returns an item's title, image, and canonical URL; it does not promise the rest.
• No store statistics. The store profile API is behind the same protection, so store rating, positive-feedback rate, opening date, and 180-day sales are not returned.
• Search cap. AliExpress serves 60 cards per page and stops at page 60, so one query exposes at most 3,600 raw cards (60 pages x 60). Cross-page dedupe and the default gift filter usually return fewer; a default US page produced roughly 30-45 rows in tests. Split broad searches by price, sort order, or narrower keywords for more coverage.
• Card price is a listing minimum. It is the lowest price across variants shown on the card, not a selected SKU's price.
• Conditional fields. Ratings, discounts, photos, avatars, and follow-ups are only present when the source has them. They are omitted, never filled with a placeholder.
• Review dates in non-English languages. AliExpress localizes review month names (for example ENE, FEV, ABR). The current parser recognizes English month abbreviations, so some reviewedAt values are omitted when language is not en_US even though the source has a date. Use language=en_US when every review needs a date.
• The 4-star filter is enforced by the actor. AliExpress's own 4-star filter can include 3.x cards (3.7-3.9 was observed); when fourStarPlus is on, the actor removes anything below 4.0.
• Review order. The public review endpoint does not support a sort parameter; reviews are returned in AliExpress's default order.
• Welcome gifts. Some US searches show $0.00 gift cards. They are excluded by default; enable includeWelcomeGifts to keep them with the isWelcomeGift flag.

FAQ

Do I need an AliExpress account or cookies? No. The actor reads public search, review, product, and store pages without logging in.

Do I need to configure a proxy? No. AliExpress rate limits are handled automatically; there is nothing to configure.

Why does byProduct not return price, rating, or variants? AliExpress loads those fields through a separate protected API that is not reliably reachable without a browser session. The actor returns the reliable part — title, image, canonical URL, and status — rather than pretending to have the rest. Use keyword search for card price and rating.

Why is there no store rating or follower count? AliExpress serves store statistics from a protected profile API. Only the public store name, canonical ID, seller ID, and description are returned.

Why does the returned currency sometimes differ from what I picked? The actor sets the shopper region and currency, and records the currency AliExpress actually returned. If you need a specific currency, set both region and currency.

How many products can one search return? Up to 60 cards per page and 60 pages per query (3,600 raw cards; fewer after gift filtering and cross-page dedupe). Use narrower keywords or price ranges to partition larger catalogs.

Why are some reviews missing photos or translations? Photos, avatars, and follow-ups are optional on AliExpress. Translation depends on the review language and the selected language; translated text is omitted when the source does not provide it. Review dates are normalized from localized month names (Spanish, Portuguese, French, German, Italian, Russian, and English).

Can I get more than 200 reviews for one product? No in one pass; the review cap is 200 per product. Run multiple products or split the review set.

Is this affiliated with AliExpress? No. This is an independent actor that reads public AliExpress pages and is not operated or endorsed by AliExpress or Alibaba Group.