# AliExpress Search Scraper: Prices, Ratings & Sales (`tablewise/aliexpress-search-scraper`) Actor

Scrape AliExpress search results for any keyword: price, original price, discount, rating, units sold, free shipping, Choice and sponsored flags. Choose currency, ship-to country, language and sort order. Export to JSON, CSV or Excel, or use the API. No login.

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

## Pricing

from $5.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

### What is AliExpress Search Scraper?

AliExpress Search Scraper turns any AliExpress search into a spreadsheet:
price, original price, discount, rating, units sold, free shipping, Choice and
sponsored flags. Pick the currency, ship-to country and sort order. No
AliExpress account or API key needed.

### What you can do with it

- Find winning products for dropshipping: search a niche sorted by orders and
  compare units sold, rating and price in one table.
- Track prices and discounts for a list of keywords every day on a schedule.
- Research a market before sourcing: price ranges and best sellers by
  keyword, in your currency.
- Feed product data to an AI agent through Apify's MCP server.

### Example output

Two real rows from a test run (image list shortened here):

```json
[
  {
    "search_query": "usb c cable",
    "page": 1,
    "position": 2,
    "product_id": "1005013092454380",
    "title": "For PD 35W Fast Quick Charger USB Type C For iPhone 15 14 13 12 11 Pro Max Mini Plus XR XS Charging Data Cable Accessories",
    "url": "https://www.aliexpress.com/item/1005013092454380.html",
    "price": 0.33,
    "original_price": 4.78,
    "discount_percent": 93,
    "currency": "USD",
    "rating": 4.9,
    "sold_count": 50000,
    "sold_text": "50,000+ sold",
    "free_shipping": false,
    "is_choice": false,
    "new_shopper_deal": false,
    "is_sponsored": false,
    "bundle_deal": "Dollar Express",
    "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S44533c20a8614092bc17c156f9251bc2T.jpg",
    "images": [
      "https://ae-pic-a1.aliexpress-media.com/kf/S44533c20a8614092bc17c156f9251bc2T.jpg",
      "https://ae-pic-a1.aliexpress-media.com/kf/S6742b42a9cde4b0592f6fb6d060d573bd.jpg",
      "..."
    ]
  },
  {
    "search_query": "women dress",
    "page": 1,
    "position": 4,
    "product_id": "1005011839924744",
    "title": "Women's Dress Knit Women's Fashion Knit Dress",
    "url": "https://www.aliexpress.com/item/1005011839924744.html",
    "price": 12.81,
    "original_price": 48.5,
    "discount_percent": 73,
    "currency": "USD",
    "rating": 4.6,
    "sold_count": 58,
    "sold_text": "58 sold",
    "free_shipping": false,
    "is_choice": false,
    "new_shopper_deal": false,
    "is_sponsored": true,
    "bundle_deal": null,
    "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S526663978285432eaee50444b9a30da6l.jpg",
    "images": [
      "https://ae-pic-a1.aliexpress-media.com/kf/S526663978285432eaee50444b9a30da6l.jpg",
      "https://ae-pic-a1.aliexpress-media.com/kf/S2dd943e43a2a4089bfb8f4e57481eec4I.jpg",
      "..."
    ]
  }
]
```

| Field | What it is |
| --- | --- |
| `search_query`, `page`, `position` | Which search, results page and position the product came from |
| `product_id` | AliExpress product id (the same in every country) |
| `title` | Product title, in the language you chose |
| `url` | Product page |
| `price` | Price shown in search results, in `currency` |
| `original_price` | Price before discount, when AliExpress shows one |
| `discount_percent` | Discount as shown by AliExpress |
| `rating` | Star rating (0–5), when shown in search results |
| `sold_count` / `sold_text` | Units sold as a number (a lower bound: "5,000+" becomes 5000) and the original text |
| `free_shipping` | Free shipping to the chosen country |
| `is_choice` | Product is part of AliExpress Choice |
| `new_shopper_deal` | The price includes a welcome deal for new shoppers |
| `is_sponsored` | Sponsored (ad) result |
| `bundle_deal` | Name of the bundle deal, if any (for example "Dollar Express") |
| `image_url`, `images` | Main image and gallery |

### What it costs

