# AliExpress Image Search Scraper (`dami_studio/1688-alibaba-aliexpress-image-search-scraper`) Actor

AliExpress image search scraper that also does 1688 image search and Alibaba image search. Give it a product photo and find the matching products, one row each: price, minimum order, units sold, supplier, factory and audit flags, link. Up to 500 per photo on each site. $0.33 per 1,000 products.

- **URL**: https://apify.com/dami_studio/1688-alibaba-aliexpress-image-search-scraper.md
- **Developed by:** [Dami's Studio](https://apify.com/dami_studio) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 7 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.33 / 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

**AliExpress image search scraper that searches 1688 and Alibaba.com by image too**: give it a product photo, as a link or a file from your computer, and get back the
products each marketplace's own picture search matches to it, one row each, with the price, minimum order, units sold,
the supplier and the link.

A match means the pictures look alike. It is not proof that two listings are the same product or come from the same
factory, so treat the rows as a shortlist to check, not an answer.

| | |
|---|---|
| **Input** | Picture links (JPG, PNG, WebP, GIF or BMP), a key-value store holding your own pictures, or 1688 offer ids |
| **Output** | One row per matched product: price, minimum order, units sold, supplier, years on the platform, factory and audit flags, rating, similarity, link. On request: the 1688 product page (price ladder, stock, weight), translated titles, changes since the last run |
| **Ceiling** | 500 products per picture on each marketplace, 100 pictures, 100 offer ids and 10,000 rows per run |
| **Speed** | About 3 to 5 seconds a picture across all three marketplaces in our runs |
| **Account needed** | None from you |
| **Price** | $0.33 per 1,000 products, the same price on every plan. The free plan's $5 a month covers about 15,000. A 1688 product page, when you ask for it, is $0.94 per 1,000 |

| Using an AI agent? | |
|---|---|
| Actor | `dami_studio/1688-alibaba-aliexpress-image-search-scraper` |
| Set one field | `imageUrls`, labelled "Picture links" in the Console |
| Cap the bill | `maxTotalChargeUsd` on the run, for example `0.10`: it never charges past that |
| MCP, one link | `https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/1688-alibaba-aliexpress-image-search-scraper` |
| How often | Whenever a new product needs a supplier, or daily with "Only new results" to catch new listings |

### 🌏 中文说明

用一张商品图片，同时在1688、阿里巴巴国际站和速卖通上以图搜货。每个匹配到的商品一行：价格、起订量、销量、供应商、所在省份、是否生产厂家、链接。

在"Picture links"里填图片链接。电脑里的图片：在Storage的Key-value stores页面点Create new新建一个键值存储，用它的Upload按钮上传图片，再在"Or pictures saved in a key-value store"里选中它。也可以按1688商品ID查详情页（阶梯价、库存、单件重量、发货地），或把标题和属性翻译成英文等语言。按商品条数收费，价格见上方表格。不需要任何平台的账号。这不是1688、阿里巴巴或速卖通的官方产品。

### 🔍 What AliExpress Image Search Scraper does

Each picture is fetched once and handed to the picture search of every marketplace you picked. 1688 answers with Chinese
factory and wholesale listings priced in yuan, Alibaba.com with export suppliers, AliExpress with retail listings
priced for the country you ship to.

Rows come back in each marketplace's own order, most similar first, unless you ask for best sellers or price order.
Alibaba.com's picture search has no sort of its own, so its rows keep its order whatever you pick.

Filters go to the marketplace, and the ones a row shows (price band, minimum order, province, supplier type) are
checked again on every row: one outside them is dropped and never charged, and the log says how many went. 1688's own
filters are there too: city, dropshipping, free shipping, certified factories, waybills.

**1688: add each product's page** adds what a match's product page shows: the price ladder, stock, weight per unit,
where it ships from and how fast. 1688 offer ids come back as one such row each, no picture needed, and under **Or find
products like these 1688 offers** their main pictures are searched.

Pick **Other online stores worldwide** and the run also returns look-alike products from stores across the web, each
with its title, link, picture and store but no price. Titles, attributes and tags can come translated into 30 languages
at no extra charge.

### 📋 What data you get from each matched product

| What you get | Field |
|---|---|
| Which marketplace and picture it answers, its place in the results and how many the marketplace found | `marketplace`, `queryImage`, `imageIndex`, `rank`, `resultsFound` |
| The product's id, title, link and pictures | `productId`, `title`, `url`, `imageUrl`, `images` |
| Price, the top of a price range, the price before a discount, the discount, currency and a price note | `price`, `priceMax`, `originalPrice`, `discountPercent`, `currency`, `priceNote` |
| The price in the currency you picked | `convertedPrice`, `convertedCurrency`, `exchangeRateDate` |
| Minimum order and its unit | `moq`, `unit` |
| Sales and repeat buyers | `soldCount`, `soldText`, `bookedCount`, `repurchaseRate` |
| Ratings | `rating`, `reviewCount`, `productScore`, `shippingScore`, `supplierScore` |
| How alike it looks, and the marketplace's own flags | `similarityScore`, `isBestMatch`, `isAd`, `isChoice`, `isCustomizable`, `instantOrder`, `launchedAt` |
| The supplier | `supplierName`, `supplierId`, `supplierLoginId`, `supplierUrl`, `supplierYears`, `supplierCountry`, `supplierProvince`, `supplierCity` |
| Factory, audit and membership flags | `businessType`, `isFactory`, `factoryAudited`, `businessAudited`, `superFactory`, `powerMerchant`, `trustPass`, `goldSupplier`, `auditReportUrl` |
| Attributes, certifications, service promises and promotions | `attributes`, `certifications`, `serviceTags`, `sellingPoints` |
| 1688's own "find similar" page for the match | `similarItemsUrl` |
| The 1688 product page, when you ask for it | `detailsDelivered`, `priceTiers`, `availableQuantity`, `unitWeightKg`, `shipsFrom`, `deliveryPromise`, `buyerProtections`, `isDropshipping`, `mixedOrderAllowed`, `categoryId`, `descriptionUrl`, `dropshipReady`, `landedCostUsd` |
| Translations into the language you pick | `titleTranslated`, `attributesTranslated`, `serviceTagsTranslated`, `sellingPointsTranslated`, `translatedTo` |
| What changed since the last run of the same search | `previousPrice`, `priceChange`, `previousSoldCount`, `soldSincePreviousRun`, `previousRunAt`, `isNewSinceLastRun` |
| The offer id or link you looked up | `requestedAs` |

### ▶️ How to search 1688, Alibaba and AliExpress by image

1. Open [AliExpress Image Search Scraper](https://apify.com/dami_studio/1688-alibaba-aliexpress-image-search-scraper) and click **Try for free**.
2. Paste picture links into **Picture links**, one per line. Pictures on your computer go into a key-value store first (see the questions below), which you pick under **Or pictures saved in a key-value store**.
3. Pick the **Marketplaces** and the number of **Products per picture, per marketplace**.
4. Add filters if you want them: prices, **Largest minimum order**, **Manufacturers only**, **1688: supplier provinces**.
5. Click **Start**, then download the rows as JSON, CSV or Excel, or read them from the API.

Start it with no picture at all and it returns one free sample row, so you can see the shape first.

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

**$0.33 per 1,000 products**, the same price on every plan. On the free plan, the $5 Apify gives you each month covers
about 15,000 products.

A 1688 product page, when you ask for one, is **$0.94 per 1,000**, charged only once it is in your row.

You pay for product rows only. Sample and note rows are free, and so is any product a filter left out. A picture that
finds nothing costs nothing. With "Only new results", products an earlier run already delivered are skipped free.

### 📥 What you give it

```json
{
  "imageUrls": ["https://cbu01.alicdn.com/img/ibank/O1CN01FCwJrl29btzNvQkHM_!!2235628087-0-cib.jpg"],
  "marketplaces": ["1688", "alibaba", "aliexpress"],
  "maxResultsPerImage": 20
}
```

| Field | If you leave it empty | What it is |
|---|---|---|
| `imageUrls` | one free sample row | Picture links, one per line. data: URLs and base64 work too. |
| `pictureStores` | nothing | Key-value stores holding your pictures, picked in the form or given by id. Every picture in them is searched. |
| `offerIds` | nothing | 1688 offer ids or links, up to 100. Each comes back as one row with its product page. |
| `similarToOffers` | nothing | 1688 offer ids or links whose main picture is searched like a picture link. |
| `marketplaces` | `1688`, `alibaba`, `aliexpress` | Add `otherStores` for look-alike products on stores worldwide, without prices. |
| `maxResultsPerImage` | 20 | Products per picture on each marketplace, 1 to 500. |
| `maxItems` | 1,000 | Rows in the whole run, 1 to 10,000. Your cost ceiling. |
| `maxImages` | 100 | Pictures searched in the run: links first, then offers, then stores. The rest are left out with a free note. |
| `sortBy` | `relevance` | `relevance`, `sales`, `priceAsc` or `priceDesc`. |
| `minPriceCny`, `maxPriceCny` | no limit | 1688 price band in yuan. |
| `minPrice`, `maxPrice` | no limit | Alibaba.com and AliExpress price band, in `currency`. |
| `maxMoq` | no limit | Keep 1688 and Alibaba.com products you can order in this quantity or fewer. |
| `manufacturersOnly` | off | 1688 production businesses and super factories, Alibaba.com's manufacturers. Leaves AliExpress and other stores out. |
| `verifiedSuppliersOnly` | off | 1688 suppliers with a factory or business audit, Alibaba.com's verified suppliers. Leaves AliExpress and other stores out. |
| `provinces` | all of China | 1688 supplier provinces, picked from the list. |
| `cities` | all of China | 1688 supplier cities, from 1688's own list. A city takes in the towns under it: Jinhua 金华 covers Yiwu 义乌. |
| `supplierFeatures` | none | 1688's own filters, such as `dropshipping`, `freeShipping`, `realFactoryCertified` and waybills like `waybillDouyin`. Two from the same group in the form (Shipping, Dropshipping, Supplier, Service) keep offers with either; different groups must all hold. |
| `excludeKeywords` | none | Leave out products whose title has any of these words. |
| `excludeAds` | off | Drop paid placements. |
| `includeDetails` | off | The 1688 product page for every 1688 row. |
| `translateTo` | no translation | Language for `titleTranslated` and the translated attributes and tags, such as `en`, `es` or `de`. |
| `shippingCostPerKgUsd`, `dutyPercent` | no landed cost | Your shipping rate per kg and duty rate. With product pages on, `landedCostUsd` adds them to the dollar price. |
| `currency` | `USD` | The currency Alibaba.com and AliExpress show prices in, and the one `convertedPrice` uses. 1688 lists in yuan. |
| `shipTo` | `US` | AliExpress ship-to country, two letters. |
| `onlyNewResultsName` | every run returns everything | A name for a repeated search. Later runs with the same name skip products already delivered. |
| `compareWithPreviousRun`, `snapshotName` | off | Adds last run's price and sales to each product, for the same search or name. |
| `proxyConfiguration` | the standard connection | Leave it as it is unless you need the run to go out through a particular network. Servers of your own are used exactly as given. |
| `maxConcurrency` | 1 | Pictures searched at once, 1 to 5. |
| `minDelaySecs`, `maxDelaySecs` | 0 | A random pause between pictures, in seconds. |
| `maxRetries` | 0 | Extra tries, 0 to 3, for a marketplace that doesn't answer. |

A value the run can't use stops it before any search, with a free row that says what to change.

### 📤 What you get back

A real 1688 row from a run on 3 November 2026, trimmed:

```json
{
  "marketplace": "1688",
  "rank": 3,
  "productId": "953222245848",
  "title": "狗狗牵引绳猫狗通用一体式加粗狗绳遛狗绳狗链小中大型犬通用跨境",
  "url": "https://detail.1688.com/offer/953222245848.html",
  "price": 9,
  "currency": "CNY",
  "moq": 100,
  "unit": "件",
  "soldCount": 3,
  "repurchaseRate": "43%",
  "similarityScore": 0.229,
  "isAd": false,
  "supplierName": "上海居坤宠电子商务有限公司",
  "supplierYears": 2,
  "supplierProvince": "上海",
  "supplierScore": 4,
  "businessType": "生产加工",
  "isFactory": true,
  "attributes": [{ "name": "产品类别", "value": "牵引带" }, { "name": "材质", "value": "PP" }],
  "serviceTags": ["先采后付", "回头率43%"]
}
```

| Field | How to read it |
|---|---|
| `price` | The price the results show a visitor at that moment, before shipping. On 1688 it is the card's price; quantity discounts are in `priceTiers` when you add the product page. |
| `priceTiers` | 1688's price by quantity band: `minQuantity`, `maxQuantity` (empty for the last band) and `price`. |
| `detailsDelivered` | True when the row carries its 1688 product page. Only those pages are charged. |
| `landedCostUsd` | The 1688 price in US dollars, plus your shipping rate times `unitWeightKg`, plus your duty. Empty unless you give a shipping rate. |
| `dropshipReady` | True when the product page shows single pieces, 1688's dropshipping mark and stock on hand. |
| `titleTranslated` | The title in `translatedTo`. With English picked, Alibaba.com and AliExpress titles are kept as they are. |
| `supplierName` | The supplier, or for other online stores the store's web address, such as shopee.com.my. |
| `priceMax` | Alibaba.com's top of the range. Null where the listing shows one price. |
| `convertedPrice` | `price` in your `currency`. 1688's yuan are converted at the European Central Bank's reference rate of `exchangeRateDate`. Null for a currency that rate sheet doesn't list. |
| `soldCount`, `soldText` | Units sold as a number, and the marketplace's own label, such as "10万+件" (100,000+). |
| `similarityScore` | 1688's own score for how alike the pictures are. Null on Alibaba.com and AliExpress, which rank without one. |
| `isBestMatch` | AliExpress's "Best similar item" badge. |
| `businessType` | On 1688, 生产加工 is a production business and 经销批发 a wholesaler. `isFactory` is true for the first. |
| `attributes` | 1688's attribute labels for the product, such as material (材质). |

### 🧾 Reading the output

| Row | How to spot it | Charged |
|---|---|---|
| A product | `recordType: "product"`, `ok: true` | Yes |
| The sample | `_sample: true`, written only when no picture was given | No |
| A note | `_diagnostic: true`, `ok: false`, with an `errorCode` | No |

The note codes: `BAD_INPUT` (a setting or picture the run can't use, `details` says which), `NO_RESULTS` (nothing
found, or nothing left after your filters), `NOT_FOUND` (a picture or 1688 offer that's gone), `NOT_SERVED` (a
marketplace, page or translation didn't answer this run), `TIME_LIMIT`, `COST_LIMIT` (the run reached its time or your
spending limit), `PROXY_INPUT_ADJUSTED` and `UNEXPECTED_ERROR`. Filter on `recordType = "product"` to keep only
products.

### 💡 What people use it for

- You spotted a product on TikTok Shop or Amazon and want the factory price: run its photo on 1688 with `sortBy: "sales"`.
- Clients send you photos rather than product names, and you need a shortlist of suppliers for each.
- Before listing a product, you check whether AliExpress already sells it and at what price.
- You watch a handful of factory listings: their ids under `offerIds`, `compareWithPreviousRun` on, a daily schedule.

A recipe for a dropshipping shortlist: run the photo on 1688 with `includeDetails` on and `translateTo: "en"`, keep
the rows where `dropshipReady` is true, then check each supplier with
[Alibaba 1688 Supplier Ratings Scraper](https://apify.com/dami_studio/alibaba-1688-supplier-ratings-scraper).

### 🚧 What it does not do

- It doesn't decide whether a match is the same product. The marketplaces rank by how alike the pictures look.
- It doesn't search by keyword. For that, use the scrapers in the table below.
- Prices are what a visitor sees at that moment, before shipping, duties and tax.
- It doesn't collect anyone's contact details.
- It is not an official 1688, Alibaba.com or AliExpress tool. Dami's Studio is independent and is not affiliated with or endorsed by 1688, Alibaba.com or AliExpress, or by any other company named on this page.

### 🧭 Which marketplace scraper do you need?

| If you want | Use |
|---|---|
| Products that look like your photo on 1688, Alibaba.com, AliExpress or other stores, and 1688 offers by id | This one |
| 1688 offers for a keyword | [1688 Wholesale Scraper](https://apify.com/dami_studio/1688-wholesale-scraper) |
| Alibaba.com products for a keyword | [Alibaba.com Scraper](https://apify.com/dami_studio/alibaba-com-scraper) |
| AliExpress products for a keyword | [AliExpress Products Scraper](https://apify.com/dami_studio/aliexpress-products-scraper) |
| A 1688 supplier's scores and audits | [Alibaba 1688 Supplier Ratings Scraper](https://apify.com/dami_studio/alibaba-1688-supplier-ratings-scraper) |
| Buyer reviews of a 1688 product | [1688 Reviews Scraper](https://apify.com/dami_studio/1688-reviews-scraper) |
| Reviews of an AliExpress product | [AliExpress Reviews Scraper](https://apify.com/dami_studio/aliexpress-reviews-scraper) |

### ❓ Questions people ask

#### Do I need a 1688, Alibaba or AliExpress account to search by image?

No. You need no account on any of the three, and the run reads what a visitor who isn't signed in sees.

#### What kind of picture finds the best matches?

The product alone, filling most of the frame, on a plain background. A screenshot of a listing works. A link to a
product page doesn't: open the picture itself and copy its address.

#### Can I search with a photo from my computer?

Yes. In Apify, open **Storage**, then **Key-value stores**, click **Create new** and upload the photos there with the
**Upload** button. Pick that store under **Or pictures saved in a key-value store** and every photo in it is searched.

#### Can I get 1688 titles in English?

Yes: `translateTo: "en"` adds `titleTranslated`, and translated attributes and tags, at no extra charge.

#### Why don't the results match what I see on the site?

Picture search shifts with the day, the country and the person asking, and each marketplace mixes in paid placements.
Open the same picture in a private browser window, set to the same country, before comparing.

#### Can I call it from code or an AI assistant?

Yes. The actor's API tab has ready calls, and its MCP address is
`https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/1688-alibaba-aliexpress-image-search-scraper`. In Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("dami_studio/1688-alibaba-aliexpress-image-search-scraper").call(
    run_input={"imageUrls": ["https://cbu01.alicdn.com/img/ibank/O1CN01FCwJrl29btzNvQkHM_!!2235628087-0-cib.jpg"], "maxResultsPerImage": 20},
    max_total_charge_usd=0.10,
)
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row.get("ok") is False:
        continue
    print(row["marketplace"], row["price"], row["currency"], row["title"])
```

#### Is scraping 1688, Alibaba and AliExpress legal?

The products are public listings, read the way a signed-out visitor sees them, with no account and nothing private.
Supplier and shop names can be personal data where the supplier is a person, so GDPR and similar laws apply: keep what
you need. Each marketplace's own terms still apply to what you do with the data. Apify has a longer read on
[whether web scraping is legal](https://blog.apify.com/is-web-scraping-legal/). We are not lawyers.

### 🆘 If something breaks

Open an issue on the actor's Issues tab with the run's link and the picture you searched with. A note row's `errorCode`
and `details` help most.

# Actor input Schema

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

Direct links to product pictures (JPG, PNG, WebP, GIF or BMP, up to 10 MB each), one per line. A picture from an Amazon, Shopify, TikTok Shop or AliExpress listing works, and so does your own photo. A link to a product page is not a picture: open the picture itself and copy its address. data: URLs and base64 also work. Up to 100 pictures a run.

## `pictureStores` (type: `array`):

For pictures on your computer: open Storage, then Key-value stores, click Create new, add the pictures with the store's Upload button, and pick that store here. Every JPG, PNG, WebP, GIF or BMP in it is searched. Up to 100 pictures a run, links included.

## `offerIds` (type: `array`):

Look 1688 offers up directly: offer ids or detail.1688.com links, one per line. Each comes back as one row with its product page, charged as a product page. Up to 100 a run.

## `similarToOffers` (type: `array`):

1688 offer ids or links, one per line. Each offer's main picture is searched like a picture link, on the marketplaces picked below.

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

Where to look for each picture: 1688, Alibaba.com and AliExpress by default. Other online stores worldwide adds products that look like the picture on stores across the web, each with its title, link, picture and store, without a price.

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

How many matching products to keep for each picture on each marketplace, most similar first. 1688 lists up to about 700 for a picture, Alibaba.com a few thousand, AliExpress a few hundred.

## `maxItems` (type: `integer`):

A hard ceiling on rows, and so on the bill, across every picture and marketplace.

## `maxImages` (type: `integer`):

How many pictures the run searches. They count in this order: picture links, then the 1688 offers to find similar products for, then the pictures in your key-value stores. The rest are left out with a free note.

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

Most similar first, best sellers first, or by price. Alibaba.com's picture search has no sort of its own, so its rows keep Alibaba.com's order.

## `minPriceCny` (type: `number`):

Leave out 1688 products priced below this, in Chinese yuan. Rows left out are not charged.

## `maxPriceCny` (type: `number`):

Leave out 1688 products priced above this, in Chinese yuan.

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

Leave out products priced below this, in the currency picked below.

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

Leave out products priced above this, in the currency picked below.

## `maxMoq` (type: `integer`):

Keep 1688 and Alibaba.com products you can order in this quantity or fewer. AliExpress sells single items, so it has no minimum order.

## `manufacturersOnly` (type: `boolean`):

Keep products from suppliers listed as manufacturers: on 1688 a production business or a super factory, on Alibaba.com its own manufacturers filter. AliExpress shops are left out when this is on.

## `verifiedSuppliersOnly` (type: `boolean`):

Keep 1688 suppliers with a factory or business audit and Alibaba.com's verified suppliers. AliExpress shops are left out when this is on.

## `provinces` (type: `array`):

Keep 1688 suppliers from these provinces only. Empty means all of China.

## `cities` (type: `array`):

Keep 1688 suppliers in these cities only, from 1688's own city list. Empty means all of China.

## `supplierFeatures` (type: `array`):

1688's own filters. Two from the same group (the word before the colon) keep offers with either one; filters from different groups must all hold.

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

Products whose title contains any of these words are dropped and never charged, on every marketplace. Not case-sensitive; Chinese words work on 1688 titles.

## `excludeAds` (type: `boolean`):

Drop products a marketplace marks as paid placements. Rows left out are not charged.

## `includeDetails` (type: `boolean`):

Reads the product page of every 1688 match and adds its price ladder, stock, weight per unit, ship-from city, dispatch promise, buyer protections and full gallery. Each page is charged only when it is in your row.

## `translateTo` (type: `string`):

1688 writes in Chinese. Pick a language and every row also gets titleTranslated and translated attributes and tags, at no extra charge. Alibaba.com and AliExpress rows, already in English, are translated only into another language.

## `shippingCostPerKgUsd` (type: `number`):

With the product pages on, each 1688 row gets landedCostUsd: its price in US dollars, plus this rate times the weight per unit on its page, plus the duty below. Leave it empty for no landed cost.

## `dutyPercent` (type: `number`):

Added on the dollar price when landedCostUsd is worked out. Empty means none.

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

The currency those two show prices in. 1688 prices are always in Chinese yuan (CNY).

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

Two-letter country code AliExpress works out prices and availability for, such as US, GB, DE or BR.

## `onlyNewResultsName` (type: `string`):

Give the search a name, such as summer-dresses, and every later run with the same name skips products it already delivered, free. Handy on a schedule. Letters, digits and dashes. Empty means every run returns everything.

## `compareWithPreviousRun` (type: `boolean`):

Adds what each product cost and had sold on the previous run of the same search: previousPrice, priceChange, previousSoldCount and soldSincePreviousRun. A product that run didn't have is marked isNewSinceLastRun.

## `snapshotName` (type: `string`):

Optional. Runs with the same name compare with each other. Empty means the same pictures and marketplaces compare with themselves. Letters, digits and dashes.

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

Optional. The run works without it. Proxy URLs given here are the only connections the run uses.

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

1 to 5. More finishes a long list sooner; rows still come out in picture order.

## `minDelaySecs` (type: `number`):

Before each next picture, or group of pictures, the run waits a random time between the shortest and the longest pause.

## `maxDelaySecs` (type: `number`):

Leave it at 0 for no pause.

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

0 to 3, each after the pause set above. A marketplace that still doesn't answer is skipped for the rest of the run, with a free note.

## Actor input object example

```json
{
  "imageUrls": [
    "https://cbu01.alicdn.com/img/ibank/O1CN01FCwJrl29btzNvQkHM_!!2235628087-0-cib.jpg"
  ],
  "marketplaces": [
    "1688",
    "alibaba",
    "aliexpress"
  ],
  "maxResultsPerImage": 20,
  "maxItems": 1000,
  "maxImages": 100,
  "sortBy": "relevance",
  "manufacturersOnly": false,
  "verifiedSuppliersOnly": false,
  "excludeAds": false,
  "includeDetails": false,
  "translateTo": "",
  "currency": "USD",
  "shipTo": "US",
  "compareWithPreviousRun": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "maxConcurrency": 1,
  "minDelaySecs": 0,
  "maxDelaySecs": 0,
  "maxRetries": 0
}
```

# Actor output Schema

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

Every row in the default dataset: marketplace, queryImage, imageIndex, rank, resultsFound, productId, title, url, imageUrl, images, price, priceMax, originalPrice, discountPercent, currency, priceNote, convertedPrice, convertedCurrency, exchangeRateDate, moq, unit, soldCount, soldText, bookedCount, repurchaseRate, rating, reviewCount, productScore, shippingScore, similarityScore, isBestMatch, isAd, isChoice, isCustomizable, instantOrder, launchedAt, supplierName, supplierId, supplierLoginId, supplierUrl, supplierYears, supplierCountry, supplierProvince, supplierCity, supplierScore, businessType, isFactory, factoryAudited, businessAudited, superFactory, powerMerchant, trustPass, goldSupplier, auditReportUrl, attributes, certifications, serviceTags, sellingPoints, similarItemsUrl, previousPrice, priceChange, previousSoldCount, soldSincePreviousRun, previousRunAt, isNewSinceLastRun, detailsDelivered, priceTiers, availableQuantity, unitWeightKg, shipsFrom, deliveryPromise, buyerProtections, isDropshipping, mixedOrderAllowed, categoryId, descriptionUrl, requestedAs, titleTranslated, attributesTranslated, serviceTagsTranslated, sellingPointsTranslated, translatedTo, dropshipReady, landedCostUsd, scrapedAt. A picture or marketplace that gave nothing writes one free note row saying why.

# 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://cbu01.alicdn.com/img/ibank/O1CN01FCwJrl29btzNvQkHM_!!2235628087-0-cib.jpg"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("dami_studio/1688-alibaba-aliexpress-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://cbu01.alicdn.com/img/ibank/O1CN01FCwJrl29btzNvQkHM_!!2235628087-0-cib.jpg"] }

# Run the Actor and wait for it to finish
run = client.actor("dami_studio/1688-alibaba-aliexpress-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://cbu01.alicdn.com/img/ibank/O1CN01FCwJrl29btzNvQkHM_!!2235628087-0-cib.jpg"
  ]
}' |
apify call dami_studio/1688-alibaba-aliexpress-image-search-scraper --silent --output-dataset

```

## MCP server setup

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