# AliExpress Image Search Scraper (`piotrv1001/aliexpress-image-search-scraper`) Actor The AliExpress Image Search Scraper finds AliExpress products that match a photo — reverse image search returning ranked listings with sale and original prices, discounts, unit price, ratings, units sold and a best-match flag for your ship-to country — ideal for sourcing and price benchmarking. - **URL**: https://apify.com/piotrv1001/aliexpress-image-search-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** E-commerce, AI, Automation - **Stats:** 4 total users, 0 monthly users, 96.7% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/actors/running/actors-in-store.md#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 Image Search Scraper Find AliExpress products from a photo. The **AliExpress Image Search Scraper** takes image URLs and returns the visually matching listings — the same "search by image" AliExpress runs on its site — with sale and original price, discount, unit price, star rating, units sold and a **best match** flag. Built for product sourcing, dropshipping research, competitor price checks and matching your own catalogue to AliExpress suppliers. ### ✨ Features - 📷 **Photo in, products out**: Any direct image URL (JPG, PNG, WebP up to 5 MB) or data: URL; one search per image, 60 matches on the first page and 45 on every further page. - 🏷️ **Real prices for your market**: Choose the ship-to country and currency; prices, discounts and availability follow it. - ⭐ **Ranked and flagged**: Matches come in AliExpress's own order with the best similar item marked, plus most-orders and price sorts. - 💰 **Sourcing signals**: Sale vs. original price, discount percentage, per-piece price, rating, sold count, launch date, Choice and bulk-price tags. - ⚡ **Fast**: A few seconds per image; hundreds of images per run. - 💸 **Pay per search**: One price per image searched, a small price per extra page — images that fail to load or return no matches are free. ### 🛠️ How It Works 1. **Paste image URLs** – Product photos from your catalogue, a competitor's store, or any page. 2. **Pick market and depth** – Ship-to country, currency, sort order and how many matches per image. 3. **Run the scraper** – Get one row per matching product, grouped by the image that found it. ### 💰 Pricing | Event | Price | What you get | | ------------ | ----: | ----------------------------------------------------------- | | Image search | $0.02 | One image searched, up to 60 matches | | Results page | $0.01 | Each additional page of up to 45 matches for the same image | 100 images at the default 60 matches cost $2.00. Images that cannot be loaded or return no matches are not charged. ### 📥 Input | Field | Type | Description | | -------------------- | ------- | ------------------------------------------------------------ | | `imageUrls` | array | Image URLs to search with. | | `shipTo` | string | Two-letter ship-to country. Default `US`. | | `currency` | string | Three-letter currency. Default `USD`. | | `sort` | string | `best_match` (default), `orders`, `price_asc`, `price_desc`. | | `maxResultsPerImage` | integer | Matches per image. Default `60`. | | `proxyConfiguration` | object | Keep the default. | ### 📊 Sample Output Data One row per match. Example (first two matches for one image): ```json [ { "queryImage": "https://ae-pic-a1.aliexpress-media.com/kf/S855220c50df546d5bab115643d3982d6R.jpg", "rank": 1, "isBestMatch": true, "productId": "1005010040139040", "url": "https://www.aliexpress.com/item/1005010040139040.html", "title": "10/20pcs Simulation strawberry artificial strawberry fake fruit home holiday party decoration photography props", "image": "https://ae-pic-a1.aliexpress-media.com/kf/Scc166a9b3c5041ee90d41496a81b4e54z.jpg", "price": 1.33, "originalPrice": 10.14, "discountPercent": 86, "unitPrice": 0.07, "unitLabel": "pc", "currency": "USD", "rating": 4.6, "sold": 160, "soldText": "160 sold", "launchedAt": "2025-09-24", "sellingPoints": ["Delivery: Sep 19 - 24"], "isChoice": true, "shipTo": "US", "scrapedAt": "2026-09-13T17:52:24.038Z" }, { "queryImage": "https://ae-pic-a1.aliexpress-media.com/kf/S855220c50df546d5bab115643d3982d6R.jpg", "rank": 2, "isBestMatch": false, "productId": "1005009725037810", "url": "https://www.aliexpress.com/item/1005009725037810.html", "title": "20Pcs Artificial Strawberries Fruit Fake Fruit for Home Table Party Decor Photography Prop Holiday Decor for Day Celebration", "image": "https://ae-pic-a1.aliexpress-media.com/kf/S4b41b9b2cedf4c1e9897a741c60aa5f8R.jpg", "price": 1.33, "originalPrice": 8.5, "discountPercent": 84, "unitPrice": null, "unitLabel": null, "currency": "USD", "rating": 4.8, "sold": 140, "soldText": "140 sold", "launchedAt": "2025-08-13", "sellingPoints": ["Delivery: Sep 19 - 24"], "isChoice": true, "shipTo": "US", "scrapedAt": "2026-09-13T17:52:24.038Z" } ] ``` Images that fail come back as `{ "queryImage": "...", "status": "image_error" | "no_matches", "error": "..." }` rows and are not charged. ### 🔗 Use cases - **Supplier sourcing**: Turn a competitor's product photos into AliExpress listings with prices and sales volume. - **Catalogue matching**: Map your SKUs to AliExpress equivalents by image instead of by title. - **Price benchmarking**: Compare your retail price against the cheapest visual matches for the customer's country. - **Trend research**: See how many sellers and how many units sold sit behind a viral product picture. Turn pictures into products — run the **AliExpress Image Search Scraper** today! 🚀 # Actor input Schema ## `imageUrls` (type: `array`): Photos to search with — direct image URLs (JPG, PNG or WebP, up to 5 MB) or data: URLs. One search per image. ## `shipTo` (type: `string`): Two-letter country code the prices and availability are calculated for, e.g. US, GB, DE, BR. ## `currency` (type: `string`): Three-letter currency code for all prices, e.g. USD, EUR, GBP. ## `sort` (type: `string`): Order of the matches. ## `maxResultsPerImage` (type: `integer`): Matches to return per image. The first page holds 60; each further page adds 45. ## `proxyConfiguration` (type: `object`): Keep the default. Each IP serves a handful of searches, so the Actor rotates through proxy sessions as needed. ## Actor input object example ```json { "imageUrls": [ "https://ae-pic-a1.aliexpress-media.com/kf/Sbf5a5b9337a442c99336f7e29821977fx.jpg", "https://ae-pic-a1.aliexpress-media.com/kf/S855220c50df546d5bab115643d3982d6R.jpg" ], "shipTo": "US", "currency": "USD", "sort": "best_match", "maxResultsPerImage": 60, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `matches` (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 = { "imageUrls": [ "https://ae-pic-a1.aliexpress-media.com/kf/Sbf5a5b9337a442c99336f7e29821977fx.jpg", "https://ae-pic-a1.aliexpress-media.com/kf/S855220c50df546d5bab115643d3982d6R.jpg" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/aliexpress-image-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "imageUrls": [ "https://ae-pic-a1.aliexpress-media.com/kf/Sbf5a5b9337a442c99336f7e29821977fx.jpg", "https://ae-pic-a1.aliexpress-media.com/kf/S855220c50df546d5bab115643d3982d6R.jpg", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/aliexpress-image-search-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 '{ "imageUrls": [ "https://ae-pic-a1.aliexpress-media.com/kf/Sbf5a5b9337a442c99336f7e29821977fx.jpg", "https://ae-pic-a1.aliexpress-media.com/kf/S855220c50df546d5bab115643d3982d6R.jpg" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call piotrv1001/aliexpress-image-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,piotrv1001/aliexpress-image-search-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 ` 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/apFCeSLfzSipkK7k7/builds/ZH8U9u8A8halvWIgh/openapi.json