# Yiwugo Image Search Scraper (`piotrv1001/yiwugo-image-search-scraper`) Actor

The Yiwugo Image Search Scraper finds Yiwugo.com wholesale products that look like your photo, capturing CNY price ranges, MOQs, stock, order counts, shop names and Yiwu market booth addresses — ideal for product sourcing and supplier discovery.

- **URL**: https://apify.com/piotrv1001/yiwugo-image-search-scraper.md
- **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community)
- **Categories:** E-commerce, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 image searches

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

### 🚀 Yiwugo Image Search Scraper

Find the Yiwu market supplier behind any product photo. The **Yiwugo Image Search Scraper** takes a product image and returns the visually similar products listed on Yiwugo.com — the online storefront of the Yiwu International Trade City, the world's largest small-commodities wholesale market — with wholesale prices, minimum order quantities, order counts and the seller's market address and booth. Built for product sourcing, supplier discovery, dropshipping research and price benchmarking.

### ✨ Features

- 📸 **Search by photo**: paste any public image URL (a marketplace listing photo, a screenshot, your own product shot). No keywords or Chinese needed.
- 🎯 **Up to 100 matches per photo**, most similar first, each with its `position` in the similarity ranking.
- 💴 **Wholesale data on every match**: price range in CNY, minimum order quantity and unit, stock, order count and units sold.
- 🏪 **Supplier and booth details**: shop name and URL, membership level, market address, booth number, market door and street, sub-market and floor. Everything you need to walk up to the booth on a sourcing trip.
- 🏷️ **Sponsored flag**: every row says whether the listing is a paid placement.
- 🖼️ **Any common format**: JPEG, PNG, WebP, GIF or AVIF up to 10 MB; base64 `data:` URLs work too. Photos are resized automatically to what the site accepts.
- 🔓 **No Yiwugo account, login or cookies.**

### 🛠️ How It Works

1. **Add image URLs** – one or many; each image is searched separately.
2. **Choose how many matches** you want per image (up to 100).
3. **Run** – get one row per matching product, ranked by similarity, ready to export as JSON, CSV or Excel or to pull through the API.

### ⚙️ Input

| Field                | Description                                | Default     |
| -------------------- | ------------------------------------------ | ----------- |
| `imageUrls`          | Public image URLs (or base64 `data:` URLs) | —           |
| `maxResultsPerImage` | Matches to return per image (1–100)        | `60`        |
| `proxyConfiguration` | Proxy settings                             | Apify Proxy |

```json
{
    "imageUrls": ["https://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg"],
    "maxResultsPerImage": 100
}
```

### 📊 Sample Output Data

```json
[
    {
        "searchImage": "https://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg",
        "position": 1,
        "productId": "945252683",
        "url": "https://www.yiwugo.com/product/detail/945252683.html",
        "title": "仿真迷你PVC水果塑料草莓树莓草莓片道具装饰假草莓模型儿童玩具",
        "imageUrl": "https://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg",
        "images": ["https://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg"],
        "price": 0.27,
        "maxPrice": 1.8,
        "currency": "CNY",
        "priceOnRequest": false,
        "minOrderQuantity": 200,
        "unit": "个",
        "stock": 354894,
        "orderCount": 0,
        "soldQuantity": 0,
        "isSponsored": false,
        "onlineOrdering": true,
        "shipsWithinDays": 3,
        "dropshipping": false,
        "shopId": "765167",
        "shopName": "简美工艺品",
        "shopUrl": "https://www.yiwugo.com/hu/765167.html",
        "memberLevel": "senior",
        "marketAddress": "浙江省金华市义乌市紫金二区18栋2单元202",
        "factoryAddress": "浙江省 金华市 义乌市 紫金二区18栋2单元202",
        "boothNo": "88800",
        "marketDoor": null,
        "marketStreet": null,
        "subMarket": "1013",
        "floor": 1,
        "scrapedAt": "2026-10-09T09:16:29.946Z"
    }
]
```

Images that cannot be downloaded or decoded produce an `image_error` row, and photos without matches a `no_matches` row. Both are free.

