# AliExpress Product Scraper (`omkar-cloud/aliexpress-product-scraper`) Actor

Get real-time AliExpress product details from a product URL or ID — pricing, SKU variants with per-SKU stock and prices, images, specifications, shipping options, and store info. 60+ ship-to countries with local currency.

- **URL**: https://apify.com/omkar-cloud/aliexpress-product-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**: No ratings yet

## Pricing

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

⚡ Get Complete AliExpress Product Details in the next 5 Minutes! ⚡

I am AliExpress Product Scraper, created to help you turn any AliExpress product URL or ID into complete, real-time product data — pricing, every SKU variant with its own stock and price, images, specifications, shipping options, store details, and many more. 🚀

### ⚡ Benefits

- Get per-SKU variant data — every color/size/bundle option with its own price, stock level, and availability — so you list the right variants in your dropshipping store. (Great for Dropshippers)

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

- Check live stock levels, shipping options with delivery estimates, and per-buyer purchase limits before you commit to a supplier. (Great for Inventory & Sourcing)

- Vet sellers with store data: positive review rate, follower count, store opening date, and Top Rated status. (Great for Supplier Due Diligence)

Ready to scrape AliExpress product details? Let's get started! 💼🌍

### 🤔 FAQs

#### ❓ How to scrape AliExpress product details?

1. Click on Try for free.
2. Paste your product URLs or product IDs (e.g. `https://www.aliexpress.us/item/3256810554614749.html` or just `3256810554614749`).
3. Optionally, pick a ship-to country.
4. Click on Run.
5. When AliExpress Product Scraper has finished, preview or download your data from the Dataset tab.

#### ❓ Can I use both product URLs and product IDs?

Yes! Mix them freely in the same run. Both the `1005...` (aliexpress.com) and `3256...` (aliexpress.us) ID forms are accepted for any country — conversion is automatic. Product IDs are extracted from full URLs for you, and duplicates are skipped so you never pay twice for the same product.

#### ❓ What Data Points Are Scraped?

Each product includes:

- Product ID, title, and product URL
- Full image gallery and video (when available)
- Pricing (sale price, original price, discount percent, currency)
- Every SKU variant with its own label, attributes, availability, stock, per-buyer limit, and pricing
- SKU properties (e.g. Color, Ships From) with all selectable values
- Rating, reviews count, orders count, and wishlist count
- Live stock and max-per-buyer limits
- Coupons (e.g. "$2.00 off on $18.00")
- Specifications (material, brand name, origin, and more)
- Shipping options with cost, free-shipping flag, ship-from location, delivery estimates, and tracking availability
- Store details (name, link, country, opened date, Top Rated status, positive review rate, followers)
- Category ID and path
- Product description links

#### ❓ How much does it cost?

Pricing is pay-per-result: **1,000 products ≈ $5**. You only pay for products successfully pushed to your dataset — products that don't exist (404) are skipped and never charged.

#### ❓ Can I get prices in 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). Product pricing — including every per-SKU price — is returned in that country's local currency automatically.

#### ❓ How do I scrape many products in one run?

Add as many product URLs or IDs as you like to the **Product URLs or IDs** list — each product is scraped separately and lands as one row in the same dataset. Each row includes the `input` it came from, so you can match rows back to your original list.

#### ❓ What happens if a product doesn't exist?

If a product has been removed or the URL is wrong, the run logs it, skips it, and moves on to the next product. You are not charged for it.

### Output

