# AliExpress Search Scraper (`almond_subcontra/aliexpress-search-scraper`) Actor

Search AliExpress by keyword and get product title, price, original price, rating, orders sold, tags, image and link. Choose the ship-to country and currency. Sort by best match, most orders or price. No browser, so runs are fast and cheap.

- **URL**: https://apify.com/almond_subcontra/aliexpress-search-scraper.md
- **Developed by:** [XD](https://apify.com/almond_subcontra) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 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.

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 Search Scraper

Get product data from **AliExpress** search results: title, price, original price, currency, rating, orders sold, tags, image and link.

Give it search phrases or AliExpress search links, and choose the ship-to country and currency. It returns one row per product. No browser is used, so runs are fast and cheap.

### What it is for

- Finding the best-selling products for a keyword (dropshipping research)
- Tracking prices and discounts on AliExpress
- Comparing prices across countries and currencies
- Building product datasets

### Input

| Field | What it does |
|---|---|
| **Search phrases** | What to search for, one phrase per line. |
| **Sort search phrases by** | Best match, most orders, price low to high or price high to low. Links keep their own order. |
| **Ship-to country** | Two-letter country code, such as US, DE, PL or UK. Default US. Use UK for the United Kingdom. |
| **Currency** | Three-letter currency code, such as USD, EUR, PLN or GBP. Default USD. |
| **AliExpress search links** | Search result links such as `https://www.aliexpress.com/w/wholesale-laptop.html`. Set your filters on the site, then paste the link. The country site in a link is ignored: prices follow Ship-to country and Currency. |
| **Maximum results** | The run stops after this many products in total. Default 100. The limit is for the whole run, not per phrase. Pages of all phrases load side by side, so with several phrases set it high enough for all of them. |
| **Include products without a price** | Off by default. AliExpress shows some products as free gifts for new shoppers, without a price. They are skipped, and not charged, unless you turn this on. |
| **Proxy** | On by default. The standard Apify proxy works. |

```json
{
  "search": ["wireless earbuds"],
  "sort": "orders",
  "country": "DE",
  "currency": "EUR",
  "maxItems": 200
}
```

### Output

```json
{
  "productId": "1005009872822347",
  "title": "CHUWI MiniBook X Touch Screen Tablet Laptop 2-in-1 Intel U300 16GB LPDDR4X 512G SSD 10.51'' 2K FHD Notebook WiFi6 Windows 11 Convenient Office Computer",
  "url": "https://www.aliexpress.com/item/1005009872822347.html",
  "price": 369.51,
  "originalPrice": 950.56,
  "currency": "USD",
  "rating": 4.9,
  "sold": 1000,
  "sponsored": false,
  "tags": ["Fastest delivery in 4 days", "Free shipping", "Numeric Keypad | 512 GB | 4 | Windows 11 | SSD", "$581.05 saved", "New shoppers - $581.05", "Save $581.05", "4 × $92.38 with no interest"],
  "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/S8fb463c1e3f34a5abee01f42af2d98dfa.jpg",
  "position": 1,
  "sourceUrl": "https://www.aliexpress.com/w/wholesale-laptop.html",
  "scrapedAt": "2026-11-17T12:10:04.118Z"
}
```

- `price` is the price shown on the product card for a new visitor without an account, in `currency`. It can include a new-shopper discount. On full cards the `tags` usually say so (for example "New shoppers save $2.97"); short cards carry no tags. It is `null` only for a product AliExpress shows as a free gift, and those are returned only when **Include products without a price** is on.
- `originalPrice` is the price before the discount, and `null` when AliExpress shows no higher price.
- `sold` is the number of orders AliExpress shows: "1K+ sold" becomes 1000.
- `sponsored` is `true` for products AliExpress shows as ads.
- `tags` are the texts on the product card, such as delivery, shipping and discount notes.
- `position` is the product's place on its page (1 to 60). Skipped and repeated products leave gaps.
- `sourceUrl` is the search page the row came from, so rows of several phrases can be told apart.
- `productId` is AliExpress's worldwide product id; `url` is built from it.

### Price

The current price is on the **Pricing** tab of this page. There is no monthly fee.

Use **Maximum results** to cap a run. When a per-result price applies, you can also set a maximum charge per run in the run options; the scraper stops when it is reached.

### Good to know

- AliExpress shows 60 products per page and at most 60 pages (3,600 products) per search. For more, use more specific phrases or another sort order.
- Prices are what a new visitor without an account sees for the chosen country and currency. They can include a new-shopper discount.
- AliExpress shows some products as free gifts for new shoppers, without a price. This is common in the US for cheap accessories: about half of a "phone case" search. They are skipped unless **Include products without a price** is on.
- Some searches return short product cards. Then `rating`, `sold`, `originalPrice` and `tags` are empty.
- A search with no matches makes AliExpress show recommended products. The scraper returns what AliExpress shows.
- `sold` is the number AliExpress shows, so "1K+" becomes 1000.
- Titles and tags are in English, whatever the country.
- `productId` is the worldwide id. US visitors see it in another form on the site; the link works everywhere.
- A product found by several phrases or pages is returned once per run.
- Country and currency pairs other than US/USD, DE/EUR, PL/PLN and UK/GBP are passed to AliExpress as given. The `currency` of each row shows what came back.
- A run that finds no products at all ends as failed, so an empty result never looks like a success.
- Category, store and product pages are not supported.
- Only public product data is collected. No personal data.
- This Actor is an independent tool. It is not affiliated with, endorsed by or sponsored by AliExpress.

### Something wrong?

Open an issue on the **Issues** tab with the input you used.

# Actor input Schema

## `search` (type: `array`):

What to search for on AliExpress. One phrase per line.

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

Order of the results for search phrases. Links keep their own order.

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

Two-letter country code. Prices and availability are shown for delivery to this country. Tested: US, DE, PL, UK. Use UK for the United Kingdom.

## `currency` (type: `string`):

Three-letter currency code for the prices. Tested: USD, EUR, PLN, GBP.

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

Search result links such as https://www.aliexpress.com/w/wholesale-laptop.html. Set your filters on the site, then paste the link. A file of links is not read. The country site in a link is ignored: prices follow Ship-to country and Currency.

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

The run stops after this many products in total.

## `includeWithoutPrice` (type: `boolean`):

AliExpress shows some products as free gifts for new shoppers, without a price. They are skipped, and not charged, unless you turn this on.

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

Keep a proxy on. The standard Apify proxy works.

## Actor input object example

```json
{
  "search": [
    "wireless earbuds"
  ],
  "sort": "default",
  "country": "US",
  "currency": "USD",
  "maxItems": 100,
  "includeWithoutPrice": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

One row per product: title, price, original price, currency, rating, orders sold, tags, image and link.

# 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 = {
    "search": [
        "wireless earbuds"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("almond_subcontra/aliexpress-search-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 = {
    "search": ["wireless earbuds"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("almond_subcontra/aliexpress-search-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 '{
  "search": [
    "wireless earbuds"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call almond_subcontra/aliexpress-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,almond_subcontra/aliexpress-search-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/kwXXHmbDJBlSkjY5i/builds/htvZofPwoIsaxqhIR/openapi.json
