# 1688 Alibaba AliExpress Image Search: Compare Prices by Photo (`tenfoldfleet/1688-alibaba-aliexpress-image-search`) Actor

Compare a product's price on 1688, Alibaba and AliExpress from one photo: image search on all three returns matching listings with price in USD, MOQ, supplier and sold count, plus cheapest, median and factory-to-retail spread per photo. $4 per 1,000 matches; failed photos and summaries are free.

- **URL**: https://apify.com/tenfoldfleet/1688-alibaba-aliexpress-image-search.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** E-commerce, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 matched products

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

### What does 1688 Alibaba AliExpress Image Search do?

**1688 Alibaba AliExpress Image Search** takes one product photo and runs a **reverse image search on three marketplaces in the same call**: [1688.com](https://www.1688.com) (Chinese factory prices), [Alibaba.com](https://www.alibaba.com) (export wholesale) and [AliExpress](https://www.aliexpress.com) (retail). Every match comes back in one common row shape with its **price converted to USD**, and each photo ends with a **comparison row**: the cheapest and the median price on each marketplace and the spread between the 1688 factory price and the AliExpress retail price.

Not affiliated with 1688, Alibaba, AliExpress or Alibaba Group. Only public search results are read, and the Actor never signs in anywhere.

Use it from the Apify Console, on a schedule, through the **API**, or as a tool for an AI agent (it is listed for MCP clients).

#### How is this different from our single-marketplace image search Actors?

| | This Actor | Single-marketplace Actors |
|---|---|---|
| Input | one photo, searched on two or three marketplaces in the same run | one photo, one marketplace |
| Rows | one common shape for all three, `marketplace` column, `priceUsd` on every row | each marketplace's own, deeper fields |
| Prices | 1688 CNY converted to USD with the day's rate, optional min/max price filter | as listed |
| Extra | a per-photo summary row with cheapest, median and spread | none |
| Depth | up to 60 matches per marketplace | up to 100 (Alibaba), 600 (1688), 120 (AliExpress) |

It is built for the **cross-marketplace price question** and always searches at least two marketplaces. When you need one marketplace only, or everything that marketplace knows, use the deep Actor for it:

- [Alibaba Image Search](https://apify.com/tenfoldfleet/alibaba-image-search): supplier verification, review scores, certificates, up to 100 matches.
- [1688 Image Search: Suppliers by Photo](https://apify.com/tenfoldfleet/1688-image-search-suppliers-by-photo): up to 600 matches, factory flags, repurchase rate, optional product pages with price tiers.
- [AliExpress Reverse Image Search](https://apify.com/tenfoldfleet/aliexpress-reverse-image-search): ship-to country and currency, discounts, Choice flag, listing date.

### Why use it?

- **Dropshippers**: you sell (or want to sell) an item at AliExpress retail price. One run shows what the same-looking item costs from a 1688 factory and from an Alibaba exporter, in USD, so you can see the margin before you talk to anyone.
- **Sourcing agents**: a client sends a photo. You answer with three price levels and the suppliers behind them, instead of opening three sites and converting yuan by hand.
- **Amazon and Shopify sellers**: check whether a product you already buy on Alibaba is listed cheaper on 1688, and how low AliExpress sellers go on the same design.
- **AI agents**: one tool call returns comparable rows from three marketplaces and a ready summary, so the agent does not have to join three datasets.

### What data can it extract?

![Sample output of 1688 Alibaba AliExpress Image Search: Compare Prices by Photo, rows from a real run: Image, Row, Marketplace, #, Product, Price](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/1688-alibaba-aliexpress-image-search-output.png)

Match rows (`type: "match"`), one per listing:

| Field | Meaning |
|---|---|
| `imageUrl` | the photo you sent |
| `marketplace` | `1688`, `alibaba` or `aliexpress` |
| `rank` | position among the returned matches of that marketplace, 1 = closest visual match |
| `title`, `productUrl`, `image`, `productId` | the listing |
| `price`, `priceMax`, `currency` | price as listed. Alibaba: low and high end of the range. AliExpress: current price and list price before discount. 1688: unit price in CNY |
| `priceUsd` | `price` in US dollars |
| `priceConverted`, `convertedCurrency` | `price` in the comparison currency you chose (USD by default) |
| `moq`, `moqUnit` | minimum order quantity (AliExpress: 1 piece) |
| `supplierName`, `supplierUrl`, `supplierYears` | seller, when the marketplace shows it on the results card (AliExpress cards usually do not name the store) |
| `location` | 1688: province and city. Alibaba: supplier country. AliExpress: ship-from country |
| `soldCount`, `rating` | units sold and rating, where shown |
| `isAd` | paid placement on Alibaba or AliExpress (1688 ads are left out) |
| `isNewShopperPrice` | AliExpress only: the shown price is a first-order deal |

Summary row (`type: "summary"`, free), one per photo:

| Field | Meaning |
|---|---|
| `cheapest` | per marketplace: the lowest-priced match with `priceUsd`, `price`, `currency`, `moq`, `rank`, `title`, `productUrl`, `supplierName` |
| `cheapestMarketplace` | which marketplace has the lowest price overall |
| `medianPriceUsd` | per marketplace: median USD price of the returned matches |
| `spreadUsd`, `spreadPercent` | AliExpress median minus 1688 median, in USD and as a percent of the 1688 median |
| `matchCounts`, `totalMatches` | rows returned per marketplace |
| `marketplacesFailed` | marketplaces whose search failed for this photo |
| `cnyPerUsd`, `exchangeRateDate` | the exchange rate used |

Error rows (`type: "error"`, free) carry `error` and `errorCode`: `INVALID_URL`, `DOWNLOAD_FAILED`, `NOT_AN_IMAGE`, `IMAGE_TOO_LARGE`, `MARKETPLACE_BLOCKED`, `MARKETPLACE_FAILED`, `NO_MATCHES`, `NO_MATCHES_IN_PRICE_RANGE`, `ONE_MARKETPLACE`, `TOO_MANY_PHOTOS`, `FREE_PLAN_LIMIT`, `UNEXPECTED_ERROR`.

### How to compare prices on 1688, Alibaba and AliExpress by photo

1. Open the Actor and paste one or more public product photo URLs into **Product photo URLs**.
2. Leave all three marketplaces ticked, or untick one. A comparison needs at least two.
3. Set **Max matches per marketplace** (default 20). Fewer matches means a lower bill and a tighter comparison.
4. Optional: set a min and max price to drop accessories and look-alike items from another price class.
5. Click **Start**. Read the summary row of each photo first, then the match rows behind it.
6. Download the dataset as JSON, CSV or Excel, or read it through the API.

### How much does it cost?

**$0.004 per returned match** ($4 per 1,000), plus $0.00005 per run start. Summary rows and error rows are free, and so is any match that comes back without a USD price.

| Run | Matches | Price |
|---|---|---|
| 1 photo, 3 marketplaces, 20 matches each | up to 60 | up to $0.24 |
| 1 photo, 3 marketplaces, 5 matches each | up to 15 | up to $0.06 |
| 100 photos, 3 marketplaces, 10 matches each | up to 3,000 | up to $12 |

You are never charged for a photo that cannot be downloaded, a marketplace that fails or is blocked after retries (the other marketplaces are still returned and charged), a photo with no matches, or matches outside your price range. To cap the bill, give the run a maximum charge: the Actor returns the best-ranked matches that fit the budget and ends the run.

**Apify free plan:** a run compares the first 2 photos with up to 10 matches per marketplace. Any paid Apify plan removes the limit.

### Input

```json
{
    "imageUrls": [
        "https://cdn.dummyjson.com/product-images/kitchen-accessories/bamboo-spatula/thumbnail.webp"
    ],
    "marketplaces": ["1688", "alibaba", "aliexpress"],
    "maxResultsPerMarketplace": 20,
    "currency": "USD",
    "minPrice": 0.05,
    "maxPrice": 20,
    "includeSummary": true
}
```

- `imageUrls` (required): public links to JPG, PNG, WebP or GIF files, up to 10 MB each, up to 500 per run.
- `marketplaces`: two or three of `1688`, `alibaba`, `aliexpress`. Default: all three.
- `maxResultsPerMarketplace`: 5 to 60, default 20.
- `currency`: comparison currency for `priceConverted` and for the price filter. Default USD.
- `minPrice`, `maxPrice`: optional unit-price range in the comparison currency.
- `includeSummary`: default true.

### Output

One match row:

```json
{
    "type": "match",
    "imageUrl": "https://cdn.dummyjson.com/product-images/kitchen-accessories/bamboo-spatula/thumbnail.webp",
    "marketplace": "1688",
    "rank": 1,
    "productId": "555052134028",
    "title": "厂家日用竹铲子不粘锅家庭用寿司饭勺批发竹木饭勺圆头长柄米饭勺",
    "productUrl": "https://detail.1688.com/offer/555052134028.html",
    "image": "https://cbu01.alicdn.com/img/ibank/22777230525_481617559.jpg",
    "price": 1.25,
    "priceMax": 1.25,
    "currency": "CNY",
    "priceUsd": 0.1872,
    "priceConverted": 0.1872,
    "convertedCurrency": "USD",
    "moq": 1,
    "moqUnit": null,
    "supplierName": "邵武市福越竹制品厂",
    "supplierUrl": "https://shop1448557418512.1688.com",
    "supplierYears": 11,
    "location": "福建 邵武市",
    "soldCount": 2616324,
    "rating": 4.5,
    "isAd": false,
    "scrapedAt": "2026-11-16T04:15:57.902Z"
}
```

The summary row of the same photo (shortened):

```json
{
    "type": "summary",
    "imageUrl": "https://cdn.dummyjson.com/product-images/kitchen-accessories/bamboo-spatula/thumbnail.webp",
    "cheapestMarketplace": "1688",
    "cheapest": {
        "1688": { "priceUsd": 0.1048, "price": 0.7, "currency": "CNY", "moq": 1, "rank": 8, "productUrl": "https://detail.1688.com/offer/819729769742.html" },
        "alibaba": { "priceUsd": 0.15, "price": 0.15, "currency": "USD", "moq": 10000, "rank": 1, "productUrl": "https://www.alibaba.com/product-detail/Premium-Non-Scratch-Solid-Turner-Bamboo_1601272656078.html" },
        "aliexpress": { "priceUsd": 1.09, "price": 1.09, "currency": "USD", "moq": 1, "rank": 1, "productUrl": "https://www.aliexpress.com/item/1005011909965154.html" }
    },
    "medianPriceUsd": { "1688": 0.191, "alibaba": 0.645, "aliexpress": 5.15 },
    "spreadUsd": 4.96,
    "spreadPercent": 2596.3,
    "matchCounts": { "1688": 8, "alibaba": 8, "aliexpress": 8 },
    "totalMatches": 24,
    "marketplacesFailed": [],
    "cnyPerUsd": 6.678399,
    "exchangeRateDate": "2026-11-16"
}
```

Download the dataset as JSON, CSV, Excel or HTML, or fetch it with the Apify API.

### Tips

- **Crop to the item.** A photo that shows only the product finds the same design; a room scene or a model wearing it brings back look-alikes.
- **Keep the match count low for price work.** The closest 5 to 10 matches per marketplace are usually the same design; matches further down drift to look-alike products and pull the median away.
- **Use the price filter** to remove accessories and spare parts (very low prices) and bundles (very high prices) before the summary is calculated.
- **Read `moq` next to the price.** The lowest Alibaba price often needs an order of thousands of pieces, while 1688 and AliExpress sell from one piece.
- **AliExpress first-order deals** are flagged with `isNewShopperPrice`; `priceMax` holds the list price for those rows.
- 1688 titles and supplier names are in Chinese, as listed.

### FAQ

#### Are the matches the exact same product?

They are the listings each marketplace's own image search considers visually closest to your photo. The first ranks are usually the same design, often from the same factories, but nothing guarantees an identical item, material or size. Treat the summary as a price signal and open the listings before you order.

#### How are 1688 prices converted to USD?

1688 lists prices in Chinese yuan. The Actor fetches the day's exchange rates once per run and writes the rate and its date into every summary row (`cnyPerUsd`, `exchangeRateDate`). If the rates cannot be fetched, `priceUsd` stays empty for prices that are not in USD and the spread is not calculated; nothing is estimated, and matches without a USD price are not charged.

#### What happens when one marketplace blocks the search?

That marketplace gets a free error row for the photo (`MARKETPLACE_BLOCKED` or `MARKETPLACE_FAILED`) and is listed in `marketplacesFailed` in the summary. The other marketplaces are returned and charged as usual. When all three fail, the photo costs nothing.

#### Does it need a login, cookies or my own proxy?

No. The Actor works without a marketplace account or cookie, and its proxy traffic is part of the per-match price.

#### Can I call it from an AI agent or my own code?

Yes. Call it through the Apify API or the Apify MCP server with `imageUrls`; the summary row is designed to be read directly by an agent.

#### Does shipping, duty or tax appear in the prices?

No. Prices are listing prices. Freight from China, import duty and platform fees are not included, so the spread is a gross figure.

### Disclaimer

This Actor reads publicly visible search results only. Product photos, titles and trademarks belong to their owners. You are responsible for how you use the data and for following the laws that apply to you. Do not submit photos of people.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [1688 Image Search API - Reverse Image Search for Factory Prices](https://apify.com/tenfoldfleet/1688-image-search-suppliers-by-photo) | image search |
| [1688 Product Details API: Price Tiers, MOQ, Specs & Supplier](https://apify.com/tenfoldfleet/1688-product-details-scraper) | product details |
| [1688 Products Search: Wholesale Prices, Sales & Suppliers](https://apify.com/tenfoldfleet/1688-products-search) | product |
| [Alibaba Image Search - Reverse Lookup of Suppliers by Photo](https://apify.com/tenfoldfleet/alibaba-image-search) | matched product |
| [AliExpress Reverse Image Search - Similar Products & Prices](https://apify.com/tenfoldfleet/aliexpress-reverse-image-search) | image search |
| [Alibaba Scraper - Wholesale Suppliers, MOQ & Price Breaks](https://apify.com/tenfoldfleet/alibaba-products-scraper) | product |
| [Alibaba Verified Suppliers Scraper - Company Profiles](https://apify.com/tenfoldfleet/alibaba-verified-suppliers-scraper) | supplier profile |
| [AliExpress Reviews Scraper: Product Feedback & Photos Monitor](https://apify.com/tenfoldfleet/aliexpress-reviews-scraper) | review |
| [AliExpress Keyword Scraper - Exact Sold Counts by Search Term](https://apify.com/tenfoldfleet/aliexpress-search-scraper) | product |
| [Alibaba RFQ Scraper - New Buying Requests Monitor](https://apify.com/tenfoldfleet/alibaba-rfq-scraper-buying-requests-monitor) | new buying request |
| [Google Images API - Image Search Results in 90+ Countries](https://apify.com/tenfoldfleet/google-images-api) | image result |
| [Reverse Image Search - Find Every Site Using a Photo](https://apify.com/tenfoldfleet/reverse-image-search) | image searched |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/1688-alibaba-aliexpress-image-search/changelog.md

# Actor input Schema

## `imageUrls` (type: `array`):

Public links to product photos (JPG, PNG, WebP or GIF, up to 10 MB each), one per line. Every photo is searched on each chosen marketplace. Use a clear photo of the product alone; do not submit photos of people. Photos that cannot be downloaded are free. On the Apify free plan a run compares the first 2 photos.

## `marketplaces` (type: `array`):

Where to search each photo: pick two or three. All three are searched by default: 1688 (Chinese factory prices in CNY), Alibaba (export wholesale) and AliExpress (retail). A marketplace that fails for a photo gives a free error row; the others are still returned.

## `maxResultsPerMarketplace` (type: `integer`):

How many listings to return from each marketplace for each photo, best visual match first (5 to 60). Each returned match with a price is one charged result ($0.004), so the default of 20 on three marketplaces costs up to $0.24 per photo. On the Apify free plan this is capped at 10.

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

Three-letter currency code used for the converted price (priceConverted) and for the price filter below. Every match also carries priceUsd. 1688 prices are listed in CNY and converted with the day's exchange rate, fetched once per run.

## `minPrice` (type: `number`):

Optional. Only return matches whose unit price, in the comparison currency, is at least this. Matches outside the range are not returned and not charged.

## `maxPrice` (type: `number`):

Optional. Only return matches whose unit price, in the comparison currency, is at most this. Useful to drop look-alike products from another price class.

## `includeSummary` (type: `boolean`):

Adds one free summary row per photo: the cheapest match and the median price on each marketplace, the spread between 1688 and AliExpress in USD and percent, match counts and any marketplace that failed.

## Actor input object example

```json
{
  "imageUrls": [
    "https://cdn.dummyjson.com/product-images/kitchen-accessories/bamboo-spatula/thumbnail.webp",
    "https://cdn.dummyjson.com/product-images/sunglasses/black-sun-glasses/thumbnail.webp"
  ],
  "marketplaces": [
    "1688",
    "alibaba",
    "aliexpress"
  ],
  "maxResultsPerMarketplace": 20,
  "currency": "USD",
  "includeSummary": true
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "imageUrls": [
        "https://cdn.dummyjson.com/product-images/kitchen-accessories/bamboo-spatula/thumbnail.webp",
        "https://cdn.dummyjson.com/product-images/sunglasses/black-sun-glasses/thumbnail.webp"
    ],
    "currency": "USD"
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/1688-alibaba-aliexpress-image-search").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 = {
    "imageUrls": [
        "https://cdn.dummyjson.com/product-images/kitchen-accessories/bamboo-spatula/thumbnail.webp",
        "https://cdn.dummyjson.com/product-images/sunglasses/black-sun-glasses/thumbnail.webp",
    ],
    "currency": "USD",
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/1688-alibaba-aliexpress-image-search").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://cdn.dummyjson.com/product-images/kitchen-accessories/bamboo-spatula/thumbnail.webp",
    "https://cdn.dummyjson.com/product-images/sunglasses/black-sun-glasses/thumbnail.webp"
  ],
  "currency": "USD"
}' |
apify call tenfoldfleet/1688-alibaba-aliexpress-image-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/1688-alibaba-aliexpress-image-search"
        }
    }
}
```

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/s6HjtqXCqVMVaLuLP/builds/KrxsN8QX8HYCf66DV/openapi.json
