AliExpress Scraper

Use this Apify Actor to scrape AliExpress product listings, full product details, customer reviews, and seller data from a keyword or AliExpress URL. It auto-detects whether each input is a search/category page or a product page, then returns one dataset record per listing, product, or review. The returned records can include title, price, originalPrice, discountPercent, rating, ordersCount, storeName, specs, skuVariants, images, reviewText, reviewerCountry, and scrapedAt. This Actor is usable through Apify MCP and the Apify API.

Best fit and connected workflows

This Actor fits workflows that begin with AliExpress discovery and continue into product enrichment, review collection, or seller analysis.

Common workflow paths include:

• keyword-based AliExpress catalog research
• product-page enrichment after a discovery pass
• customer review capture for a selected product set
• seller and store data collection for sourcing analysis
• structured AliExpress output for spreadsheets, databases, and AI agents

For a connected workflow, start with AliExpress Product Search Scraper to discover AliExpress records, then pass the verified public product URLs or IDs into this Actor for richer product, seller, and review data.

One practical scenario

Maya, a sourcing analyst, starts with the keyword mechanical keyboard and sets maxResults to match her research scope. The Actor returns listing records with title, price, discountPercent, rating, ordersCount, storeName, productUrl, and imageUrl. Maya then opens the most relevant products, checks the returned specs, skuVariants, shipsFrom, and seller fields, and uses those details to shortlist items for a follow-up review capture run. Her next action is to feed the chosen product URLs back into the Actor with detailedItems and includeReviews enabled.

Input

Field	Type	Purpose
searchQuery	string	Free-text keyword to search AliExpress products, such as wireless earbuds. The Actor opens the AliExpress search results page and collects product listing cards.
startUrls	array	AliExpress search/category URLs and product URLs. The Actor auto-detects each URL type.
maxResults	integer	Maximum number of dataset records across listings and products. Reviews are counted separately under maxReviews.
detailedItems	boolean	Visits each product page to attempt full detail extraction such as specifications, SKU variants, image gallery, and seller details.
includeReviews	boolean	Collects customer reviews for each scraped product and emits them as separate review records.
maxReviews	integer	Maximum number of customer reviews per product when review collection is enabled.
site	string	AliExpress regional domain such as aliexpress.com or a country-specific domain.
shipCountry	string	Two-letter ship-to country code used for shipping context and proxy country selection.
proxyConfiguration	object	Proxy settings. Residential proxies are the default and are aligned with the ship-to country.

Focused input example

{
  "searchQuery": "mechanical keyboard",
  "maxResults": 25,
  "detailedItems": true,
  "includeReviews": true,
  "maxReviews": 10,
  "site": "aliexpress.com",
  "shipCountry": "US"
}

Output

Each dataset record uses the same core schema and is labeled by recordType.

Field	Type	Description
recordType	string	Record kind: listing, product, or review.
productId	string	AliExpress product identifier used to group related records.
title	string	Product title captured from AliExpress.
productUrl	string	Canonical AliExpress product URL for the record.
imageUrl	string	Primary image URL for the item.
price	number	Current displayed price.
originalPrice	number	Original price shown before discount, when available.
discountPercent	number	Discount percentage derived from the displayed pricing.
currency	string	Currency code shown in the returned record.
rating	number	Average star rating on a listing or product record.
reviewsCount	integer	Number of reviews shown for the product.
ordersCount	integer	Orders count shown for the product.
storeName	string	Seller store name.
storeId	string	Seller store identifier.
storeUrl	string	Seller store URL.
shipsFrom	string	Ship-from location returned by the product page.
specs	object	Product specifications from detailed product extraction.
skuVariants	array	SKU and variant options from detailed product extraction.
images	array	Product image URLs from the detail page or listing.
description	string	Product description returned by the Actor.
categoryPath	string	Category path returned for the product.
reviewRating	number	Review star rating on review records.
reviewText	string	Review text on review records.
reviewerName	string	Reviewer name on review records.
reviewerCountry	string	Reviewer country on review records.
reviewDate	string	Review date on review records.
reviewSku	string	SKU referenced by the review.
reviewImages	array	Review image URLs.
site	string	AliExpress domain used for the scrape.
scrapedAt	string	ISO 8601 timestamp for the record.
_warnings	array	Per-record notes returned by the Actor.

Illustrative output record

{
  "recordType": "product",
  "productId": "1005006789012345",
  "title": "Mechanical Keyboard",
  "productUrl": "https://www.aliexpress.com/item/1005006789012345.html",
  "imageUrl": "https://example.com/image.jpg",
  "price": 49.99,
  "originalPrice": 69.99,
  "discountPercent": 28,
  "currency": "USD",
  "rating": 4.8,
  "reviewsCount": 1524,
  "ordersCount": 3812,
  "storeName": "Example Store",
  "storeId": "123456",
  "storeUrl": "https://www.aliexpress.com/store/123456",
  "shipsFrom": "CN",
  "specs": {
    "Switch Type": "Blue",
    "Layout": "68 keys"
  },
  "skuVariants": [
    {
      "name": "Color",
      "values": ["Black", "White"]
    }
  ],
  "images": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg"
  ],
  "description": "Mechanical keyboard product description.",
  "categoryPath": "Computers & Office > Keyboards",
  "site": "aliexpress.com",
  "scrapedAt": "2026-07-27T00:00:00.000Z"
}

