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

Search AliExpress in real time and get products with prices, discounts, ratings, and order counts. Sort and filter by price range, free shipping, savings deals, 4★+, and Choice. 60+ ship-to countries with local currency.

- **URL**: https://apify.com/omkar-cloud/aliexpress-search-scraper.md
- **Developed by:** [Chetan Jain](https://apify.com/omkar-cloud) (community)
- **Categories:** E-commerce, Automation, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $2.00 / 1,000 results

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/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

![AliExpress Search Scraper Featured Image](https://raw.githubusercontent.com/omkarcloud/aliexpress-scraper/master/aliexpress-search-scraper-featured-image.png)

## AliExpress Search Scraper

⚡ Get AliExpress Search Results in the next 5 Minutes! ⚡

I am AliExpress Search Scraper, created to help you collect real-time AliExpress product search results, including titles, prices, discounts, ratings, order counts, images, and many more. 🚀

### ⚡ Benefits

- Find winning products for your dropshipping store by sorting search results by most orders and filtering to 4★+ rated products. (Great for Dropshippers)

- Track prices, discounts, and savings deals across 60+ ship-to countries — prices come back in each country's local currency automatically. (Great for Price Monitoring)

- Discover trending niches by scanning what sells in any product category, complete with order counts and listing dates. (Great for Niche & Trend Discovery)

- See exactly which products rank for your keywords and how competitors price them. (Great for Competitor Analysis)

Ready to scrape AliExpress search results? Let's get started! 💼🌍

### 🤔 FAQs

#### ❓ How to scrape AliExpress search results?

1. Click on Try for free.
2. Enter your search queries (e.g. `rubber duck`, `raspberry pi`).
3. Optionally, pick a ship-to country, sort order, and filters.
4. Click on Run.
5. When AliExpress Search Scraper has finished, preview or download your data from the Dataset tab.

#### ❓ What Data Points Are Scraped?

Each search result includes:

- Product ID
- Title
- Product URL
- Images (main image + gallery)
- Rating
- Orders count
- Pricing (sale price, original price, discount percent, currency, tax rate, SKU ID)
- Promotional tags (e.g. "Top selling on AliExpress")
- Store name
- Category IDs
- Listed date
- Hot Sale and AliExpress Choice flags

#### ❓ How much does it cost?

Pricing is pay-per-result: **1,000 search results ≈ $2**. You only pay for the products pushed to your dataset — use the **Max Results per Query** input to cap your spend. And you're never billed twice for the same product: if it ranks under several of your keywords, it's pushed only once.

#### ❓ Can I get results for my country and currency?

Yes! Set the **Ship-to Country** input to any of the 60+ supported countries (US, UK, DE, FR, ES, IT, CA, MX, BR, JP, KR, IN, AU, and many more). Results are localized to that country and **prices are returned in its local currency automatically**.

#### ❓ How do filters and sorting work?

You can sort results by:

- Best Match (default)
- Most Orders
- Price: Low to High
- Price: High to Low

And filter them by:

- Minimum / Maximum price (in your selected country's currency)
- Free shipping only
- Savings deals only (discount promotions)
- 4 stars and up only
- AliExpress Choice products only

#### ❓ How do I search multiple keywords in one run?

Add as many queries as you like to the **Search Queries** list — each query is searched separately, and all results land in the same dataset. Each row includes the `query` it came from, so you can tell them apart. Products that rank for more than one of your queries are pushed and billed **only once**.

### Output

```json
{
  "query": "rubber duck",
  "id": "3256810554614749",
  "title": "Joyfy Rubber Ducks Random Assortment Mini Rubber Duckie Toys for Kids Bath Shower Toys Birthday Gifts Summer Beach Pool Activity",
  "link": "https://www.aliexpress.us/item/3256810554614749.html",
  "image": "https://ae-pic-a1.aliexpress-media.com/kf/Sf1ea8500f8bb4e37b31702f533e083a8v.jpg",
  "images": [
    "https://ae-pic-a1.aliexpress-media.com/kf/Sf1ea8500f8bb4e37b31702f533e083a8v.jpg",
    "https://ae-pic-a1.aliexpress-media.com/kf/S3f715f2a467142728261a755015531703.jpg"
  ],
  "rating": 4.9,
  "orders_count": 474,
  "is_hot_sale": false,
  "is_choice": false,
  "pricing": {
    "sale_price": 0.99,
    "original_price": 19.06,
    "discount_percent": 94,
    "currency": "USD",
    "tax_rate": 0,
    "sku_id": "12000055944024788"
  },
  "tags": [
    "New shoppers save $18.07",
    "Extra 2% off with coins"
  ],
  "store_name": "Shop1105233629 Store",
  "category_ids": [
    26,
    200389159,
    100001766
  ],
  "listed_date": "2026-01-07"
}
```

[![Message Us on WhatsApp](https://raw.githubusercontent.com/omkarcloud/assets/master/images/whatsapp-us.png)](https://api.whatsapp.com/send?phone=918178804274\&text=I%20need%20help%20with%20using%20the%20AliExpress%20Search%20Scraper%20Actor.)

[![Ask Us on Email](https://raw.githubusercontent.com/omkarcloud/assets/master/images/ask-on-email.png)](mailto:happy.to.help@omkar.cloud?subject=Help%20with%20AliExpress%20Search%20Scraper%20Actor\&body=I%20need%20help%20with%20using%20the%20AliExpress%20Search%20Scraper%20Actor.)

You are important to us — just message us and we will solve your problem ✅ within 1 working day. 🩷 Pinky Promise 🤙!

# Actor input Schema

## `queries` (type: `array`):

Keywords or phrases to search for on AliExpress. Each query is searched separately and all results are pushed to the same dataset.

## `maxResults` (type: `integer`):

Maximum number of products to scrape per search query. Each page of AliExpress search returns up to 60 products. Use this to control your pay-per-result cost (1,000 results ≈ $2).

## `country_code` (type: `string`):

Ship-to country. Results are localized to this country and prices are returned in its local currency automatically.

## `sort_by` (type: `string`):

Sort order for search results.

## `min_price` (type: `integer`):

Minimum price, in the selected country's currency (USD when Ship-to Country is omitted or US). Example: 10

## `max_price` (type: `integer`):

Maximum price, in the selected country's currency (USD when Ship-to Country is omitted or US). Example: 100

## `free_shipping` (type: `boolean`):

Only return products with free shipping.

## `savings` (type: `boolean`):

Only return products with savings deals (discount promotions).

## `four_star_and_up` (type: `boolean`):

Only return products rated 4 stars and above.

## `choice` (type: `boolean`):

Only return AliExpress Choice products.

## Actor input object example

```json
{
  "queries": [
    "rubber duck",
    "raspberry pi"
  ],
  "maxResults": 60,
  "country_code": "US",
  "sort_by": "best_match",
  "free_shipping": false,
  "savings": false,
  "four_star_and_up": false,
  "choice": false
}
```

# 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 = {
    "queries": [
        "rubber duck",
        "raspberry pi"
    ],
    "maxResults": 60,
    "country_code": "US",
    "sort_by": "best_match"
};

// Run the Actor and wait for it to finish
const run = await client.actor("omkar-cloud/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 = {
    "queries": [
        "rubber duck",
        "raspberry pi",
    ],
    "maxResults": 60,
    "country_code": "US",
    "sort_by": "best_match",
}

# Run the Actor and wait for it to finish
run = client.actor("omkar-cloud/aliexpress-search-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 '{
  "queries": [
    "rubber duck",
    "raspberry pi"
  ],
  "maxResults": 60,
  "country_code": "US",
  "sort_by": "best_match"
}' |
apify call omkar-cloud/aliexpress-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=omkar-cloud/aliexpress-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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