# AliExpress Product Scraper (`scrapers_lat/aliexpress-scraper`) Actor
Scrape AliExpress products by keyword or URL: title, price, original price, discount, currency, rating, orders sold, store name and rating, shipping and choice badges, plus (with details) variants, per-SKU prices, specs and store info. For e-commerce price monitoring and product research.
- **URL**: https://apify.com/scrapers\_lat/aliexpress-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $6.80 / 1,000 products
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
[](https://console.apify.com/actors/IbEobXwlQFNXKkPvP/input)
## AliExpress Product Scraper
> Extract AliExpress products by keyword or URL, with price, discount, rating, order counts, store profile and full variant data from the world's largest cross border marketplace
30+ fields per product
Global coverage
JSON / CSV / Excel output formats
Updated 2026-07-26
### What you get
Each record is one AliExpress product with pricing, popularity and store data, ready for price monitoring, product research, dropshipping sourcing or competitive analysis. Turn on details to also pull the store profile, full specifications and every buyable variant with its own price.
- **imageUrl**: main product thumbnail
- **title**: full product title
- **url**: link to the product page
- **productId**: AliExpress product identifier
- **price**: current sale price as a number
- **priceFormatted**: current price as shown on the site
- **originalPrice**: pre discount price as a number
- **originalPriceFormatted**: pre discount price as shown on the site
- **discountPercent**: discount percentage off the original price
- **currency**: currency code of the prices
- **rating**: average star rating
- **ordersText**: sold volume label, for example "10,000+ sold"
- **orderCount**: numeric order count
- **isChoice**: whether the product carries the AliExpress Choice badge
- **isAd**: whether the listing is a sponsored placement
- **shipFromCountry**: country the item ships from
- **skuId**: identifier of the shown variant
- **tags**: promotional and delivery labels on the card
- **images**: card image gallery
- **storeName\***: seller store name
- **storeId\***: seller store identifier
- **storeUrl\***: link to the seller store
- **storePositiveRate\***: seller positive feedback percentage
- **storeCountry\***: country the seller operates from
- **storeYears\***: how many years the store has been open
- **productRating\***: detailed average rating on the product page
- **reviewCount\***: number of validated reviews
- **salesText\***: seller and total sales summary
- **specifications\***: product attributes such as material, battery life and features
- **variants\***: variant option groups such as color and size
- **variantPrices\***: each buyable variant with its own price, stock and availability
- **imageGallery\***: full high resolution image gallery
- **observedAt**: when this product was last seen by the scraper
*\*These fields only appear when Include Product Details is set to true.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Price and discount monitoring across sellers | E commerce and pricing teams |
| Product sourcing and dropshipping research | Online store owners |
| Catalog and specification collection | Marketplace and comparison sites |
| Demand signals from order counts and ratings | Market researchers |
| Seller and store discovery | Sourcing and procurement teams |
### Frequently Asked Questions
**Which AliExpress marketplace does it cover?**
It covers the global AliExpress catalog and returns prices in US dollars and titles in English by default. Any keyword or category available on AliExpress can be searched.
**How many products can I collect per run?**
Set Max Products to the number you want. Runs paginate through the search results automatically, and free Apify plans are capped per run while paid plans can collect large volumes across many keywords.
**Can I scrape by keyword, by search page URL, or by product URL?**
All three. Provide search keywords, paste AliExpress search or category URLs, or paste direct product URLs, in any combination. Product URLs are fetched individually with full detail data.
**What do I get with Include Product Details turned on?**
Each product is enriched with the seller store profile and rating, the complete specification list, every buyable variant with its own price and stock, and the full image gallery. It is slower but far richer, so leave it off for quick price sweeps.
**What happens when a product has no rating or sold count yet?**
New listings without reviews or sales simply return those fields empty while every other field stays populated. Failed lookups never mix into your data as products.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [1688 Wholesale Scraper](https://apify.com/scrapers_lat/1688-wholesale-scraper): supplier and wholesale product data from 1688
- [Amazon Product Scraper](https://apify.com/scrapers_lat/amazon-product-scraper): Amazon product, price and rating data
- [MercadoLibre Scraper](https://apify.com/scrapers_lat/mercadolibre-scraper): product listings and prices across Latin America
- [Americanas Scraper](https://apify.com/scrapers_lat/americanas-scraper): product and price data from Americanas Brazil
- [Chrome Web Store Scraper](https://apify.com/scrapers_lat/chrome-web-store-scraper): extension listings, ratings and install counts
- [App Store Reviews Scraper](https://apify.com/scrapers_lat/app-store-reviews-scraper): user reviews and ratings from the App Store
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
***
> This actor is an independent tool and has no affiliation with AliExpress. It only accesses data that is publicly available on the platform. Use it in accordance with AliExpress's terms of service.
# Actor input Schema
## `maxProducts` (type: `integer`):
Maximum number of products to collect across all search terms and URLs. Optional.
## `withDetails` (type: `boolean`):
When on, each product is enriched with detail-page fields: store name and rating, full specifications, variant options with per-variant prices, and the complete image gallery. Slower but far richer.
## `searchTerms` (type: `array`):
Keywords to search on AliExpress, for example "wireless earbuds". One search runs per keyword.
## `startUrls` (type: `array`):
AliExpress search-result URLs (e.g. a wholesale/category page) or direct product URLs (/item/{id}.html). Product URLs are fetched individually.
## `sortBy` (type: `string`):
Result ordering for keyword and search-URL runs.
## `minPrice` (type: `integer`):
Only include products at or above this price. Optional.
## `maxPrice` (type: `integer`):
Only include products at or below this price. Optional.
## `shipFromCountry` (type: `string`):
Restrict to products shipping from a specific country. Optional.
## Actor input object example
```json
{
"maxProducts": 10,
"withDetails": true,
"searchTerms": [
"wireless earbuds"
],
"sortBy": "default",
"shipFromCountry": ""
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxProducts": 10,
"searchTerms": [
"wireless earbuds"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/aliexpress-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxProducts": 10,
"searchTerms": ["wireless earbuds"],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/aliexpress-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxProducts": 10,
"searchTerms": [
"wireless earbuds"
]
}' |
apify call scrapers_lat/aliexpress-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/aliexpress-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/acts/IbEobXwlQFNXKkPvP/builds/wfCq7qKLttLlJ3hSc/openapi.json