How it works

The Actor runs a Chromium browser through Apify residential proxies pinned to your shipCountry. It reads AliExpress embedded server-side JSON when available and falls back to rendered DOM parsing when needed. Heavy page resources such as images, fonts, and CSS are skipped for speed. It uses a session pool with realistic fingerprints and retires sessions as needed. When detailed product data is requested, it visits product pages to attempt enrichment with specifications, SKU variants, image gallery, description, and seller details. Customer reviews are emitted as separate dataset records.

Pricing

This Actor uses Pay per event pricing plus Apify platform usage. The live Pricing tab shows the current event prices and platform usage details, so use it as the source of truth before larger runs.

Event-based billing in this Actor includes:

• one Actor start event, scaled by RAM
• one result event for each search listing card or customer review returned
• one detailed-result event for each product enriched with full detail

For example, a run that returns one hundred listing cards and no other records is billed as one hundred result events, plus the Actor start event. A run with product enrichment and review collection adds the corresponding detailed-result and result events for the records returned.

Use with AI agents (MCP)

This Actor is available through Apify MCP as a structured AliExpress scraping tool. The exact Actor identity is khadinakbar/aliexpress-all-in-one-scraper.

Tool description: scrape AliExpress listings, product details, reviews, and seller data from search keywords or AliExpress URLs, with automatic detection of search and product pages.

Fetch AliExpress product data for mechanical keyboard. Return up to 15 records, include product details and reviews for the selected product URLs, and summarize the fields present in the dataset response.

Output interpretation: the dataset contains flat records with recordType values of listing, product, and review. Product records are the place to read specs, skuVariants, images, description, and seller fields. Review records contain reviewRating, reviewText, reviewerCountry, reviewDate, reviewSku, and reviewImages.

Provenance: each record includes productId and scrapedAt, which support traceability for downstream workflows.

Scope, pagination, and cost guidance: control dataset size with maxResults, and review volume with maxReviews. The Actor stops after the configured record cap is reached, which gives agent workflows a predictable upper bound. Listing cards, product details, and reviews are billed as separate events, so keep maxResults focused and enable detailedItems or includeReviews only when those fields are needed. Check the live Pricing tab for the current event rules.

Apify API example

import { ApifyClient } from 'apify-client';

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

const input = {
  searchQuery: 'mechanical keyboard',
  maxResults: 10,
  detailedItems: true,
  includeReviews: true,
  maxReviews: 3,
  site: 'aliexpress.com',
  shipCountry: 'US',
};

const run = await client.actor('khadinakbar/aliexpress-all-in-one-scraper').call(input);
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 scraped AliExpress records from the default dataset.

Best results and outcome guidance

Use searchQuery for discovery runs and startUrls for a specific product or search page. Choose detailedItems when you need specs, SKU variants, images, or seller data. Choose includeReviews when product sentiment or review images are part of the workflow. Keep site and shipCountry aligned with the market you want to inspect, because both influence the returned language, currency, and shipping context. For broad catalog work, start with a smaller maxResults value and expand it when the first pass looks relevant.

Design note

I found that the live dataset contract requires recordType, productId, and scrapedAt on every record, which makes provenance and record grouping straightforward in downstream workflows.

FAQ

When should I use searchQuery instead of startUrls?

Use searchQuery when you want the Actor to open AliExpress search results for a keyword. Use startUrls when you already have a product URL or a search/category URL and want the Actor to auto-detect the page type.

How do I get product details instead of listing cards?

Enable detailedItems. That tells the Actor to visit product pages and attempt extraction of specs, skuVariants, images, description, and seller details.

How do I collect reviews for a product?

Enable includeReviews and set maxReviews to the number of reviews per product you want collected. Review records are returned as separate dataset items.

Which AliExpress domain should I choose?

Use aliexpress.com for the global English experience unless you need a region-specific domain. The site input controls the regional AliExpress domain used during the scrape.

How should I route a workflow from discovery to enrichment?

Start with AliExpress Product Search Scraper for discovery, then pass the verified product URLs into this Actor for detail extraction and review collection.

Related Actors

• AliExpress Product Search Scraper - use it for discovery-first workflows that feed product URLs into this Actor for enrichment.

Responsible use

Use this Actor for publicly available AliExpress data and in accordance with applicable laws and AliExpress terms. Review the target site's terms, respect rate and volume choices, and choose inputs that fit your research or automation workflow.