# AliExpress Scraper — Products, Prices & Sold Counts (`fabrikit/aliexpress-scraper`) Actor

AliExpress search scraper: products by keyword or search URL with price, original price, discount, sold count, rating, images and ad flag. 15 countries/currencies, sorting and price filters. No login. From US$1.80 per 1,000 products.

- **URL**: https://apify.com/fabrikit/aliexpress-scraper.md
- **Developed by:** [Fabrikit](https://apify.com/fabrikit) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 3 total users, 2 monthly users, 83.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.80 / 1,000 product scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## AliExpress Scraper — Products, Prices & Sold Counts

**AliExpress Scraper extracts product search results from aliexpress.com**: title, current price, original price, discount, units sold, star rating, images and whether the result is sponsored. Search by keyword or paste any AliExpress search/category URL, choose the country you shop from (language and currency follow it), and get clean JSON, CSV or Excel. No AliExpress account, no cookies, no API key.

### What data you get

| Field | Example |
|---|---|
| `productId` | `3256805934076564` |
| `url` | `https://www.aliexpress.com/item/3256805934076564.html` |
| `title` | `1Pcs Silicone Spoon Non-stick Cooking Spoon…` |
| `price` / `originalPrice` / `discountPercent` | `0.33` / `9.54` / `96` |
| `currency` / `priceText` | `USD` / `US $0.33` |
| `soldCount` / `soldText` | `5000` / `5,000+ sold` |
| `rating` | `4.9` |
| `imageUrl`, `images[]` | product images |
| `isAd` | `true` for sponsored cards |
| `promo` | `FREE with any purchase` on new-shopper promo cards (no price shown for those) |
| `listedSince` | `2023-10-12` (when AliExpress shows it) |
| `searchQuery`, `shipTo`, `page`, `position`, `scrapedAt` | context of the result |

Prices, sold counters and titles are exactly what a shopper in the selected country sees on the results page.

### Use cases

- **Product research & dropshipping:** find what sells (sort by most orders, read `soldCount`) and at what price.
- **Price monitoring:** schedule the same searches daily and track price and discount changes per `productId`.
- **Competitor & market analysis:** how many listings, price bands and ratings exist for a niche.
- **Catalog enrichment:** titles and images for product ideas, with the link back to AliExpress.
- **AI agents & automations:** call it from n8n, Make, Zapier or any MCP-compatible AI agent and get structured products back.

### How to use

1. Type one or more **search keywords** (or paste AliExpress search URLs).
2. Set **Max products** (60 per result page; pagination is automatic).
3. Pick the **country** you want to shop from (default US / English / USD).
4. Optional: sort order, price range, skip sponsored products.
5. Run, then download the dataset or read it through the API.

#### Input example

```json
{
  "searchQueries": ["kitchen gadgets", "phone case"],
  "maxItems": 200,
  "country": "US",
  "sort": "orders",
  "skipAds": true
}
```

#### Output example

```json
{
  "productId": "3256805934076564",
  "url": "https://www.aliexpress.com/item/3256805934076564.html",
  "title": "1Pcs Silicone Spoon Non-stick Cooking Spoon Anti-scalding Pot Rice High-temperature-resistant Spoon Durable Kitchen Gadgets",
  "price": 0.33,
  "originalPrice": 9.54,
  "discountPercent": 96,
  "currency": "USD",
  "priceText": "US $0.33",
  "soldCount": 5000,
  "soldText": "5,000+ sold",
  "rating": 4.9,
  "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/S6caba7a160c14740be273385d0ab1924h.jpg",
  "images": ["https://ae-pic-a1.aliexpress-media.com/kf/S6caba7a160c14740be273385d0ab1924h.jpg"],
  "isAd": false,
  "promo": null,
  "listedSince": "2023-10-12",
  "searchQuery": "kitchen gadgets",
  "shipTo": "US",
  "page": 1,
  "position": 2,
  "scrapedAt": "2026-10-21T18:00:00.000Z"
}
```

### Pricing

Pay per result: **US$1.80 per 1,000 products** (US$0.0018 each), plus a tiny Apify start fee per run. Proxy and browser costs are included — you pay only for products saved.

| Products | Price |
|---|---|
| 100 | US$0.18 |
| 1,000 | US$1.80 |
| 10,000 | US$18 |

You can set a maximum cost per run in Apify; the scraper stops cleanly when it is reached and keeps everything saved so far.

### Why this scraper

- **Works where plain HTTP scrapers break:** AliExpress shows an anti-bot slider after the first request from an IP. This actor opens pages in a real Firefox browser over residential IPs in the selected country, and rotates the session when a check appears.
- **Fast and lean:** images, fonts and styles are not downloaded — the product data is read from the page itself.
- **Clean numbers:** prices, discounts, ratings and sold counts are numbers, not strings ("10,000+ sold" → `10000`).
- **15 shopping countries:** US, GB, DE, FR, ES, IT, NL, PL, CA, AU, BR, MX, CL, KR, JP.

### Integrations

Use the Apify API, the JavaScript/Python clients, webhooks, scheduled runs, Google Sheets export, or connect it to **n8n, Make, Zapier** and **AI agents through the Apify MCP server**.

### FAQ

**Is scraping AliExpress legal?** The actor reads publicly visible search results only — no logins, no personal data. You are responsible for how you use the data and for complying with AliExpress terms and the laws that apply to you.

**Do I need a proxy?** No setup needed: Apify residential proxy in the selected country is used by default and included in the price.

**Why are titles in German / prices in EUR?** AliExpress localizes results by country. Choose `US` (or `GB`, `AU`, `CA`) for English.

**Why do some products have no price?** AliExpress mixes "FREE with any purchase" promo cards for new shoppers into results and does not show their price on the results page. They are kept (with title, sold count, rating and image) and marked in `promo`; filter them out with `price != null` if you only need priced products.

**How many products per search?** Up to 60 per page and about 60 pages per search. For more, split into narrower keywords or price ranges.

**Product details (descriptions, variants, shipping)?** Not in this version — it returns the search-result data. Tell us in Issues if you need product pages.

### En español

**Scraper de AliExpress**: busca por palabra clave o pega URLs de búsqueda y obtén título, precio, precio original, descuento, unidades vendidas, valoración, imágenes y si es anuncio. Elige el país desde donde compras (MX, CL, ES, BR… definen idioma y moneda). Sin cuenta ni API key. US$1,80 por 1.000 productos.

### Changelog

- **0.1 (Oct 2026):** first release — keyword and URL search, 15 countries, sorting, price range, ad filter.

# Actor input Schema

## `searchQueries` (type: `array`):

What you would type in the AliExpress search box. One search per line.

## `startUrls` (type: `array`):

Optional. Paste search or category result URLs from aliexpress.com (filters in the URL are kept). Pagination is automatic.

## `maxItems` (type: `integer`):

Total number of products to save across all searches (60 per result page).

## `country` (type: `string`):

Country the search is made from. AliExpress sets language, currency and shipping prices from it (US = English / USD).

## `sort` (type: `string`):

Result order for keyword searches.

## `minPrice` (type: `integer`):

Optional. Only products from this price (in the currency of the selected country).

## `maxPrice` (type: `integer`):

Optional. Only products up to this price.

## `skipAds` (type: `boolean`):

Leave out the sponsored (ad) cards that AliExpress mixes into results.

## `proxyConfiguration` (type: `object`):

Residential proxy in the selected country is used by default; AliExpress blocks datacenter IPs.

## Actor input object example

```json
{
  "searchQueries": [
    "kitchen gadgets"
  ],
  "maxItems": 30,
  "country": "US",
  "sort": "default",
  "skipAds": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `products` (type: `string`):

All products collected during the run

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "kitchen gadgets"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("fabrikit/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["kitchen gadgets"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("fabrikit/aliexpress-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "kitchen gadgets"
  ],
  "maxItems": 30
}' |
apify call fabrikit/aliexpress-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fabrikit/aliexpress-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sAtDeLqtuTwgWAchQ/builds/IBHnmha5jc2HZLZ90/openapi.json