# Alibaba Image Search Scraper — Products & Suppliers by Photo (`apimy/alibaba-image-search-scraper`) Actor

Search Alibaba.com by image: give a picture link or a product page link and get up to 100 look-alike products with price, minimum order, supplier, country, ratings and certificates. No login, no proxy setup.

- **URL**: https://apify.com/apimy/alibaba-image-search-scraper.md
- **Developed by:** [Nikita Iakovlev](https://apify.com/apimy) (community)
- **Categories:** E-commerce, Lead generation, AI
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$0.16 / 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

## Alibaba Image Search Scraper

Search **Alibaba.com by image**. Give the Actor a link to a product photo, or a link to a product page in any online shop, and it returns up to 100 Alibaba products that look like it — with price range, minimum order, supplier name, country, years on Alibaba, ratings and certificates. No Alibaba account, no cookies, no proxy setup.

Use it to find a supplier for a product you already sell, to check what a competitor's product costs at the factory, or to source look-alikes in bulk from a list of pictures.

### Tested head-to-head — 18 November 2026

Same photo (sunglasses on a white background), 20 products requested, five other Alibaba image search Actors run from a regular buyer account:

| | This Actor | Others |
|---|---|---|
| Cost of the run (20 products) | $0.0032 | $0.02 – $0.10 |
| Run time | 3–4 s | 6–8 s |
| Fields per product | 41 | 21–40 |
| Finished with data | yes | 4 of 5 (one failed on this photo) |

The best match was the same product in this Actor and in the three largest of the others — the results come from Alibaba's own image search, so the difference is price, speed and how the data is prepared.

### What you get for every match

| Field | Example |
|---|---|
| `title`, `productUrl`, `productId` | SEG Custom Rectangle Aluminum LED Light Box, link, 1601788514815 |
| `imageUrl`, `images` | full-size product pictures |
| `price`, `priceMin`, `priceMax`, `currency` | `$10.90-11.20`, 10.9, 11.2, USD |
| `minOrderQuantity`, `minOrderUnit` | 300, pairs |
| `supplierName`, `supplierCountry`, `supplierYears`, `supplierUrl` | Shenzhen San Nan Technology Co., Ltd., CN, 4, storefront link |
| `verifiedSupplier`, `verifiedBy`, `supplierCertificates` | true, SGS, \[ISO] |
| `reviewScore`, `reviewCount`, `productScore`, `soldCount` | 4.8, 41, 4.9, 12 |
| `tradeAssurance`, `productCertificates`, `deliveryEstimate`, `guarantee` | true, \[CE, FCC], Delivery by 14 Dec, Easy Return |
| `position`, `queryImage` | place in Alibaba's results (1 is the best match) and the picture it was found for |
| `detectedCategories` | categories Alibaba recognised in your picture |

A value Alibaba does not show on the card is `null`, never a made-up zero.

### Input

- **Image links** — one picture per line. Any of these works:
  - a direct link to a JPG, PNG, WEBP, AVIF or GIF picture;
  - a link to a product page (Amazon, Shopify, AliExpress, Alibaba, any shop) — the page's main picture is used;
  - a link written without `https://`.
- **Max products per image** — 1 to 100. Alibaba's image search returns at most 100 matches per picture.
- **Category** *(optional)* — keep only matches from one category. Alibaba recognises several categories in every picture; write one of them or a word from its name (for example `sunglasses`). The recognised categories are listed in `detectedCategories` of every row, so a first run tells you what to write.
- **Min price / Max price, Max minimum order, Supplier countries** *(optional)* — filters applied to the matches. If the filters remove everything, the run says which filter removed how many.
- **Currency** and **Ship to** — currency of the prices and the country delivery estimates are shown for. Default: USD, US.

Example:

```json
{
  "imageUrls": ["https://images.unsplash.com/photo-1572635196237-14b3f281503f?w=600"],
  "maxItemsPerImage": 100,
  "category": "sunglasses",
  "maxMinOrder": 50
}
```

Tips for better matches: one product per photo, plain background, the product fills most of the frame. Large pictures are downsized automatically.

### Price

**$0.16 per 1,000 products** ($0.00016 per product returned). A full search of one picture with 100 matches costs $0.016. There is no start fee.

You are not charged for pictures that could not be opened, pictures with no matches, products removed by your filters, or the explanation rows.

### How it works

The Actor downloads your picture, hands it to Alibaba.com's own image search and reads the result list the site shows to visitors. Prices are fixed to the currency you choose, so they do not change with the location of the server. If Alibaba does not answer, the request is repeated through other network routes automatically.

When something cannot be done, the dataset says why in plain words in a free row with `type: "notice"`: a link that is not a picture, a picture with no matches, filters that removed everything. Filter these rows out with `type = "product"`.

### Limits

- Alibaba returns at most 100 matches per picture. To see more, run the same picture again with **Category** set to each of the `detectedCategories`.
- The results are what Alibaba's image search shows; the match quality depends on the photo.
- Full specifications, price tiers by quantity and reviews are on the product page, not in image search results. For those, pass the `productUrl` values to [Alibaba Products Scraper](https://apify.com/blueskyscraper/alibaba-products-scraper).

### Related Actors

| Need | Actor |
|---|---|
| Search 1688.com (Chinese domestic factory prices) by image | [1688 Image Search Scraper](https://apify.com/blueskyscraper/1688-image-search-scraper) |
| Alibaba products by keyword, with details | [Alibaba Products Scraper](https://apify.com/blueskyscraper/alibaba-products-scraper) |
| 1688 products by keyword or link | [1688 Scraper](https://apify.com/blueskyscraper/1688-scraper) |
| Taobao and Tmall products | [Taobao & Tmall Scraper](https://apify.com/blueskyscraper/taobao-tmall-scraper) |

### API example

```bash
curl -X POST "https://api.apify.com/v2/acts/apimy~alibaba-image-search-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "content-type: application/json" \
  -d '{"imageUrls":["https://images.unsplash.com/photo-1572635196237-14b3f281503f?w=600"],"maxItemsPerImage":20}'
```

The Actor also works through the Apify MCP server: an AI agent can call it with one image link and read the matches as JSON.

# Actor input Schema

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

One picture per line: a direct link to a JPG, PNG or WEBP photo of the product you want to source. A link to a product page (Amazon, Shopify, AliExpress, any shop) works too — the page's main picture is used. Each picture is searched on Alibaba.com separately.

## `maxItemsPerImage` (type: `integer`):

How many look-alike products to return for each picture, best match first. Alibaba returns at most 100 per picture. You pay per product returned.

## `category` (type: `string`):

Keep only matches from one category, for example "sunglasses" or "phone cases". Alibaba detects several categories for every picture (they are listed in the detectedCategories field of each row); write one of them, or a word from its name. Leave empty to get the best matches from all categories.

## `minPrice` (type: `string`):

Keep products whose price range reaches this amount or more, in the currency chosen below. Example: 2.5

## `maxPrice` (type: `string`):

Keep products whose price range starts at this amount or less, in the currency chosen below. Example: 20

## `maxMinOrder` (type: `integer`):

Keep products you can order in small quantity: the supplier's minimum order must be this number of units or less. Example: 50

## `supplierCountries` (type: `array`):

Keep suppliers from these countries only: two-letter codes, one per line, for example CN, VN, IN, TR, US. Leave empty for all countries.

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

Currency of the prices.

## `shipTo` (type: `string`):

Two-letter code of the country the goods would ship to, for example US, GB, DE, AU. Alibaba shows delivery estimates and some offers for this country.

## `includeRunSummary` (type: `boolean`):

Adds one free row at the end of the dataset: how many rows were delivered and what the run cost.

## Actor input object example

```json
{
  "imageUrls": [
    "https://images.unsplash.com/photo-1572635196237-14b3f281503f?w=600"
  ],
  "maxItemsPerImage": 100,
  "currency": "USD",
  "shipTo": "US",
  "includeRunSummary": true
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (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://images.unsplash.com/photo-1572635196237-14b3f281503f?w=600"
    ],
    "maxItemsPerImage": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("apimy/alibaba-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://images.unsplash.com/photo-1572635196237-14b3f281503f?w=600"],
    "maxItemsPerImage": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("apimy/alibaba-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://images.unsplash.com/photo-1572635196237-14b3f281503f?w=600"
  ],
  "maxItemsPerImage": 100
}' |
apify call apimy/alibaba-image-search-scraper --silent --output-dataset

```

## MCP server setup

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