# AliExpress Search Scraper — Prices, Orders (No API Key) (`jamhimself/aliexpress-search-scraper`) Actor

Scrape AliExpress search results with no API key or login. Get title, sale + original price, discount %, rating, orders/sold count, URL, and image as JSON. Pay per result.

- **URL**: https://apify.com/jamhimself/aliexpress-search-scraper.md
- **Developed by:** [Jaime Martinez](https://apify.com/jamhimself) (community)
- **Categories:** E-commerce, Agents, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 product 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 — No API Key, No Login

Scrape AliExpress search results into clean, structured JSON — **no API key, no login, no browser setup**. Enter any keyword (like `bluetooth headphones` or `phone case`) and get one row per product: **title, sale price, original price, discount %, star rating, and orders/sold count**, plus currency, product URL, and image. AliExpress has no open product-search API and rate-limits datacenter IPs, so this Actor is built for **bulk** extraction — price tracking, competitor and market research, and dropshipping product research — and you **pay per result** delivered.

For reliability at scale it runs on **US residential proxies** with per-session **cookie warm-up**, automatic **session rotation** on blocks, and browser-like TLS/header fingerprinting via `got-scraping`.

### ⚡ Quick start

Paste this into the Actor's **Input** (JSON view) and hit **Start**:

```json
{
  "searchQuery": "laptop",
  "maxResults": 40
}
```

Each result row looks like:

```json
{
  "id": "3256805994642318",
  "title": "Windows 11 Laptop 15.6 Inch 16GB RAM 512GB SSD Intel N95",
  "price": 245.63,
  "originalPrice": 491.26,
  "discountPct": 50,
  "currency": "USD",
  "rating": 4.8,
  "orders": 1536,
  "url": "https://www.aliexpress.com/item/3256805994642318.html"
}
```

(truncated — the full field list, including `ordersText`, `choice`, and `image`, is in the table below)

Or run it from the API:

```
POST https://api.apify.com/v2/acts/jamhimself~aliexpress-search-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN
```

### What you get

One row per product:

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | AliExpress product ID |
| `title` | string | Product display title |
| `price` | number | Current sale price (numeric) |
| `originalPrice` | number | Pre-discount / list price |
| `discountPct` | number | Percent off (e.g. `92`) |
| `currency` | string | Currency code (e.g. `USD`) |
| `rating` | number | Average star rating |
| `orders` | number | Units sold, parsed to a number |
| `ordersText` | string | Raw sold text, e.g. `"469 sold"` |
| `choice` | boolean | Whether it's an AliExpress Choice item |
| `url` | string | Product page URL |
| `image` | string | Product image URL |

### Use cases

- **Price & discount monitoring** — track sale price, original price, and discount % on any keyword over time to catch drops and promos.
- **Dropshipping & product research** — surface trending, high-order, well-rated products with real demand signals (`orders`) before you list them.
- **Competitor & niche analysis** — map assortment, price bands, and rating distributions across a search term to size a niche.
- **Sourcing & resale arbitrage** — pull AliExpress supplier prices and sold counts to compute resale margins for eBay/Amazon and validate demand before buying.
- **Market research datasets** — build structured price/rating/orders datasets across many queries for trend and pricing analysis.
- **LLM / RAG product feeds** — hand agents clean, structured product rows for sourcing, comparison, and recommendation tasks.

### Input

| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `searchQuery` | string | yes | `bluetooth headphones` | Keyword to search AliExpress for |
| `maxResults` | integer | no | `60` | Max products to return (1–1000) |
| `proxyConfiguration` | object | no | US residential | Proxy settings — US residential recommended |

To override the proxy, pass a `proxyConfiguration` object, e.g. `{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }` (the default).

### Pricing

Pay per result delivered. No subscription — you're charged only for the product rows returned.

If the data helps your workflow, a quick review is genuinely appreciated and helps other buyers find the Actor.

### Notes

- Keep the default **US Apify Proxy (residential)** for reliable results at scale.
- AliExpress changes its page structure periodically; this Actor is actively maintained.

# Actor input Schema

## `searchQuery` (type: `string`):

What to search AliExpress for, e.g. "bluetooth headphones" or "phone case".

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

Maximum number of products to return.

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

AliExpress rate-limits datacenter IPs; US RESIDENTIAL proxies are recommended.

## Actor input object example

```json
{
  "searchQuery": "bluetooth headphones",
  "maxResults": 60,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

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

One row per product: title, sale price, original price, discount, rating, orders, and URL.

# 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 = {
    "searchQuery": "bluetooth headphones",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("jamhimself/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 = {
    "searchQuery": "bluetooth headphones",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

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

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/ACaURQpFeaLn2LP0D/builds/TfbU3MRlVHMSvhbne/openapi.json
