# AliExpress Scraper - Products Prices and Reviews (`cryptosignals/aliexpress-scraper`) Actor Scrapes AliExpress product listings by keyword or category. Returns title, price, rating, seller info, shipping details, and image URLs. - **URL**: https://apify.com/cryptosignals/aliexpress-scraper.md - **Developed by:** [CryptoSignals Agent](https://apify.com/cryptosignals) (community) - **Categories:** E-commerce, Lead generation, Developer tools - **Stats:** 8 total users, 5 monthly users, 92.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Scraper Scrape AliExpress product listings and detailed product pages at scale. Extract prices, ratings, reviews, seller info, shipping costs, and product variants. No API key needed. Handles anti-bot protection automatically. ### What can you scrape? - **Search results** — Find products by keyword with full pagination - **Product details** — Extract comprehensive data from any product URL - **Prices & discounts** — Current prices, original prices, discount percentages - **Seller data** — Store name, ratings, follower count - **Shipping info** — Shipping costs and estimated delivery times - **Product variants** — Colors, sizes, specifications ### Use cases - **Dropshipping research** — Find profitable products with good margins - **Price monitoring** — Track competitor pricing over time - **Market research** — Analyze product trends and demand - **Supplier evaluation** — Compare seller ratings and reliability ### Input | Field | Description | |-------|-------------| | `action` | `search` for keyword search, `product` for detail pages | | `query` | Search keywords (e.g., "bluetooth headphones") | | `productUrls` | List of AliExpress product URLs | | `maxResults` | Maximum products to return | | `sortBy` | Sort by price, orders, rating | ### Sample output ```json { "title": "Wireless Bluetooth Headphones", "price": 12.99, "originalPrice": 25.99, "discount": "50%", "rating": 4.8, "sales": "5000+ sold", "store": "TechStore Official", "shipping": "Free shipping", "imageUrl": "https://...", "productUrl": "https://aliexpress.com/item/..." } ```` ### Export Download results as JSON, CSV, or Excel. Connect via Apify API, Zapier, Make.com, or Google Sheets. ### 🔒 Bypassing AliExpress Anti-Bot Protection AliExpress employs heavy anti-scraping measures including CAPTCHAs, IP blocks, and JavaScript challenges. Residential proxies are critical for consistent data extraction. **[ThorData Residential Proxies](https://thordata.partnerstack.com/partner/0a0x4nzjr3ky)** offer 200M+ real residential IPs across 195 countries — the most reliable way to scrape AliExpress without getting blocked or seeing CAPTCHA walls. ### Pricing Pay-per-result: $0.005 per product scraped. No minimum spend. # Actor input Schema ## `action` (type: `string`): Type of scraping action: 'search' for keyword search, 'product' for detailed product page scraping ## `query` (type: `string`): Search keywords (required when action is 'search'). Example: 'bluetooth headphones' ## `urls` (type: `array`): List of AliExpress product URLs to scrape (required when action is 'product') ## `maxItems` (type: `integer`): Maximum number of items to return ## `country` (type: `string`): ISO country code for shipping destination. Affects prices and availability. Examples: US, GB, DE, FR ## `currency` (type: `string`): Currency code for displayed prices. Examples: USD, EUR, GBP ## `sort` (type: `string`): Sort order for search results ## `minPrice` (type: `number`): Filter products with price above this value ## `maxPrice` (type: `number`): Filter products with price below this value ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies recommended for best results with AliExpress. ## Actor input object example ```json { "action": "search", "query": "bluetooth headphones", "maxItems": 5, "country": "US", "currency": "USD", "sort": "default", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (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 = { "action": "search", "query": "bluetooth headphones", "maxItems": 5, "country": "US", "currency": "USD", "sort": "default", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("cryptosignals/aliexpress-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 = { "action": "search", "query": "bluetooth headphones", "maxItems": 5, "country": "US", "currency": "USD", "sort": "default", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("cryptosignals/aliexpress-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 '{ "action": "search", "query": "bluetooth headphones", "maxItems": 5, "country": "US", "currency": "USD", "sort": "default", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call cryptosignals/aliexpress-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=cryptosignals/aliexpress-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AliExpress Scraper - Products Prices and Reviews", "description": "Scrapes AliExpress product listings by keyword or category. Returns title, price, rating, seller info, shipping details, and image URLs.", "version": "0.0", "x-build-id": "E2X7ZCHzZbSzwrno7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cryptosignals~aliexpress-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cryptosignals-aliexpress-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/cryptosignals~aliexpress-scraper/runs": { "post": { "operationId": "runs-sync-cryptosignals-aliexpress-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/cryptosignals~aliexpress-scraper/run-sync": { "post": { "operationId": "run-sync-cryptosignals-aliexpress-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", "required": [ "action" ], "properties": { "action": { "title": "Action", "enum": [ "search", "product" ], "type": "string", "description": "Type of scraping action: 'search' for keyword search, 'product' for detailed product page scraping", "default": "search" }, "query": { "title": "Search Query", "type": "string", "description": "Search keywords (required when action is 'search'). Example: 'bluetooth headphones'" }, "urls": { "title": "Product URLs", "type": "array", "description": "List of AliExpress product URLs to scrape (required when action is 'product')", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of items to return", "default": 5 }, "country": { "title": "Ship-to Country", "type": "string", "description": "ISO country code for shipping destination. Affects prices and availability. Examples: US, GB, DE, FR", "default": "US" }, "currency": { "title": "Currency", "type": "string", "description": "Currency code for displayed prices. Examples: USD, EUR, GBP", "default": "USD" }, "sort": { "title": "Sort By", "enum": [ "default", "total_tranpro_desc", "price_asc", "price_desc", "latest" ], "type": "string", "description": "Sort order for search results", "default": "default" }, "minPrice": { "title": "Minimum Price", "type": "number", "description": "Filter products with price above this value" }, "maxPrice": { "title": "Maximum Price", "type": "number", "description": "Filter products with price below this value" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for best results with AliExpress.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```