# AliExpress Product Scraper | Price, Variants & Shipping (`genial_candlestand/aliexpress-product-details-scraper`) Actor

Get AliExpress product details by URL or ID: price, original price, all SKU variants with price and stock, shipping options with cost and delivery days, store positive rate, rating, sold count, specs and images. 17 ship-to countries, 13 currencies, 12 languages. No login.

- **URL**: https://apify.com/genial_candlestand/aliexpress-product-details-scraper.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 2 monthly users, 95.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.91 / 1,000 product details

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Product Scraper | Price, Variants & Shipping

![AliExpress Product Scraper | Price, Variants & Shipping](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-details-banner-d816e081.png)

Get full AliExpress product details from product URLs or IDs: the current price, original price and discount, every SKU variant with its own price and stock, and the shipping options with cost and delivery days to the country you choose. Each row also has the store's positive rate, feedback score and open date, plus rating, reviews count, sold count, specifications and images.

### What does AliExpress Product Scraper do?

You give it AliExpress product page links (any host: www, de., fr., m., aliexpress.us) or product IDs. It returns one dataset row per product with prices, all variants, shipping to your ship-to country, store metrics and product facts. You pick the ship-to country (17 options), the currency (13 options, or the country's own) and the language (12 options). It is built for dropshippers checking supplier prices and stock, price-monitoring tools, product researchers comparing suppliers and AI agents that get a product link and need structured data. It does not search AliExpress: you bring the products.

### How to scrape AliExpress product details

![How AliExpress Product Scraper works: Reads the product id from each URL or id; aliexpress.us ids become global; Calls the signed AliExpress API that the product page itself uses; On a captcha answer,](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-details-how-b82e0713.png)

1. Open the actor in Apify Console.
2. Paste product URLs into **Product URLs**, or product IDs into **Product IDs** (or both).
3. Choose the **Ship-to country**, **Currency** and **Language**. The defaults are United States, the country's currency (USD) and English.
4. Optionally set **Max products** to stop after a number of saved products.
5. Leave the residential proxy on and click **Start**.
6. Download the results as JSON, CSV or Excel, or use the dataset views **Overview**, **Variants** and **Shipping**.

### How much does it cost to scrape AliExpress?

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Actor start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |
| Product details | $2.25 per 1,000 | $2.137 per 1,000 | $2.025 per 1,000 | $1.912 per 1,000 |

A test run with the API example input below returned 3 rows in 112 s.

One paid event is one saved product (`product`), with all its variants and shipping options in the same row. Products that are not found, or that are not sold to your ship-to country, are not charged. There is no separate charge for proxy traffic or compute. A run also has the Apify start fee of $0.00005 per GB of memory; at the default 256 MB that is about $0.0000125 per run.

| Scenario | Product events | Cost on the Free plan |
|---|---|---|
| Try the prefilled input (3 products) | 3 | ≈ $0.007 |
| Check 100 supplier products once | 100 | ≈ $0.23 |
| A catalogue of 1,000 products | 1,000 | ≈ $2.25 |
| 200 products every day for 30 days | 6,000 | ≈ $13.50 |

### Input

![AliExpress Product Scraper input example: Product URLs, Product IDs, Ship-to country, Currency, Language](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-details-input-16799cca.png)

- **Product URLs** (`startUrls`) — AliExpress product page URLs. The id is read from `/item/<id>.html`, `/i/<id>.html` or a `productId=` query; a bare id here works too. Short share links (`a.aliexpress.com/_…`), search, store and category URLs are skipped with a warning.
- **Product IDs** (`productIds`) — digits only, 10–17 digits: global ids (`1005…`), aliexpress.us ids (`3256…`, converted to the global id) or older short ids. Other values are skipped with a warning.
- **Ship-to country** (`country`) — US (default), GB, DE, FR, ES, IT, NL, PL, BR, MX, CL, CA, AU, KR, JP, SA, IL.
- **Currency** (`currency`) — `auto` (default, the country's currency: EUR for DE/FR/ES/IT/NL, GBP for GB, PLN for PL and so on) or one of USD, EUR, GBP, BRL, MXN, CLP, CAD, AUD, PLN, KRW, JPY, SAR, ILS. Any currency works with any country.
- **Language** (`language`) — en (default), de, fr, es, it, nl, pl, pt, ko, ja, ar, he. Any language works with any country.
- **Max products** (`maxItems`) — stop after this many saved products; empty means all given products.
- **Proxy** (`proxyConfiguration`) — Apify residential proxy by default.

No single field is required, but give at least one URL or ID; otherwise the run stops with an input error. The same product given twice (as a URL and an id, or in global and aliexpress.us form) is fetched and charged once.

```json
{
  "productIds": ["1005009689732172", "1005010439419248", "3256812845041193"],
  "country": "DE",
  "language": "de"
}
```

This example returns German titles, prices in EUR and shipping to Germany.

### What data can you extract from AliExpress?

![AliExpress Product Scraper output example: Image, Title, Price, Currency, Original price, Rating](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-details-output-303e1a8b.png)

| Field | What it holds |
|---|---|
| `url`, `productId`, `query` | Product page on aliexpress.com, global product id, and the input entry it came from |
| `title`, `imageUrl`, `images` | Title in the chosen language, main image, all gallery images |
| `price`, `originalPrice`, `discountPercent` | Guest price of the default variant, price before discount, discount in percent |
| `currency`, `priceText` | ISO currency code and the price as AliExpress shows it |
| `rating`, `reviewsCount` | Average rating 1–5 and number of ratings |
| `soldCount`, `soldText` | Sales as a number (a lower bound, "5,000+" → 5000) and the text as shown |
| `inStock`, `totalStock` | Whether it can be bought and total stock over all variants |
| `variantsCount`, `variants` | Number of SKUs and each SKU: `skuId`, `options`, `price`, `originalPrice`, `stock`, `available` |
| `shipTo`, `shipFrom`, `shippingOptions` | Ship-to country, ship-from country, and each option: `company`, `cost` (0 = free), `costText`, `deliveryDaysMin`, `deliveryDaysMax`, `shipFrom` |
| `storeName`, `storeId`, `sellerId`, `storeUrl`, `storeCountry` | The store and where it is registered |
| `storeOpenedAt`, `storePositiveRate`, `storeFeedbackScore`, `isTopRatedSeller` | Store open date (YYYY-MM-DD), positive feedback in percent, feedback score, top-rated flag |
| `categoryId`, `categoryPath` | Leaf category id and category ids from root to leaf |
| `specifications` | Name/value pairs, e.g. "Main Material: Polyurethane" |
| `descriptionUrl` | Link to the seller's description page (not fetched) |
| `language`, `scrapedAt` | Language of the texts and extraction time |

A real row (arrays shortened to their first entries):

```json
{
  "url": "https://www.aliexpress.com/item/1005009689732172.html",
  "productId": "1005009689732172",
  "query": "https://www.aliexpress.com/item/1005009689732172.html",
  "title": "Luxury Matte Armor Phone Case For iPhone 16 15 14 11 12 13 Pro Max Plus Magsafe Magnetic Bumper Back Cases Cover Funda Coque",
  "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/S45ad77d00b7143f3b160e3ede7ce554dU.jpg",
  "images": ["https://ae-pic-a1.aliexpress-media.com/kf/S45ad77d00b7143f3b160e3ede7ce554dU.jpg"],
  "price": 1.09,
  "originalPrice": 6.49,
  "currency": "USD",
  "priceText": "$1.09",
  "discountPercent": 83,
  "rating": 4.7,
  "reviewsCount": 1107,
  "soldCount": 5000,
  "soldText": "5,000+ sold",
  "inStock": true,
  "totalStock": 24524,
  "storeName": "Wonderful Find Store",
  "storeId": "1103336373",
  "sellerId": "2676577055",
  "storeUrl": "https://www.aliexpress.com/store/1103336373",
  "storeCountry": "China",
  "storeOpenedAt": "2023-11-28",
  "storePositiveRate": 95.8,
  "storeFeedbackScore": 4792,
  "isTopRatedSeller": false,
  "categoryId": "202229005",
  "categoryPath": "202192403/202228401/202229005",
  "specifications": [{ "name": "Main Material", "value": "Polyurethane" }],
  "variantsCount": 160,
  "variants": [{ "skuId": "12000049866450782", "options": "Color: Red; Compatibility by Model: iPhone 16 Pro", "price": 1.09, "originalPrice": 6.49, "stock": 283, "available": true }],
  "shipTo": "US",
  "shipFrom": "China",
  "shippingOptions": [{ "company": "AliExpress Selection Standard", "cost": 1.99, "costText": "$1.99", "deliveryDaysMin": 7, "deliveryDaysMax": 12, "shipFrom": "China" }],
  "descriptionUrl": "https://pdp.aliexpress-media.com/product/description/pc/v2/en_US/desc.htm?productId=1005009689732172&key=…",
  "language": "en",
  "scrapedAt": "2026-11-08T18:05:23.207Z"
}
```

### Use cases

- **Supplier price and stock monitoring** — schedule your supplier products daily for the US in USD and track `price`, `originalPrice`, `inStock`, `totalStock` and the price and stock of each variant.
- **EU market check** — see what German buyers see: ship-to DE, prices in EUR, titles in German and delivery days.
- **Cross-market comparison** — run the same product for BR, MX and CA (one saved task per country) with English texts and each local currency to compare price and shipping cost.
- **Supplier vetting** — compare stores by positive rate, feedback score, open date, top-rated flag and sold count before you pick one.
- **AI agent enrichment** — pass a single aliexpress.com or aliexpress.us link and get the product, store and rating as structured data.

### Limitations

- **No search or discovery.** The actor needs product URLs or IDs. Short share links (`a.aliexpress.com/_…`) are not resolved and are skipped.
- **Not included:** review texts, questions and answers, and the seller's HTML description (only its `descriptionUrl`).
- **Guest prices.** Prices are what a guest without an account sees. Many products show a new-user deal price limited to one piece per shopper; `originalPrice` and the per-variant prices are given next to it.
- **Fields that can be empty:** `originalPrice` and `discountPercent` are usually null for EU countries (DE, FR, ES, IT, NL, PL); `rating` is null for products without ratings (`reviewsCount` is then 0); some shipping options have no company or cost (null).
- **Captchas.** AliExpress answers a large share of requests with a captcha, even on residential IPs. The actor never solves captchas: it switches to a new IP, up to 30 times per product. This makes runs slower — SPEC measurements estimate about 5–8 minutes per 100 products.
- Products not sold to the chosen ship-to country return no row (and no charge).

### Tips and troubleshooting

- **Keep the residential proxy.** With the datacenter group or no proxy, AliExpress flags most IPs with a captcha and the run can stop as blocked.
- **A product is missing from the results?** Check the log: it says `product not found`, `not available for <country>` or `failed after 30 captcha IPs`. The last case is listed in the final message — rerun those ids.
- **Language and currency are independent of the country.** For example, ship-to DE with English titles, or ship-to US with prices in EUR.
- **aliexpress.us links work** with any ship-to country; the output `productId` and `url` use the global id.
- **Monitoring:** save one task per country and schedule it; each run returns the current price, stock and shipping.
- **Run stopped early?** If 3 products in a row exhaust their captcha IPs, the actor stops, keeps the rows already saved and lists the skipped ids.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/aliexpress-product-details-scraper").call(run_input={
    "startUrls": [{"url": "https://www.aliexpress.com/item/1005009689732172.html"}],
    "productIds": ["1005007823486360", "3256811844384040"],
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/aliexpress-product-details-scraper').call({
    "startUrls": [{"url": "https://www.aliexpress.com/item/1005009689732172.html"}],
    "productIds": ["1005007823486360", "3256811844384040"],
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~aliexpress-product-details-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":[{"url":"https://www.aliexpress.com/item/1005009689732172.html"}],"productIds":["1005007823486360","3256811844384040"]}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/aliexpress-product-details-scraper"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/aliexpress-product-details-scraper"}}}`. Then ask, for example:

- "Get price, variants and stock of AliExpress product 1005009689732172 shipped to the US"
- "What does AliExpress item 1005009689732172 cost with shipping to Germany, in EUR and German?"
- "Compare store positive rate and sold count of AliExpress products 1005007823486360 and 3256811844384040"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Is it legal to scrape AliExpress?**<br>
The actor reads only public product data that any guest sees, without a login, account cookies or captcha solving. The data is about products and stores, not private people. You are responsible for how you use the data and for following the laws and terms that apply to you.

**Do I need an AliExpress account or API key?**<br>
No. The actor works without login, cookies from an account or an API key.

**Can I get prices for another country or currency?**<br>
Yes. Choose one of 17 ship-to countries, one of 13 currencies (or auto for the country's currency) and one of 12 languages; every combination is valid.

**Are products that are not found charged?**<br>
No. Not-found products and products not sold to your ship-to country give no row and no charge.

**Is there a limit of products per run?**<br>
No fixed limit. Use Max products to cap a run.

**How is it different from other AliExpress scrapers?**<br>
Each row has the full variant list with per-variant price, original price and stock, a list of shipping options with company, cost and delivery days, and store metrics (positive rate, feedback score, open date, top-rated flag). It costs $2.25 per 1,000 products on the Free plan, against $2.80 per 1,000 for the most used AliExpress scraper in the Store.

### Also useful

- [eBay Search Scraper](https://apify.com/genial_candlestand/ebay-search-scraper-listings-prices) — compare the same products on eBay: listing prices, shipping, seller feedback and sold count
- [eBay Sold Listings Scraper](https://apify.com/genial_candlestand/ebay-sold-listings-scraper) — check what products actually sell for on eBay: sold prices, dates and shipping
- [Amazon Best Sellers Scraper](https://apify.com/genial_candlestand/amazon-best-sellers-scraper) — find products worth sourcing from Amazon top-seller lists on 12 stores
- [Google Trends Scraper](https://apify.com/genial_candlestand/google-trends-scraper) — validate demand for a product idea: interest over time, regions and related queries
- [Naver Shopping Scraper](https://apify.com/genial_candlestand/naver-shopping-product-search-scraper) — compare product prices in South Korea by keyword on Naver Shopping

# Actor input Schema

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

AliExpress product page links, e.g. https://www.aliexpress.com/item/1005009689732172.html. Any AliExpress host works (www, de., fr., m., aliexpress.us). Short share links (a.aliexpress.com/\_…) and search, store or category pages are skipped with a warning.

## `productIds` (type: `array`):

AliExpress product ids, one per line, 10–17 digits: global ids (1005…), aliexpress.us ids (3256…, converted to the global id) or older short ids. Other values are skipped with a warning.

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

Country the prices, shipping options and availability are shown for. Products not sold to this country are skipped with a warning and not charged.

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

Currency of all prices and shipping costs. Auto uses the ship-to country's currency (EUR for Germany, GBP for the UK, …). Any currency works with any country.

## `language` (type: `string`):

Language of the title, variant names, specifications and sold text. Works with any ship-to country, e.g. English titles for Germany.

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

Stop after this many products are saved. Leave empty to fetch every product you gave.

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

Residential proxy (default) is recommended: AliExpress answers many IPs with a captcha and the actor switches to a fresh IP each time, without solving captchas. Datacenter or no proxy usually gets blocked.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.aliexpress.com/item/1005009689732172.html"
    }
  ],
  "productIds": [
    "1005007823486360",
    "3256811844384040"
  ],
  "country": "US",
  "currency": "auto",
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

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

Dataset with one item per product: price, variants, shipping, store and rating

## `overview` (type: `string`):

Products in the overview table view

# 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 = {
    "startUrls": [
        {
            "url": "https://www.aliexpress.com/item/1005009689732172.html"
        }
    ],
    "productIds": [
        "1005007823486360",
        "3256811844384040"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("genial_candlestand/aliexpress-product-details-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 = {
    "startUrls": [{ "url": "https://www.aliexpress.com/item/1005009689732172.html" }],
    "productIds": [
        "1005007823486360",
        "3256811844384040",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/aliexpress-product-details-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 '{
  "startUrls": [
    {
      "url": "https://www.aliexpress.com/item/1005009689732172.html"
    }
  ],
  "productIds": [
    "1005007823486360",
    "3256811844384040"
  ]
}' |
apify call genial_candlestand/aliexpress-product-details-scraper --silent --output-dataset

```

## MCP server setup

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