| Event | Price |
| --- | --- |
| Actor start | USD 0.0005 per run |
| Product | USD 0.005 per product |

**Example:** 1,000 products = USD 5.00, plus USD 0.0005 per run.

You only pay for products that come back with a title and a price. Duplicates
across pages, products without a price, blocked pages and failed requests are
not charged. Use **Maximum products** to cap the spend.

#### How many products can I get with the free plan?

Apify's free plan includes USD 5 of credit every month. Used only for
this Actor, that is about 995 products: for example, 5 runs of 199 products
\= 5 × (0.0005 + 199 × 0.005) = USD 4.98.

### How to use it

1. Type your searches into **Search terms**, one per line.
2. Choose **Sort by**, **Currency**, **Ship-to country** and **Language** if
   you need something other than best match, USD, US and English.
3. Set **Maximum products** and **Maximum pages per search** (60 products per
   page).
4. Click **Start** and download the results as JSON, CSV or Excel.

You can also run it from the API, on a schedule, or let an AI agent call it
through Apify's MCP server.

#### Input

| Field | Type | Default | What it does |
| --- | --- | --- | --- |
| `busquedas` | array | — | Search terms |
| `maxResultados` | integer | 500 | Stops after this many products across all searches |
| `maxPaginasPorBusqueda` | integer | 10 | Result pages per search (60 products each, up to 60 pages) |
| `orden` | string | `relevance` | `relevance`, `orders`, `price_asc` or `price_desc` |
| `moneda` | string | `USD` | Currency code |
| `paisEnvio` | string | `US` | Ship-to country (two letters) |
| `idioma` | string | `en_US` | Language of titles |
| `incluirAnuncios` | boolean | true | Include sponsored results |
| `incluirSinPrecio` | boolean | false | Include bundle-deal products that show no price |
| `esperaEntrePeticiones` | integer | 2 | Seconds between result pages |
| `proxyConfiguration` | object | `{"useApifyProxy": true}` | Apify Proxy settings |

### Limits and known issues

- It reads the **search results pages**, not each product page. You get what
  the results show: no product description, variants, seller details or
  reviews text.
- **Rating and units sold are not always shown.** AliExpress sometimes serves
  a simpler results layout without them; in our tests, the share of products
  with units sold went from 0% to 94% of a search, depending on the request. Those fields
  are then empty.
- **Prices are the ones a new, logged-out visitor sees.** They can include
  welcome deals for new shoppers; those products are marked with
  `new_shopper_deal`.
- Some products in search results are bundle deals without a price. How many
  depends on the search: in our tests, from 0% to about 45% of a search
  ("phone case" was the highest), and between 0% and 19% of all the products
  of a run. They are skipped and not charged, unless you turn on **Include
  products without a price**. They don't count toward **Maximum products**:
  the Actor keeps reading result pages, up to **Maximum pages per search**.
- AliExpress shows at most 60 result pages per search, and the total it
  declares changes from one request to the next.
- If AliExpress asks for a captcha, that page is skipped and not charged. The
  Actor does not solve captchas.
- Data comes from public search results. No personal data is collected.

### FAQ

#### Why are rating and units sold empty for some products?

AliExpress sometimes serves a simpler results layout without them. The Actor
delivers what the page shows and leaves those fields empty; see **Limits and
known issues**.

#### Can I get prices in my currency and for my country?

Yes. Set **Currency** (for example EUR) and **Ship-to country** (for example
DE). Prices and free shipping follow what AliExpress shows for that
combination.

#### Do I need an AliExpress account?

No. It reads the search results that any logged-out visitor sees.

#### Is it legal to scrape AliExpress?

This Actor only reads pages that anyone can open without logging in, and it
does not collect personal data. Whether scraping is allowed depends on your
country and on how you use the data, and AliExpress's terms of use may
restrict automated access. If you are not sure, ask a lawyer.

#### Can I run it from the API or from Python?

Yes: with the Apify API or the official Apify clients for Python and
JavaScript. This call runs the Actor and returns the rows when it finishes
(it waits up to 5 minutes; for longer runs, start the run and read its
dataset when it ends):

```bash
curl -X POST "https://api.apify.com/v2/acts/tablewise~aliexpress-search-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"busquedas": ["phone case"], "maxResultados": 100}'
```