```json
{
  "input": "https://www.aliexpress.us/item/3256810554614749.html",
  "id": "3256810554614749",
  "canonical_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.com/item/3256810554614749.html",
  "images": [
    "https://ae-pic-a1.aliexpress-media.com/kf/Sf1ea8500f8bb4e37b31702f533e083a8v.jpg?has_lang=1&ver=1",
    "https://ae-pic-a1.aliexpress-media.com/kf/S3f715f2a467142728261a755015531703.jpg"
  ],
  "video": null,
  "rating": 4.9,
  "reviews_count": 56,
  "orders_count": 474,
  "orders_label": "This seller: 474 sales | Total sales: 474",
  "wishlist_count": 116,
  "stock": 492,
  "max_per_buyer": 1,
  "pricing": {
    "sale_price": 0.99,
    "original_price": 19.06,
    "discount_percent": 95,
    "currency": "USD"
  },
  "coupons": [
    "$2.00 off on $18.00"
  ],
  "category": {
    "id": 100001766,
    "path": "26/200389159/100001766"
  },
  "sku_properties": [
    {
      "id": 14,
      "name": "Color",
      "values": [
        { "id": 29, "name": "15pc", "image": null },
        { "id": 193, "name": "30pcs", "image": null }
      ]
    }
  ],
  "skus": [
    {
      "id": "12000055944024790",
      "label": "30pcs",
      "attributes": "200007763:201336106;14:193#30pcs",
      "is_available": true,
      "stock": 127,
      "max_per_buyer": 1,
      "pricing": {
        "sale_price": 7.12,
        "original_price": 33.94,
        "discount_percent": 79,
        "currency": "USD"
      }
    }
  ],
  "specifications": [
    { "name": "Material", "value": "Plastic" },
    { "name": "Brand Name", "value": "Joyfy" },
    { "name": "Origin", "value": "Mainland China" }
  ],
  "shipping": {
    "ship_to": "US",
    "options": [
      {
        "code": "AE_US_SAVER",
        "name": "AE_US_SAVER",
        "price": null,
        "currency": "USD",
        "is_free": true,
        "ship_from": "United States",
        "min_delivery_days": 3,
        "max_delivery_days": 9,
        "estimated_delivery_min_date": "2026-08-05",
        "estimated_delivery_max_date": "2026-08-11",
        "has_tracking": true,
        "guaranteed_delivery_days": 30,
        "is_selected": true
      }
    ]
  },
  "store": {
    "id": 1105246100,
    "name": "Shop1105233629 Store",
    "link": "https://www.aliexpress.com/store/1105246100",
    "seller_id": 6003897797,
    "country": "China",
    "opened_date": "2025-11-24",
    "is_top_rated": false,
    "is_local_seller": false,
    "positive_rate_percent": 0,
    "positive_reviews_count": 0,
    "reviews_count": 0,
    "followers_count": 61
  },
  "description_link": "https://pdp.aliexpress-media.com/product/description/pc/v2/en_US/desc.htm?productId=1005010740929501&key=Sc524855350e04a9692578c809ba6e7fed.zip&token=75febee38c334256f0cb9ad082f7dc4b&sellerId=6003897797",
  "description_json_link": "https://pdp.aliexpress-media.com/product/description/stdmobile/v2/en_US/desc.json?productId=1005010740929501&key=S2063b2232d7d47a9a4eebbcd104acf1cH.json&token=b93c83bed26c4e1ca58909b115cfe00a&sellerId=6003897797"
}
```

[![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%20Product%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%20Product%20Scraper%20Actor\&body=I%20need%20help%20with%20using%20the%20AliExpress%20Product%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

## `products` (type: `array`):

AliExpress product URLs and/or numeric product IDs. Both the `1005...` (aliexpress.com) and `3256...` (aliexpress.us) ID forms are accepted for any country — conversion is automatic. Each product is scraped separately and pushed as one row to the dataset.

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

Ship-to country. Product pricing (including per-SKU prices) is returned in this country's local currency automatically.

## Actor input object example

```json
{
  "products": [
    "https://www.aliexpress.us/item/3256810554614749.html",
    "https://www.aliexpress.com/item/1005007346330785.html"
  ],
  "country_code": "US"
}
```

# 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 = {
    "products": [
        "https://www.aliexpress.us/item/3256810554614749.html",
        "https://www.aliexpress.com/item/1005007346330785.html"
    ],
    "country_code": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("omkar-cloud/aliexpress-product-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 = {
    "products": [
        "https://www.aliexpress.us/item/3256810554614749.html",
        "https://www.aliexpress.com/item/1005007346330785.html",
    ],
    "country_code": "US",
}

# Run the Actor and wait for it to finish
run = client.actor("omkar-cloud/aliexpress-product-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 '{
  "products": [
    "https://www.aliexpress.us/item/3256810554614749.html",
    "https://www.aliexpress.com/item/1005007346330785.html"
  ],
  "country_code": "US"
}' |
apify call omkar-cloud/aliexpress-product-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/njHrXWr1jitN0s33U/builds/5MCiVHyfoxYOpH49b/openapi.json