### 💰 Pricing

Pay per photo searched, not per row. No monthly rental.

| Event        | Price                                                         |
| ------------ | ------------------------------------------------------------- |
| Image search | **$0.02** per image with matches, including up to 100 matches |
| Actor start  | **$0.00005** per run                                          |

100 matches for one photo cost $0.02; 50 photos cost $1.00. Failed images and images without matches are free.

### ℹ️ Good to Know

- Titles, shop names and addresses are returned as Yiwugo shows them, in Chinese. Prices are in CNY.
- `price` is the lowest wholesale price and `maxPrice` the highest when the seller lists a range. When the seller asks buyers to contact them for a price, `price` is empty and `priceOnRequest` is `true`.
- Yiwugo returns at most 100 matches per photo. Products the site has taken down since they were indexed are skipped, so a photo can return slightly fewer.
- The same product can match several of your photos. It is listed once per photo, and never twice for the same photo.
- Need supplier contacts (mobile, WeChat, email) or keyword search? Use the [Yiwugo Listings Scraper](https://apify.com/piotrv1001/yiwugo-listings-scraper) with the `productId` values.
- Searching other Chinese marketplaces by photo? See the [1688 Image Search Scraper](https://apify.com/piotrv1001/1688-image-search-scraper) and the [AliExpress Image Search Scraper](https://apify.com/piotrv1001/aliexpress-image-search-scraper).

### 🔗 Related Actors

- [Yiwugo Listings Scraper](https://apify.com/piotrv1001/yiwugo-listings-scraper) — Yiwugo products by keyword, with supplier contacts.
- [Chinagoods Image Search Scraper](https://apify.com/piotrv1001/chinagoods-image-search-scraper) — search Chinagoods (the official Yiwu market platform) by photo, with price tiers and booth locations.
- [Made-in-China Image Search Scraper](https://apify.com/piotrv1001/made-in-china-image-search-scraper) — search Made-in-China.com suppliers by photo, with US$ price ranges and MOQ.
- [Alibaba Image Search Scraper](https://apify.com/piotrv1001/alibaba-image-search-scraper) — search Alibaba.com suppliers by photo.
- [1688 Image Search Scraper](https://apify.com/piotrv1001/1688-image-search-scraper) — find the factory price on China's domestic 1688 wholesale market by photo.
- [AliExpress Image Search Scraper](https://apify.com/piotrv1001/aliexpress-image-search-scraper) — search AliExpress by photo, with retail prices and orders for your country.

Source smarter with the **Yiwugo Image Search Scraper** today! 🚀

# Actor input Schema

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

Public URLs of product photos (JPEG, PNG, WebP, GIF or AVIF, up to 10 MB each). A base64 data: URL also works. Each image is searched separately.

## `maxResultsPerImage` (type: `integer`):

How many visually similar Yiwugo products to return for each image, most similar first. Yiwugo returns up to 100 matches per photo.

## `proxyConfiguration` (type: `object`):

Keep the default Apify Proxy.

## Actor input object example

```json
{
  "imageUrls": [
    "https://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg",
    "https://ywgimg.yiwugo.com/product/shop_285318/normal/0/20260418/kVASQ5pjUIe2bukj.jpg"
  ],
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "imageUrls": [
        "https://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg",
        "https://ywgimg.yiwugo.com/product/shop_285318/normal/0/20260418/kVASQ5pjUIe2bukj.jpg"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("piotrv1001/yiwugo-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 = {
    "imageUrls": [
        "https://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg",
        "https://ywgimg.yiwugo.com/product/shop_285318/normal/0/20260418/kVASQ5pjUIe2bukj.jpg",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("piotrv1001/yiwugo-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://ywgimg.yiwugo.com/product/shop_275507/normal/945252683/20250606/rwo04jaOT9Rno3Db.jpg",
    "https://ywgimg.yiwugo.com/product/shop_285318/normal/0/20260418/kVASQ5pjUIe2bukj.jpg"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call piotrv1001/yiwugo-image-search-scraper --silent --output-dataset

```

## MCP server setup

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