#### Can I schedule it or send the results to other tools?

Yes. You can run it on a schedule, export each run as JSON, CSV or Excel, get
a webhook when it finishes, and connect it to Make, Zapier, n8n, Google
Drive, Slack and other tools through Apify integrations.

#### Can AI agents use it?

Yes. AI agents can find and run it through Apify's MCP server
(`https://mcp.apify.com`). Every output field has a description, so an agent
knows what each value means.

### Support

Found a problem? Open an issue on the Actor's **Issues** tab with the run ID
and we'll look into it.

### More Actors from the same developer

- [Amazon Best Sellers Scraper](https://apify.com/tablewise/amazon-bestsellers-scraper): the top 100 of any Amazon.com Best Sellers or Hot New Releases list.
- [Amazon Product Details Scraper](https://apify.com/tablewise/amazon-product-details-scraper): price, Best Sellers Rank, specs and images for any list of ASINs.
- [Google Trends Scraper](https://apify.com/tablewise/google-trends-scraper): interest over time, interest by region and related queries for any keyword.
- [Semrush Domain Metrics Scraper](https://apify.com/tablewise/semrush-domain-metrics-scraper): Authority Score, backlinks, referring domains and traffic for any list of domains.
- [YouTube Transcript & Subtitles Scraper](https://apify.com/tablewise/youtube-transcript-scraper): the transcript of any YouTube video, Short or channel as text or SRT, with the video details.
- [Website Email & Contact Scraper](https://apify.com/tablewise/website-email-contact-scraper): emails, phones and social profiles from any list of websites.
- [LinkedIn Company Scraper](https://apify.com/tablewise/linkedin-company-scraper): size, industry, employees, website and offices of any LinkedIn company page.
- [LinkedIn Jobs Scraper](https://apify.com/tablewise/linkedin-jobs-scraper): LinkedIn job postings with full description, salary, seniority and applicants, without login.
- [Company Jobs Scraper: Workday, Greenhouse, Lever & Ashby](https://apify.com/tablewise/workday-greenhouse-lever-jobs-scraper): every open job from company careers sites on those four platforms.
- [Google Hotels Scraper](https://apify.com/tablewise/google-hotels-scraper): hotel prices for your dates, ratings and prices by booking site.
- [Tennis Results & Odds Scraper](https://apify.com/tablewise/tennis-results-scraper): ATP, WTA, Challenger and ITF results and fixtures with set scores and betting odds.

# Actor input Schema

## `busquedas` (type: `array`):

One search per line, as you would type it on AliExpress (for example: phone case, usb c cable).

## `maxResultados` (type: `integer`):

Stops after this many products across all searches, so you never pay for more than this.

## `maxPaginasPorBusqueda` (type: `integer`):

Each page has up to 60 products. AliExpress shows at most 60 pages.

## `orden` (type: `string`):

Same options as on the AliExpress results page.

## `moneda` (type: `string`):

Currency code for prices, for example USD, EUR, GBP, BRL, MXN.

## `paisEnvio` (type: `string`):

Two-letter country code. Prices, shipping and availability depend on it.

## `idioma` (type: `string`):

Language of product titles, for example en_US, es_ES, pt_BR, fr_FR.

## `incluirAnuncios` (type: `boolean`):

Sponsored results are marked with is_sponsored. Turn off to get only organic results.

## `incluirSinPrecio` (type: `boolean`):

Some bundle-deal products show no price in search results. Off by default: those are skipped and not charged.

## `esperaEntrePeticiones` (type: `integer`):

Pause between result pages.

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

Apify Proxy is recommended for this site.

## Actor input object example

```json
{
  "busquedas": [
    "phone case"
  ],
  "maxResultados": 100,
  "maxPaginasPorBusqueda": 10,
  "orden": "relevance",
  "moneda": "USD",
  "paisEnvio": "US",
  "idioma": "en_US",
  "incluirAnuncios": true,
  "incluirSinPrecio": false,
  "esperaEntrePeticiones": 2,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per product from the AliExpress search results: price, original price, rating, units sold and flags.

# 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 = {
    "busquedas": [
        "phone case"
    ],
    "maxResultados": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tablewise/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 = {
    "busquedas": ["phone case"],
    "maxResultados": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

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

```

## MCP server setup

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