# Scraper by Image - 1688 / Alibaba / AliExpress (`devcake/scraper-by-image`) Actor

Search products by image across 1688, Alibaba, AliExpress and 3 Chinese marketplaces, with a powerful scraper built for visual sourcing, product discovery, and automated marketplace research.

- **URL**: https://apify.com/devcake/scraper-by-image.md
- **Developed by:** [devcake](https://apify.com/devcake) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 619 total users, 177 monthly users, 100.0% runs succeeded, 6 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

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

## 🔎 Find Products by Photo Across 6 Marketplaces

**Search by photo** across **1688**, **Alibaba**, **AliExpress**, **Chinagoods**, **Yiwugo**, and **Made-in-China** in one run. Upload a product picture and get back similar items with prices, suppliers, ratings, and sales — perfect for sourcing, comparing, and shopping smarter.

> 🛍️ *Upload a photo. See similar products. Compare and choose.*

***

### 📑 What's Inside

- [📖 What This Tool Does](#-what-this-tool-does)
- [🤔 Why Search by Photo?](#-why-search-by-photo)
- [🏬 Marketplaces You Can Search](#-marketplaces-you-can-search)
- [✨ Why People Use It](#-why-people-use-it)
- [👥 Who It's For](#-who-its-for)
- [💡 Things You Can Do With It](#-things-you-can-do-with-it)
- [🏭 Sourcing by Photo: Suppliers & Manufacturers](#-sourcing-by-photo-suppliers--manufacturers)
- [🚀 How to Get Started](#-how-to-get-started)
- [📊 What You'll See in Your Results](#-what-youll-see-in-your-results)
- [📝 Example](#-example)
- [❓ Common Questions](#-common-questions)
- [🔗 People Also Search For](#-people-also-search-for)
- [⚠️ A Quick Note](#️-a-quick-note)

***

### 📖 What This Tool Does

**Find Products by Photo** helps you discover matching or similar products online using a **photo** instead of typing keywords. It's built for online sellers, resellers, sourcing agents, product researchers, shoppers, and anyone who wants a faster way to explore products across major marketplaces.

Upload a product photo, and the tool brings back related listings, suppliers, prices, product titles, images, and marketplace details — all in one clean list.

#### 🎯 What Does "Search by Photo" Mean?

**Searching by photo** (sometimes called **reverse image search** or **visual search**) means uploading a picture of a product and seeing other products that look like it. This is helpful when you don't know the exact product name, when translations are confusing, or when you simply want to see similar options.

***

### 🤔 Why Search by Photo?

Searching with words can be slow and hit-or-miss, especially when product names, translations, or category labels don't match. **Searching with a photo** is faster and more accurate — you don't even need to know the product name.

This tool helps you:

- ✅ Spend less time hunting for products
- ✅ Compare suppliers more quickly across different marketplaces
- ✅ Find products even when you don't know what they're called
- ✅ Build a smarter, faster way to source products

***

### 🏬 Marketplaces You Can Search

| Marketplace | What It's Known For |
|-------------|---------------------|
| **1688** | China's biggest wholesale marketplace — buy directly from factories at low minimum order quantities |
| **Alibaba** | The global B2B platform with verified suppliers ready for international trade |
| **AliExpress** | A worldwide retail marketplace with lots of customer reviews and sales data |
| **Chinagoods** | Yiwu's official wholesale marketplace — a huge range of small commodities, home goods, and accessories |
| **Yiwugo** | The Yiwu wholesale market online — low-cost small goods, gifts, stationery, and jewelry |
| **Made-in-China** | A major B2B platform connecting global buyers with Chinese manufacturers and exporters |

Pick one marketplace or search several at the same time. Every match is labeled with its marketplace, so you can compare results side by side in a single list.

> 💡 *Search all six at once to see factory prices, wholesale options, and retail listings together.*

***

### ✨ Why People Use It

#### 🔍 Find Products Using a Photo

Upload a product picture and discover similar items across six major marketplaces.

#### ⏱️ Save Hours of Searching

Skip the endless clicking and scrolling — the tool does the searching for you.

#### 🏭 Find More Suppliers

Discover similar products from different sellers so you can compare your options.

#### 🎯 Find Products Without Knowing the Name

Even when translations are confusing or category names don't match, a photo does the trick.

#### ⚖️ Compare Across Marketplaces

Look at prices, sellers, ratings, and product details across multiple platforms at once.

#### 🤖 Great for Online Business Automation

Perfect for product research, dropshipping, supplier discovery, catalog building, competitor tracking, and marketplace monitoring.

***

### 👥 Who It's For

This tool is useful for:

- 🛍️ **Online sellers** looking for new products to sell
- 📦 **Dropshippers** searching for similar products to resell
- 🤝 **Sourcing agents** comparing suppliers across different marketplaces
- 📚 **Product researchers** building product catalogs
- 📈 **Marketplace shoppers and analysts** tracking prices and availability
- 💻 **Developers and creators** building visual product search features
- ⚙️ **Automation teams** collecting product data at scale

***

### 💡 Things You Can Do With It

#### 🔥 Popular Uses

- 🔎 **Search 1688 by photo** — find wholesale alternatives directly from Chinese factories
- 🔎 **Search Alibaba by photo** — discover verified B2B suppliers around the world
- 🔎 **Search AliExpress by photo** — find retail sellers and customer reviews
- 🔎 **Search Chinagoods by photo** — explore Yiwu's official wholesale selection
- 🔎 **Search Yiwugo by photo** — hunt down low-cost small goods and gifts
- 🔎 **Search Made-in-China by photo** — connect with Chinese manufacturers and exporters
- 🎯 **Find products that look similar** to something you already like
- 🏪 **Discover alternative suppliers** for a product you're already buying
- ⚖️ **Compare the same product** across different marketplaces
- 📊 **Collect product details** in a clean, organized format
- 🧱 **Build a product sourcing workflow** around visual search
- 🚀 **Speed up product research** for your online store or dropshipping business

#### 🛠️ Real-World Examples

##### 💰 Find a Supplier from a Single Photo

See a product you like somewhere? Upload the photo and instantly get a list of suppliers selling the same or similar items — with prices you can compare side by side.

##### 💱 Compare Factory Price vs Retail Price

Run the same photo against **1688**, **Chinagoods**, or **Yiwugo** (wholesale) and **AliExpress** (retail) to see the difference and decide where to buy.

##### 🏬 Discover Backup Suppliers

Already buying from one supplier? Upload your product photo to find other shops selling the same thing — useful for negotiating better deals or finding a backup.

##### 👀 Keep an Eye on Competitors

Save photos of competitor products and re-search them from time to time to spot new sellers, price changes, and trending items.

##### 📚 Build a Product Catalog Fast

Process a batch of product photos to quickly fill a catalog with titles, prices, supplier info, and keywords — all organized and ready to use.

***

### 🏭 Sourcing by Photo: Suppliers & Manufacturers

Beyond a plain image search, the same photo can drive three sourcing jobs. Each one uses a different set of marketplaces, so pick the framing that matches what you're trying to do.

#### 🔎 Find a supplier by image

You have a product photo but no supplier. Upload it and the tool searches **Chinagoods**, **Yiwugo**, and **Made-in-China** at once, returning shops, prices, minimum order quantities, and product links. It works as a **supplier finder** driven entirely by the image — no product name or keyword needed.

#### 🧺 Yiwu wholesale sourcing with Chinagoods and Yiwugo

**Chinagoods** and **Yiwugo** are the online faces of the Yiwu wholesale market. For **yiwu wholesale sourcing**, run one photo against both: you get wholesale listings with shop names and market-zone details, then compare **yiwu wholesale market** prices side by side. Yiwugo's own **search by image** box finds the same stalls you'd visit in Yiwu in person.

#### 🏭 Find a Chinese manufacturer by photo

For B2B sourcing, **Made-in-China** lists manufacturers and exporters rather than retail resellers. Use **Made-in-China search by image** to go from a photo to the factory-facing suppliers behind a product, with company details, MOQ, and price ranges so you can shortlist before reaching out.

#### 🔁 Reverse image search for suppliers

Any of the three new marketplaces can act as a **reverse image search** for suppliers: one image in, a ranked list of matching shops and wholesale products out. That makes it useful for **product image search** and **visual product search** alike — find products by image first, then send the strongest candidates to a supplier-finder workflow.

***

### 🚀 How to Get Started

1. **Pick your marketplaces** — choose one or more of **1688**, **Alibaba**, **AliExpress**, **Chinagoods**, **Yiwugo**, and **Made-in-China**.
2. **Share your image** — paste one or more image links, or upload a photo from your computer or phone.
3. **Get your results** — receive one combined list, with each match labeled by marketplace.

Example input:

```json
{
  "targets": ["1688", "alibaba", "aliexpress", "chinagoods", "yiwugo", "made-in-china"],
  "imageUrls": ["https://example.com/my-product-photo.jpg"],
  "maxProducts": 40
}
```

> 💡 *The default settings work great for most people — you don't need to change anything to get started.*

***

### 📊 What You'll See in Your Results

For every product match, you'll get:

| Result Detail | What It Means |
|---------------|---------------|
| 🏬 **Marketplace** | Which site returned this match (1688, Alibaba, AliExpress, Chinagoods, Yiwugo, or Made-in-China) |
| 🖼️ **Product Photo** | The picture of the matching product from the marketplace |
| 📝 **Product Title** | The name of the product as listed |
| 🔗 **Product Link** | A direct link to the product page so you can visit it |
| 💰 **Price Range** | The lowest and highest price for that product |
| 💱 **Currency** | Which currency the price is shown in (like USD or CNY) |
| 📏 **Minimum Order** | The smallest quantity you have to buy |
| 🏭 **Supplier** | The seller, factory, or company behind the product |
| 🌍 **Location** | Where the seller is based |
| ⭐ **Rating** | The seller's average rating (when available) |
| 🔢 **Match Rank** | How closely the product matches your photo (rank #1 is the best match) |
| 🏷️ **Extra Details** | Badges and product details the marketplace provides |

#### 📋 The complete field list

The examples below are trimmed. **Every result actually contains the full set of fields** listed here — not every marketplace fills every one, so some are simply left blank.

| Group | Fields |
|-------|--------|
| 🏬 **Marketplace & match** | `target`, `provider`, `source_image`, `image_rank`, `similarity_score` |
| 📦 **Product** | `product_id`, `title`, `original_title`, `product_url`, `image_url`, `images`, `description`, `brand`, `unit`, `category_id`, `category_path`, `tags` |
| 💰 **Pricing** | `price_min`, `price_max`, `price_original_min`, `price_original_max`, `price_discount_pct`, `currency`, `currency_code`, `moq`, `stock` |
| 🏭 **Supplier** | `shop_name`, `shop_url`, `shop_id`, `country`, `zone`, `zone_name`, `years_as_member`, `years_as_gold_supplier`, `supplier_type`, `sponsored`, `audited_supplier`, `secured_trading`, `is_customizable`, `instant_order` |
| ⭐ **Ratings & sales** | `rating`, `service_score`, `consultation_score`, `logistics_score`, `return_score`, `review_count`, `sold_count`, `sold_90d`, `month_sold`, `bookings`, `inquiry_uv`, `collect_count` |
| ✅ **Trust & delivery** | `factory_inspected`, `delivery_hours`, `return_days`, `member_credit_url` |
| 🏷️ **Listing badges** | `lunch_time`, `badge_title`, `badge_icon`, `product_type` |
| 📎 **Extra details** | `raw` — marketplace-specific fields that don't fit the columns above |

> 💡 *`provider` is just another copy of `target`. A couple of internal fields used by the tool are also present but aren't useful to you.*

***

### 📝 Example

#### Input

```json
{
  "targets": ["1688", "alibaba", "aliexpress", "chinagoods", "yiwugo", "made-in-china"],
  "imageUrls": ["https://example.com/my-product-photo.jpg"],
  "maxProducts": 40
}
```

#### Output

Each match is one row. Every row has the same shape; only the populated fields differ. Trimmed, real examples:

**1688**

```json
{
  "target": "1688",
  "provider": "1688",
  "image_rank": 1,
  "product_id": "785042982479",
  "title": "洁厕灵液厕所马桶清洁剂洗厕所神器强力除垢臭去异味黄渍留香",
  "product_url": "https://dj.1688.com/ci_bb?a=281&...",
  "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01FjGefj1L65l3PRbBi_!!3915221249-0-cib.jpg",
  "images": ["https://cbu01.alicdn.com/img/ibank/O1CN01FjGefj1L65l3PRbBi_!!3915221249-0-cib.jpg", "...", "...", "...", "...", "...", "..."],
  "description": "品牌:海布森 箱装数量:45 计量单位:瓶 品牌类型:国货品牌 货号:HBS-歪头洁厕-樱花500 净含量:500ml 香型:樱花 产地:湖北",
  "category_id": "122258006",
  "category_path": "122258006 122212003 130822220",
  "unit": "瓶",
  "price_min": 2.5,
  "price_max": 2.5,
  "currency": "CNY",
  "currency_code": "CNY",
  "moq": 1,
  "shop_name": "小森(湖北)实业发展有限公司",
  "shop_url": "https://sneakerclub.1688.com?tracelog=p4p",
  "country": "CN",
  "years_as_member": 7,
  "rating": 4.08,
  "service_score": 4.08,
  "consultation_score": 4.0,
  "logistics_score": 3.43,
  "return_score": 4.67,
  "review_count": null,
  "sold_count": 28621,
  "sold_90d": 7947,
  "month_sold": 2432,
  "bookings": 7143,
  "inquiry_uv": 75,
  "factory_inspected": true,
  "delivery_hours": 48,
  "return_days": 7,
  "member_credit_url": "https://xinyong.1688.com/credit/publicCreditDetail.htm?...",
  "image_id": "1329108775620620440",
  "search_mode": "mtop_upload",
  "tags": ["湖北", "武汉市", "A", "源头工厂", "超级工厂", "生产加工", "高回购率", "验厂", "48小时发货", "单位:瓶"]
}
```

**Alibaba**

```json
{
  "target": "alibaba",
  "provider": "alibaba",
  "image_rank": 1,
  "product_id": "1601440928964",
  "title": "Wallpaper Latex Paint Wall Painted Wall Tile Wall Glass Cleaning Paste Bathroom Kitchen Remover Cream",
  "product_url": "https://www.alibaba.com/product-detail/Wallpaper-Latex-Paint-Wall-Painted-Wall_1601440928964.html",
  "image_url": "https://s.alicdn.com/@sc04/kf/H64f64ad8b4954ee8899756453fedcaa8L.jpg_300x300.jpg",
  "images": ["https://s.alicdn.com/@sc04/kf/H64f64ad8b4954ee8899756453fedcaa8L.jpg_300x300.jpg", "...", "...", "...", "...", "..."],
  "category_path": "601_1000_1102",
  "price_min": 0.55,
  "price_max": 1.2,
  "currency": "USD",
  "currency_code": "USD",
  "moq": 1,
  "shop_name": "Jiangsu Yajie Trading Co., Ltd.",
  "shop_url": "https://jsyjsm.en.alibaba.com/company_profile.html",
  "country": "CN",
  "years_as_gold_supplier": 6,
  "is_customizable": false,
  "instant_order": false,
  "rating": 4.9,
  "logistics_score": 4.8,
  "review_count": 30,
  "sold_count": null,
  "month_sold": null,
  "image_id": "/icbuimgsearch/imageBase64_3855ae10b0094558854d4cee5ecc1b4f.jpeg@@oss_us",
  "search_mode": "data_url_upload",
  "tags": ["Easy Return"]
}
```

**AliExpress**

```json
{
  "target": "aliexpress",
  "provider": "aliexpress",
  "image_rank": 1,
  "product_id": "1005012463231044",
  "title": "Kitchen Foam Cleaner, Cooktop Decontaminate Oil Decontaminate Clean A Variety Of",
  "product_url": "https://www.aliexpress.us/item/1005012463231044.html",
  "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sc68f0a1d511b48f29eff9600b00a8aabB.jpg",
  "images": ["https://ae-pic-a1.aliexpress-media.com/kf/Sc68f0a1d511b48f29eff9600b00a8aabB.jpg"],
  "category_id": "202188604",
  "category_path": "15,200033149,1514,202188604",
  "price_min": 9.85,
  "price_max": 9.85,
  "price_original_min": 61.53,
  "price_original_max": 61.53,
  "price_discount_pct": 84,
  "currency": "$",
  "currency_code": "USD",
  "moq": null,
  "shop_name": null,
  "shop_url": null,
  "country": "US",
  "rating": null,
  "review_count": null,
  "sold_count": null,
  "month_sold": null,
  "lunch_time": "2026-06-07 00:00:00",
  "badge_title": "Best similar item",
  "badge_icon": "https://ae-pic-a1.aliexpress-media.com/kf/S3cc733bb652f443c8eae09deb1b5fcb89.png",
  "product_type": "natural",
  "image_id": "OSS/ae-image-search-us/2026-06-24/3fd17003-f1f8-4957-a95d-584046d04bfc.jpg",
  "search_mode": "mtop_upload",
  "tags": ["New shoppers save $6.14", "Delivery: Jun. 27 - Jul. 02"]
}
```

**Chinagoods**

```json
{
  "target": "chinagoods",
  "provider": "chinagoods",
  "source_image": "https://cdnimg.chinagoods.com/jpg/2020/07/10/6f1ccdb18131fbf87cb9345e5707746e.jpg",
  "search_mode": "image",
  "image_rank": 1,
  "similarity_score": 100,
  "product_id": "2076247",
  "title": "JS Series stainless steel body Auto water pumps for garden",
  "product_url": "https://www.chinagoods.com/store/goodsdetail/2076247",
  "category_id": "8883",
  "image_url": "https://cdnimg.chinagoods.com/jpg/2020/07/10/6f1ccdb18131fbf87cb9345e5707746e.jpg",
  "images": ["https://cdnimg.chinagoods.com/jpg/2020/07/10/6f1ccdb18131fbf87cb9345e5707746e.jpg", "...", "...", "..."],
  "price_min": 290.0,
  "price_max": 290.0,
  "currency": "CNY",
  "currency_code": "CNY",
  "moq": 1,
  "stock": 94547,
  "sold_count": 8,
  "collect_count": 98,
  "shop_name": "台州长虹泵业有限公司",
  "shop_url": "https://www.chinagoods.com/store/6177789",
  "shop_id": "6177789",
  "country": "二区33号门4楼19342",
  "zone": "02",
  "zone_name": "国际商贸城二区"
}
```

**Yiwugo**

```json
{
  "target": "yiwugo",
  "provider": "yiwugo",
  "source_image": "https://cdnimg.chinagoods.com/jpg/2020/07/10/6f1ccdb18131fbf87cb9345e5707746e.jpg",
  "search_mode": "image",
  "image_rank": 1,
  "product_id": "984066813",
  "title": "foreign trade large pressure tank jet-s vortex self-priming pump household water pump 220v 110v jet pump source factory",
  "product_url": "https://en.yiwugo.com/product/detail/984066813.html",
  "image_url": "https://ywgimg.yiwugo.com/product/shop_269932/normal/984497521/20260323/lfePlQFB9HU2byWl.png",
  "images": ["https://ywgimg.yiwugo.com/product/shop_269932/normal/984497521/20260323/lfePlQFB9HU2byWl.png"],
  "price_min": 65.0,
  "price_max": 65.0,
  "currency": "CNY",
  "currency_code": "CNY",
  "shop_name": "kelly Pump",
  "shop_url": "https://en.yiwugo.com/hu/021399801.html"
}
```

**Made-in-China**

```json
{
  "target": "made-in-china",
  "provider": "made-in-china",
  "source_image": "https://cdnimg.chinagoods.com/jpg/2020/07/10/6f1ccdb18131fbf87cb9345e5707746e.jpg",
  "search_mode": "image",
  "image_rank": 1,
  "product_id": "838711405",
  "title": "Printed Squeezing Water Bottle with Drinking Draw",
  "product_url": "https://m.made-in-china.com/product/Printed-Squeezing-Water-Bottle-with-Drinking-Draw-838711405.html",
  "image_url": "https://image.made-in-china.com/43f34j00kESRDzjqZNcW/Printed-Squeezing-Water-Bottle-with-Drinking-Draw.webp",
  "images": ["https://image.made-in-china.com/43f34j00kESRDzjqZNcW/Printed-Squeezing-Water-Bottle-with-Drinking-Draw.webp"],
  "price_min": 0.98,
  "price_max": 1.8,
  "currency": "USD",
  "currency_code": "USD",
  "moq": 300
}
```

***

### ❓ Common Questions

#### What is "search by photo"?

**Search by photo** (also called **reverse image search**) means uploading a picture and getting back other pictures that look similar. This tool uses it specifically for **finding products** across online marketplaces.

#### How does it work?

You give the tool a product photo (a link or a file), and it shows you similar listings from the marketplaces you picked — with details like price, supplier, and ratings.

#### Which marketplaces can I search?

You can search **1688**, **Alibaba**, **AliExpress**, **Chinagoods**, **Yiwugo**, and **Made-in-China** — individually or all together.

#### Can I search 1688?

Yes — full support for **1688 search by photo**, perfect for finding factory-direct wholesale products.

#### Can I search Alibaba, AliExpress, Chinagoods, Yiwugo, and Made-in-China?

Yes — all six are supported. Search **Alibaba** and **Made-in-China** for B2B suppliers, **AliExpress** for retail sellers, and **Chinagoods** and **Yiwugo** for Yiwu wholesale goods.

#### How do I search Yiwugo by image?

Select **Yiwugo** and upload a product photo. The tool runs Yiwugo image search for you and returns matching Yiwu market products with prices, suppliers, and shop links.

#### How can I find a Chinese manufacturer from a photo?

Select **Made-in-China** and upload the product photo. It is matched against manufacturer and exporter listings, returning company names, prices, MOQ, and product links so you can shortlist the maker behind the photo.

#### How do I find a supplier from an image?

Upload the image and select several marketplaces at once. The supplier finder by image returns shops across **Chinagoods**, **Yiwugo**, and **Made-in-China** in one combined list.

#### Can I compare prices across different marketplaces?

Yes — select multiple marketplaces in one run. Every result is labeled with its marketplace, making wholesale and retail results easy to compare.

#### What kind of details will I get back?

Each match includes a photo, title, product link, price range, currency, minimum order, supplier, location, rating, and how closely it matches your photo.

#### Is this tool officially connected to these marketplaces?

No — see the [note below](#️-a-quick-note). This is an independent helper tool; the marketplace names are only used to describe where it can search.

#### Do I need any technical skills?

Not at all. If you can upload a photo and click a button, you can use this tool.

***

### ⚠️ A Quick Note

This tool is **not affiliated with, endorsed by, or officially connected to 1688, Alibaba, AliExpress, Chinagoods, Yiwugo, or Made-in-China**. The marketplace names are only used to describe which shopping sites the tool can search.

# Actor input Schema

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

Paste one or more public image links. Ignored if you upload a photo below.

## `imageFile` (type: `string`):

Single image upload. Overrides the URLs above when provided.

## `targets` (type: `array`):

Pick one or more marketplaces to search. All results come back together in one list.

## `maxProducts` (type: `integer`):

Maximum number of matches to return for each photo on each marketplace. Keep it low for a quick test.

## `proxy` (type: `object`):

Optional. Leave empty to use Apify RESIDENTIAL automatically.

## `maxConcurrency` (type: `integer`):

How many photos to process at the same time. Leave the default unless you need more speed.

## `minDelay` (type: `number`):

Shortest wait between requests. Higher values are gentler on the sites.

## `maxDelay` (type: `number`):

Longest wait between requests. Higher values are safer but slower.

## `maxRetries` (type: `integer`):

How many times to try again if a marketplace does not respond.

## Actor input object example

```json
{
  "imageUrls": [
    "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg"
  ],
  "targets": [
    "aliexpress"
  ],
  "maxProducts": 20,
  "maxConcurrency": 2,
  "minDelay": 2,
  "maxDelay": 5,
  "maxRetries": 1
}
```

# Actor output Schema

## `matches` (type: `string`):

Every matched product from all your photos and marketplaces, with prices, suppliers, and details.

## `overview` (type: `string`):

The same matches shown as an easy-to-read table you can sort and scan.

## `summary` (type: `string`):

A short report of how each marketplace and photo did, plus overall totals for your search.

# 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://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg"
    ],
    "targets": [
        "aliexpress"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("devcake/scraper-by-image").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://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg"],
    "targets": ["aliexpress"],
}

# Run the Actor and wait for it to finish
run = client.actor("devcake/scraper-by-image").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://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg"
  ],
  "targets": [
    "aliexpress"
  ]
}' |
apify call devcake/scraper-by-image --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,devcake/scraper-by-image"
        }
    }
}
```

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/FgmNEalTtRCer2lkN/builds/bWoFUCeysBgaBId9H/openapi.json