# 1688 Image Search Scraper: Find Products by Photo (`theshark/1688-image-search-scraper`) Actor

Find 1688.com products by photo: give an image link or a 1688 offer and get visually similar products from other sellers, cheapest first, with similarity score, tiered prices, MOQ, stock, sales and supplier. Any image works. No login. Pay only for results.

- **URL**: https://apify.com/theshark/1688-image-search-scraper.md
- **Developed by:** [TheShark](https://apify.com/theshark) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 1,000 products

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?

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

## 1688 Image Search Scraper: Find Products and Suppliers by Photo

Search [1688.com](https://www.1688.com) (Alibaba 1688), China's largest wholesale marketplace, by image. Give a photo link or a 1688 offer, and get the products that look the same or very close from other sellers, with a `similarityScore`, tiered prices, minimum order quantity (MOQ), stock, sales, images, attributes, supplier profile and shipping. Find the factory behind a product, compare prices of the same item, or find cheaper sellers.

No 1688 account, login, cookies or proxies of your own are needed. You pay only for products that were collected successfully.

### What can you do with 1688 Image Search Scraper?

- **Find the source of a product:** search by a product photo from any online store or from your supplier and find who sells it on 1688.
- **Find cheaper sellers:** give a 1688 offer and get look-alikes from other sellers, sorted from the cheapest.
- **Compare suppliers:** price tiers, MOQ, sales, location, service score and repeat buyer rate side by side.
- **Check factories:** add supplier intelligence for factory cards, certificates and customization services.
- **Save money on large lists:** turn off product pages and get the search cards only, at a lower price.

### What data do you get?

| Data | Fields |
|---|---|
| Match | `similarityScore` (smaller is closer: below 0.1 is almost the same photo), the photo or offer that found it in `source` |
| Product | offer ID, link, title, category, attributes, package size and weight |
| Price and ordering | price range, quantity price tiers, MOQ, unit, stock, mixed wholesale |
| Sales | sold count, favorites, badges, review summary |
| Media | images, main images, video, description images |
| Supplier | company name, shop link, seller chat link, location, service score, repeat buyer rate, company registration, founding year, factory profile, shop metrics |
| Shipping | ships from, shipping cost, delivery promise, services |
| Optional | SKU variants, description HTML, reviews, supplier intelligence, same item from other sellers |

### How to search 1688 by image

1. Paste one or more photo links into **Photo URLs**, or 1688 offers into **Find look-alikes of offers**.
2. Set **Max results** and, if you like, filters such as price, MOQ, region or supplier type.
3. Click **Start**. Products appear in the dataset while the run goes on.
4. Download the results as JSON, CSV, Excel or HTML, or get them through the API.

If you start the actor with an empty input, it runs a small example photo search, so you can see what the data looks like.

### Photos and look-alikes

**Photo URLs.** Links on alicdn.com (1688 product images) are used directly. Any other image is downloaded, resized and uploaded to 1688: JPEG, PNG, GIF and WEBP work. Each photo is searched separately, up to about 700 products per photo.

**Look-alikes of offers.** The main image of the offer is used to find the same or very close products from other sellers, cheapest first. The offer itself is not included. Only products with `similarityScore` up to `maxSimilarityScore` (default 0.2) are kept: up to 0.1 is almost the same photo, 0.1 to 0.2 is the same kind of product, above 0.3 are often different models. Fashion and other visual categories may need a higher value, for example 0.3.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `imageUrls` | list of strings | empty | Photos to search by. |
| `similarToOfferIds` | list of strings | empty | 1688 product IDs or links to find look-alikes of. |
| `maxSimilarityScore` | number | `0.2` | Only for look-alikes: products with a higher `similarityScore` are skipped. |
| `maxResults` | integer, 1 to 1000 | `100` | Maximum number of products per photo or offer. |
| `scrapeProductPages` | boolean | `true` | `false`: products come straight from the search results, faster and cheaper (event `product-card`), with the search-card fields only. |
| `sortBy` | `relevance`, `bestSelling`, `priceAsc`, `priceDesc` | `relevance` | Order of photo search results. Look-alikes always come cheapest first. |
| `priceMin`, `priceMax` | number (CNY) | none | Only products priced at or above, or at or below, this value. |
| `minOrderQuantity` | integer | none | Only products whose MOQ is at most this value. |
| `merchantType` | `any`, `verifiedMerchant` | `any` | `verifiedMerchant`: only verified merchants (实力商家), checked on the product page. |
| `province`, `city` | string | none | Supplier province and city in Chinese characters, for example `广东`, `深圳`. |
| `excludeKeywords` | list of strings | empty | Skip products whose title contains any of these words. |
| `includeSkuDetails` | boolean | `false` | Add every variant with its options, price, stock and sales. |
| `includeDescriptionHtml` | boolean | `false` | Add the full product description as HTML. |
| `includeReviews` | integer, 0 to 100 | `0` | How many latest reviews to attach to each product. Charged per review. |
| `includeSupplierIntelligence` | boolean | `false` | Add factory card, product certificates, customization services and rankings. Charged as an add-on. |
| `includeSameItems` | boolean | `false` | Add up to 8 offers of the same item from other sellers. Charged as an add-on when the list is not empty. |

#### Examples

Search by photo:

```json
{
  "imageUrls": ["https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg"],
  "maxResults": 100
}
```

Cheaper sellers of a 1688 product, only very close matches:

```json
{ "similarToOfferIds": ["735353578254"], "maxResults": 50, "maxSimilarityScore": 0.1 }
```

Fast and cheap search cards for many photos:

```json
{
  "imageUrls": ["https://example.com/photo-1.jpg", "https://example.com/photo-2.png"],
  "maxResults": 300,
  "scrapeProductPages": false
}
```

### Output

One dataset row per product. Rows can be downloaded as JSON, CSV, Excel and more. Text fields (titles, attributes, supplier names, reviews) are in the original Chinese, prices are in CNY. The **Products** view shows full rows, the **Search cards** view shows rows taken from the search results. Example row (shortened; real rows have more fields):

```json
{
  "offerId": "735353578254",
  "detailUrl": "https://detail.1688.com/offer/735353578254.html",
  "status": "OK",
  "similarityScore": 0.04489852860569954,
  "title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套",
  "price": { "min": 9, "max": 9, "currency": "CNY", "basis": "quantity" },
  "quantityPrices": [
    { "minQuantity": 2, "price": 9 },
    { "minQuantity": 500, "price": 8.5 },
    { "minQuantity": 5000, "price": 7.5 }
  ],
  "minOrderQuantity": 2,
  "stock": 2692399,
  "soldCount": 19433,
  "supplier": {
    "companyName": "深圳市亿佳合兴科技有限公司",
    "serviceScore": 4,
    "repeatBuyerRate3m": 56.48,
    "location": "广东省深圳市"
  },
  "source": {
    "type": "image",
    "value": "https://cbu01.alicdn.com/img/ibank/O1CN01lAdPke1OFCTM0qUJK_!!3872131675-0-cib.jpg",
    "keyword": null
  },
  "scrapedAt": "2026-11-13T12:00:12+00:00"
}
```

### How much does it cost to search 1688 by image?

Pay per event: a flat price per product found and per add-on, with no extra fee per photo. The current prices are on the **Pricing** tab.

| Event | When it is charged |
|---|---|
| `product` | One product collected from its product page (status `OK`). |
| `product-card` | One product taken from the search results with product pages off (status `OK`). Cheaper than `product`. |
| `reviews` | One review attached to a product. |
| `supplier-intelligence` | At least part of the supplier intelligence data was found for a product. |
| `same-items` | `sameItems` is not empty. |

Only rows with status `OK` are charged, and an add-on only when its data is in the row. Set a maximum charge per run in Apify and the actor stops cleanly when it is reached.

#### Row statuses

| Status | Meaning | Charged? |
|---|---|---|
| `OK` | The product was collected. | Yes |
| `NOT_FOUND` | The product is no longer on 1688, or a photo search found nothing. | No |
| `BLOCKED` | 1688 did not show this page this time. Try it again later. | No |
| `ERROR` | The row could not be collected, for example an invalid link. `statusMessage` says why. | No |

### Good to know

- **About 700 products per photo.** That is how many 1688 returns for one photo search.
- **Filters.** Price, region, maximum MOQ, merchant type and excluded keywords apply to photo searches and look-alikes. With `verifiedMerchant` a photo can give fewer rows than `maxResults`, because it is checked on the product page.
- **Data is in Chinese.** Titles, attributes and supplier names come as 1688 shows them. Prices are in CNY.
- **No contacts and no buyer data.** No phone numbers, emails, WeChat or QQ, and no buyer names in reviews.
- **Run settings.** Give the run a timeout of at least 5 minutes. The minimum memory is 1024 MB.

### Integrations and API

Start runs and download results with the [Apify API](https://docs.apify.com/api/v2) or the Apify clients for Python and JavaScript, run on a schedule, and send results to Google Sheets, Slack, Make, Zapier, webhooks and other tools supported by Apify.

### FAQ

**Can I search by a photo that is not on 1688?**
Yes. Any public image link works: it is downloaded, resized and uploaded to 1688.

**What does `similarityScore` mean?**
How close the product image is to yours: smaller is closer. Below 0.1 is almost the same photo.

**Do I need a 1688 account or proxies?**
No. The actor uses its own proxies in China and does not log in.

**Is it legal to scrape 1688?**
The actor collects only publicly visible product information and no personal data. You are responsible for how you use the data and for following the laws and terms that apply to you.

### More 1688 scrapers

- [1688.com Wholesale Scraper](https://apify.com/TheShark/china-1688-scraper): every mode in one actor, plus suppliers and price monitoring.
- [1688 Search Results Scraper](https://apify.com/TheShark/1688-search-results-scraper): fast, low-cost product cards by keyword, link or category.
- [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper): full product pages by link or offer ID.
- [1688 Supplier Scraper](https://apify.com/TheShark/1688-supplier-scraper): supplier profiles and their products.
- [1688 Price Monitor](https://apify.com/TheShark/1688-price-monitor): track prices, stock and sales of your products.

# Actor input Schema

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

Links to photos to search by: 1688 finds visually similar products. Links on alicdn.com (1688 product images) are used directly; any other image is downloaded, resized and uploaded to 1688 (JPEG, PNG, GIF and WEBP work). Each image is searched separately, up to about 700 products per image. Every row has similarityScore: smaller is closer (for example, below 0.1 is almost the same photo).

## `similarToOfferIds` (type: `array`):

1688 product IDs or links. For each one, the scraper takes its main image and finds visually the same or very close products from other sellers, cheapest first (up to about 700 per offer), then scrapes them as normal products. The offer itself is not included. Every row has similarityScore: smaller is closer. Only products with similarityScore up to 0.2 are kept (about the same photo or the same kind of product); change this with Max similarityScore.

## `maxSimilarityScore` (type: `number`):

Only for 'Find look-alikes of offers'. Products with a higher similarityScore are skipped. Smaller means closer: up to 0.1 is almost the same photo, 0.1-0.2 is the same kind of product, above 0.3 are often different models. Leave empty for the default 0.2, which suits most goods; fashion and other visual categories may need a higher value (for example 0.3).

## `maxResults` (type: `integer`):

Maximum number of products per photo or look-alike offer. 1688 returns up to about 700 products per photo.

## `scrapeProductPages` (type: `boolean`):

On (default): every product is scraped from its own page, with the full set of fields. Off: products are taken straight from the photo search results, which is much faster and cheaper (billed as the cheaper product-card event); such rows have the search-card fields (title, price tiers, image, seller, sales, similarityScore). Reviews, supplier intelligence and same items need product pages.

## `sortBy` (type: `string`):

How search results are ordered.

## `priceMin` (type: `number`):

Only products priced at or above this value, in yuan. Leave empty for no filter.

## `priceMax` (type: `number`):

Only products priced at or below this value, in yuan. Leave empty for no filter.

## `minOrderQuantity` (type: `integer`):

Only products whose minimum order quantity (MOQ) is at most this value. Leave empty for no filter.

## `merchantType` (type: `string`):

Limit results to a type of supplier.

## `province` (type: `string`):

Filter by supplier province, in Chinese characters (for example 广东). Several provinces can be separated by commas (for example 江苏,浙江). Optional.

## `city` (type: `string`):

Filter by supplier city, in Chinese characters (for example 深圳). Optional.

## `excludeKeywords` (type: `array`):

Skip products whose title contains any of these words.

## `includeSkuDetails` (type: `boolean`):

Add the full variant matrix: each variant with its options, price, stock and sales.

## `includeDescriptionHtml` (type: `boolean`):

Add the full product description as HTML. Description text and images are always included.

## `includeReviews` (type: `integer`):

How many latest reviews to attach to each product (0 to 100). 1688 shows anonymous visitors only part of a product's reviews, so some products get fewer. Buyer names, avatars and profiles are never collected. Charged per review delivered.

## `includeSupplierIntelligence` (type: `boolean`):

Add a supplierIntelligence block: factory card for verified factories (videos, rankings, equipment list, production lines, OEM minimums, production capacity, factory address and coordinates), product certificates (including CE/FCC/RoHS), customization (services with prices, printing price list, lead times by quantity), dropshipping metrics and the product's ranking on 1688. Up to 6 extra requests per product. Charged as an extra event only when at least part of this data is found. Always included for free: founding year, company registration with address, supplier profile (staff, area, equipment, verification), shop metrics (stars, quality and fulfilment rates, followers, years on 1688) and the seller chat link.

## `includeSameItems` (type: `boolean`):

Add a sameItems list to each product: up to 8 offers of the same item from other sellers (title, price, sales text, image and link; no seller details). Billed as a same-items event only when the list is not empty. Needs product pages, so it is off when scrapeProductPages is false.

## Actor input object example

```json
{
  "maxResults": 100,
  "scrapeProductPages": true,
  "sortBy": "relevance",
  "merchantType": "any",
  "includeSkuDetails": false,
  "includeDescriptionHtml": false,
  "includeReviews": 0,
  "includeSupplierIntelligence": false,
  "includeSameItems": false
}
```

# Actor output Schema

## `results` (type: `string`):

One dataset row per product.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/1688-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("theshark/1688-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 '{}' |
apify call theshark/1688-image-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/1688-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 <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/wdxv59n65n6D99pdl/builds/LZCydGdwZTfyQPZHe/openapi.json
