# AliExpress Products Scraper for Prices & Suppliers (`fetch_cat/aliexpress-products-scraper`) Actor Scrape AliExpress search and category pages for product prices, sales signals, ratings, shipping details, images, seller names, and product URLs. - **URL**: https://apify.com/fetch\_cat/aliexpress-products-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.30 / 1,000 product saveds 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Products Scraper Scrape AliExpress search and category pages for product prices, ratings, sales signals, shipping details, and seller links. Use it to monitor marketplace products, compare dropshipping opportunities, research competitor prices, or build product intelligence pipelines from public AliExpress listings. ### What does AliExpress Products Scraper do? AliExpress Products Scraper extracts structured product rows from public AliExpress listing pages. It can scrape by: - πŸ”Ž Search query, such as `laptop`, `phone case`, or `led strip` - πŸ”— AliExpress search URLs - πŸ—‚οΈ AliExpress category or listing URLs that expose product cards - πŸ“Š Small checks for a few products or larger exports for market research For each product, the actor saves pricing, rating, sales text, shipping text, seller information when available, image URL, product URL, and scrape timestamp. ### Who is it for? This actor is useful for ecommerce and marketplace teams that need product data from AliExpress. Typical users include: - πŸ›’ Dropshipping sellers validating product ideas - πŸ“¦ Ecommerce operators comparing supplier prices - πŸ“ˆ Price-monitoring teams tracking product movements - πŸ” Marketplace researchers analyzing demand signals - πŸ§ͺ Product analysts checking ratings, discounts, and order text - πŸ€– Automation teams feeding product data into internal tools If you need repeatable AliExpress listing data without manually copying product cards, this scraper gives you a clean dataset ready for export. ### Why use this actor? AliExpress pages are designed for browsing, not analysis. Product cards contain useful information, but it is difficult to compare hundreds of listings manually. This actor helps you: - Save product cards as structured JSON, CSV, Excel, or API output - Compare prices and original prices across products - Track rating and sales text signals - Capture product and image URLs for downstream enrichment - Monitor search result ordering over time - Integrate AliExpress product discovery into automated workflows ### What data can you extract? The dataset contains one row per product listing. | Field | Description | | --- | --- | | `query` | Search query used for the run, when provided | | `position` | Product position in the extracted result order | | `title` | Product title shown in the listing | | `productUrl` | AliExpress product detail URL | | `imageUrl` | Main product image URL | | `price` | Current visible listing price when available | | `originalPrice` | Original or crossed-out price when available | | `currency` | Currency code detected from the product card | | `discount` | Discount percentage when AliExpress exposes it | | `rating` | Star rating when available | | `reviewCount` | Review count when available | | `ordersSold` | Sales/order text such as β€œ1,000+ sold” | | `shippingPrice` | Shipping text, often free-shipping text when shown | | `shipsFrom` | Origin country/region when exposed in listing data | | `sellerName` | Seller/store name when available | | `sellerUrl` | Store URL when available | | `isSponsored` | Whether the listing appears to be sponsored/promoted | | `productId` | AliExpress product identifier | | `sourceUrl` | Listing URL that produced the row | | `scrapedAt` | ISO timestamp of extraction | ### How much does it cost to scrape AliExpress products? This actor uses pay-per-event pricing. - A small one-time start event is charged when a run begins. - A product event is charged for each saved product row. - Final pricing can vary by Apify plan tier and current platform pricing. For the first build, the target price is designed around approximately $0.50 per 1,000 products before tier discounts. Always check the live actor pricing panel on Apify before running large jobs. ### How to use AliExpress Products Scraper 1. Open the actor on Apify. 2. Enter a search query, for example `laptop`. 3. Set the maximum number of products. 4. Optionally choose a ship-to country, currency, sorting mode, or price range. 5. Click **Start**. 6. Download the dataset as JSON, CSV, Excel, XML, RSS, or HTML. ### Input options #### Search query Use `query` when you want the actor to build an AliExpress search URL for you. Example: ```json { "query": "phone case", "maxItems": 50 } ```` #### Start URLs Use `startUrls` when you already have AliExpress listing URLs. Example: ```json { "startUrls": [ { "url": "https://www.aliexpress.com/w/wholesale-led-strip.html?SearchText=led%20strip" } ], "maxItems": 100 } ``` #### Maximum products Use `maxItems` to control the number of product rows saved. Start small while testing. Increase the limit after confirming the results match your workflow. #### Locale and filters Optional controls include: - `shipToCountry` β€” two-letter destination country code - `currency` β€” preferred currency code - `sort` β€” best match, most orders, price low-to-high, or price high-to-low - `minPrice` β€” minimum price filter - `maxPrice` β€” maximum price filter ### Output example ```json { "query": "laptop", "position": 1, "title": "15.6 inch laptop...", "productUrl": "https://www.aliexpress.com/item/1005000000000000.html", "imageUrl": "https://ae-pic-a1.aliexpress-media.com/example.jpg", "price": 299.99, "originalPrice": 499.99, "currency": "USD", "discount": 40, "rating": 4.8, "reviewCount": 120, "ordersSold": "1,000+ sold", "shippingPrice": "Free shipping", "shipsFrom": "US", "sellerName": "Example Store", "sellerUrl": "https://www.aliexpress.com/store/123456", "isSponsored": false, "productId": "1005000000000000", "sourceUrl": "https://www.aliexpress.com/w/wholesale-laptop.html?SearchText=laptop", "scrapedAt": "2026-06-18T00:00:00.000Z" } ``` ### Tips for better results - Use specific search terms instead of very broad terms. - Start with 25–100 products to validate the output. - Use `orders_desc` sorting when researching products with visible sales demand. - Use price filters to remove products outside your target range. - Keep a consistent query and locale if you want to compare runs over time. - Use start URLs when you need exact AliExpress category pages. ### Common ecommerce workflows #### Product discovery Run a search for a product niche and sort by order volume. Export products with price, discount, rating, and sales text to compare opportunities. #### Price monitoring Schedule the actor daily or weekly with the same query and maximum item count. Compare product IDs and prices across runs. #### Supplier shortlisting Use product URLs, seller names, and seller URLs to create a shortlist of stores for manual review. #### Catalog enrichment Feed product URLs, images, and prices into internal catalog tools or spreadsheets. ### Integrations You can connect the dataset to: - Google Sheets via Apify integrations - Make or Zapier automation scenarios - Webhooks that trigger after each run - BI dashboards that ingest CSV or JSON - Internal pricing databases - LLM workflows that summarize product trends ### API usage You can start the actor from code using the Apify API. #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/aliexpress-products-scraper').call({ query: 'laptop', maxItems: 50, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('fetch_cat/aliexpress-products-scraper').call({ 'query': 'laptop', 'maxItems': 50, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~aliexpress-products-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"query":"laptop","maxItems":50}' ``` ### MCP usage Use this actor through the Apify MCP server when you want Claude or another MCP-compatible assistant to run AliExpress product research. MCP URL: ```text https://mcp.apify.com/?tools=fetch_cat/aliexpress-products-scraper ``` Claude Code example: ```bash claude mcp add apify-aliexpress-products https://mcp.apify.com/?tools=fetch_cat/aliexpress-products-scraper ``` Claude Desktop JSON config example: ```json { "mcpServers": { "apify-aliexpress-products": { "url": "https://mcp.apify.com/?tools=fetch_cat/aliexpress-products-scraper" } } } ``` Example prompts: - β€œFind 25 AliExpress listings for LED strip lights and summarize pricing.” - β€œScrape AliExpress laptop products sorted by orders and identify high-rating products.” - β€œCompare phone case listings under $5 and list the best candidates.” ### Proxy and reliability notes AliExpress can vary page content by region, language, and traffic conditions. The actor supports Apify proxy configuration. Datacenter proxy is the recommended first choice for cost control. Use residential proxy only if your target page is consistently blocked. If a run returns fewer products than expected, try: - A more specific query - A lower `maxItems` value - A start URL copied directly from AliExpress - A different ship-to country or currency setting - A proxy configuration appropriate for your target market ### Scheduling Use Apify schedules to run the actor automatically. Common schedules: - Daily price checks for the same query - Weekly product discovery by niche - Monthly category snapshots - Hourly monitoring for a small list of high-value searches ### Webhooks Add an Apify webhook to send results to your application after each run. Useful webhook patterns: - Notify a price-monitoring service when a run succeeds - Send dataset URLs to a Slack channel - Trigger a Make scenario for spreadsheet updates - Start a downstream enrichment actor after products are collected ### Data quality notes AliExpress listing pages may not expose every field for every product. Some rows may have missing review counts, seller URLs, shipping origins, or shipping prices. The actor keeps those fields as `null` when AliExpress does not expose them on the listing card. ### FAQ and troubleshooting #### Why did I get zero products? The query may have no results, the URL may not be a supported public listing page, or AliExpress may have returned an unusual page variant. Try a common query such as `laptop` with a small `maxItems` value. #### Why is the currency different from my input? AliExpress may localize listing data based on region, cookies, availability, or page variant. The actor reports the currency found in the product card. #### Why are seller fields sometimes empty? AliExpress does not expose seller details in every listing card. Product URLs and product IDs are still saved so you can inspect or enrich those products later. ### Limits The first version focuses on public search and category listing pages. It does not log in, open buyer accounts, add items to cart, or scrape private account data. It does not guarantee availability of product-detail-only fields that are not shown in listing results. ### Legality and ethical use This actor extracts publicly visible product listing information. Use it responsibly and follow applicable laws, AliExpress terms, and privacy rules in your jurisdiction. Do not use scraped data for spam, fraud, abusive automation, or any activity that violates platform rules. ### Related scrapers Other actors by `fetch_cat` that may fit ecommerce or search workflows: - https://apify.com/fetch\_cat/google-news-scraper - https://apify.com/fetch\_cat/google-trending-searches-scraper - https://apify.com/fetch\_cat/bing-search-results-scraper ### Support If the output no longer matches AliExpress listing pages, open an issue with: - The run ID - The input you used - A sample URL or query - What field looks wrong or missing This helps reproduce and fix site-change issues quickly. ### Changelog Initial version: - Query and start URL scraping - Product pricing fields - Ratings and sales text - Image and product URLs - Seller and shipping fields when available # Actor input Schema ## `query` (type: `string`): AliExpress keyword to search, for example laptop, phone case, or led strip. ## `startUrls` (type: `array`): Optional AliExpress search or category URLs. If provided, these are scraped instead of building a URL from the search query. ## `maxItems` (type: `integer`): Maximum number of product rows to save. ## `shipToCountry` (type: `string`): Two-letter country code used for AliExpress localization, such as US, GB, DE, or FR. ## `currency` (type: `string`): Preferred three-letter currency code, such as USD, EUR, or GBP. ## `sort` (type: `string`): AliExpress search sorting preference. ## `minPrice` (type: `number`): Optional minimum price filter. ## `maxPrice` (type: `number`): Optional maximum price filter. ## `proxyConfiguration` (type: `object`): Optional proxy settings. Leave disabled for the cheapest run unless AliExpress blocks your target page; add proxy groups only if your account has access. ## Actor input object example ```json { "query": "laptop", "startUrls": [ { "url": "https://www.aliexpress.com/wholesale?SearchText=laptop" } ], "maxItems": 20, "shipToCountry": "US", "currency": "USD", "sort": "relevance", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "laptop", "startUrls": [ { "url": "https://www.aliexpress.com/wholesale?SearchText=laptop" } ], "maxItems": 20, "shipToCountry": "US", "currency": "USD", "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/aliexpress-products-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "laptop", "startUrls": [{ "url": "https://www.aliexpress.com/wholesale?SearchText=laptop" }], "maxItems": 20, "shipToCountry": "US", "currency": "USD", "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/aliexpress-products-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 '{ "query": "laptop", "startUrls": [ { "url": "https://www.aliexpress.com/wholesale?SearchText=laptop" } ], "maxItems": 20, "shipToCountry": "US", "currency": "USD", "proxyConfiguration": { "useApifyProxy": false } }' | apify call fetch_cat/aliexpress-products-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/aliexpress-products-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AliExpress Products Scraper for Prices & Suppliers", "description": "Scrape AliExpress search and category pages for product prices, sales signals, ratings, shipping details, images, seller names, and product URLs.", "version": "0.1", "x-build-id": "sKkxNRlaMfqlHHODX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~aliexpress-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-aliexpress-products-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fetch_cat~aliexpress-products-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-aliexpress-products-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fetch_cat~aliexpress-products-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-aliexpress-products-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Search query", "type": "string", "description": "AliExpress keyword to search, for example laptop, phone case, or led strip." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional AliExpress search or category URLs. If provided, these are scraped instead of building a URL from the search query.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of product rows to save.", "default": 50 }, "shipToCountry": { "title": "Ship-to country", "type": "string", "description": "Two-letter country code used for AliExpress localization, such as US, GB, DE, or FR." }, "currency": { "title": "Currency", "type": "string", "description": "Preferred three-letter currency code, such as USD, EUR, or GBP." }, "sort": { "title": "Sort order", "enum": [ "relevance", "orders_desc", "price_asc", "price_desc" ], "type": "string", "description": "AliExpress search sorting preference.", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Optional minimum price filter." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Optional maximum price filter." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Leave disabled for the cheapest run unless AliExpress blocks your target page; add proxy groups only if your account has access." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```