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

Search 1688.com by product photo: paste an image URL and get matching wholesale listings with title, price, price tiers, MOQ, supplier, factory badges, sales count, image and product link. For sourcing teams matching a photo to factories. No login.

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

## Pricing

from $4.05 / 1,000 photo searches

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

## 1688 Image Search Scraper: Find Suppliers by Photo

[![20 1688 listings matched to one product photo in 26 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/1688-image-search-scraper-hero.png)](https://console.apify.com/actors/Ku36nXsh7jmAxou5K/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Updated 4 Nov 2026: first release. Search 1688.com by product photo. Paste an image URL and get the matching wholesale listings as rows: title, price, MOQ, supplier, factory badges, sales count, image and link, with quantity price tiers on the closest matches. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Start from the photo you already have.** A competitor's Amazon listing, a Shopify store, a TikTok Shop screenshot or your own picture. 1688's own search by photo (以图搜货) returns the listings that look like it. In our test, all 20 searches on real product photos returned 20 rows, and a clog, a cap and a laptop stand came back with lookalikes in the top rows.
- **60 matches per page, up to about 700 per photo.** The photo price covers the first page of 60. Set `maxResultsPerImage` higher to go deeper.
- **The supplier next to the listing.** Company name, province and city, manufacturer or wholesaler, years on 1688, service score, factory and business inspection, super factory badge and shop link. All of it is on the search card, so it is on every row.
- **A closeness number you can sort on.** `match_distance` is 1688's own visual distance. About 0.02 means the same picture. Sort a photo's rows on it to bring the closest lookalikes to the top, away from 1688's mix of similarity, sales and paid placements.
- **Pay per photo, nothing for errors.** A link that is not a picture, a photo 1688 refuses and the summary row cost nothing. No 1688 account, cookies or Chinese needed.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/Ku36nXsh7jmAxou5K/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works E-commerce and marketplaces family:** [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 20 listings that look like a folding laptop stand photo. A photo took about 26 seconds in our test runs:

```json
{
  "imageUrls": ["https://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"],
  "maxResultsPerImage": 20
}
```

Put several photo links on separate lines to search several products in one run, which also means one start fee across all of them.

Apify's free plan includes $5 of credit every month, which covers about 320 single photo runs with price tiers at this actor's price.

#### Copy to your AI assistant

```text
themineworks/1688-image-search-scraper on Apify. Searches 1688.com (Alibaba's China wholesale marketplace) by product photo and returns one flat row per matching listing with price in CNY, MOQ, sales, supplier, factory badges, visual distance and link, with quantity price tiers on the closest matches, no login. Call ApifyClient("TOKEN").actor("themineworks/1688-image-search-scraper").call(run_input={"imageUrls": ["https://example.com/product.jpg"], "maxResultsPerImage": 20}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give imageUrls (list of public image links or base64 data: links, up to 200). Optional: maxResultsPerImage (default 20, 1 to 700, 60 a page), includeDetails (default true; opens offer pages of the closest matches for price_tiers, exact moq, stock, images, about 3 a photo), excludeSponsored (default false), manufacturersOnly (default false). Listing rows have no _type field and carry offer_id, title, offer_url, image_url, price_cny, price_max_cny, price_tiers (min_quantity, max_quantity, price_cny), moq, moq_text, unit, stock, sales_count, sales_text, orders_booked, repurchase_rate_percent, match_distance (lower is closer, empty on sponsored rows), is_sponsored, rank, page, total_matches, query_image, query_image_index, supplier_name, supplier_login_id, supplier_member_id, supplier_type, supplier_years, supplier_score, supplier_province, supplier_city, shop_url, is_factory_inspected, is_business_inspected, is_super_factory, attributes, tags, details_scraped. Rows with _type summary, info or error are not listings and are never charged.
```

### Key features

- **Any public photo link.** JPEG, PNG, WebP or GIF up to 15 MB and 25 megapixels, from Amazon, AliExpress, Shopify, TikTok Shop or your own site. A base64 `data:` link works too. A sharp photo of one product on a plain background matches best; a product worn by a model still returns the right category, with looser matches.
- **Price, MOQ and sales on every row.** `price_cny`, `moq`, `sales_count` and `orders_booked` come from 1688's result cards, so a shortlist of 700 rows has them without opening a single page.
- **Quantity price tiers on the closest matches.** With `includeDetails` on (the default), the actor opens the offer pages of the closest organic matches for `price_tiers`, exact `moq`, `stock`, all attributes, the gallery and the video. 1688 usually allows about 3 such pages per photo; see the FAQ. In our test 59 rows had offer pages, and 35 of them had a single price for any quantity, which is what those listings publish.
- **Sponsored or organic.** `is_sponsored` marks 1688's paid placements. About 1 row in 5 was sponsored in our test. `excludeSponsored` removes them, free.
- **Manufacturers only.** `manufacturersOnly` keeps listings labelled 生产加工, super factories and inspected factories. Removed rows are never charged.
- **Stops cleanly.** A refused photo costs one small request and is not charged. Two refused photos in a row end the run. The run stops before its time limit and keeps every row it read. The summary row says why.

### How to use it

#### Basic: one photo, a supplier shortlist

```json
{
  "imageUrls": ["https://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"],
  "maxResultsPerImage": 20
}
```

Sort by `match_distance` to see the closest lookalikes, or by `price_cny` to see the cheapest.

#### Factories only, no paid placements

```json
{
  "imageUrls": ["https://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"],
  "maxResultsPerImage": 60,
  "excludeSponsored": true,
  "manufacturersOnly": true
}
```

#### A catalog of photos, photo price only

Turn offer pages off to pay for the photos alone, then look up the listings you care about with [1688 Wholesale Scraper](https://apify.com/themineworks/1688-wholesale-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), which takes offer ids:

```json
{
  "imageUrls": ["https://example.com/product-1.jpg", "https://example.com/product-2.jpg", "https://example.com/product-3.jpg"],
  "maxResultsPerImage": 60,
  "includeDetails": false
}
```

#### Going deep on one product

```json
{
  "imageUrls": ["https://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"],
  "maxResultsPerImage": 300,
  "includeDetails": false
}
```

That reads 5 pages of 60. Each page after the first is charged as one results page.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `imageUrls` | array of strings | required | Public links to product photos, or base64 `data:` links. One search each, up to 200 a run. |
| `maxResultsPerImage` | integer | `20` | Most listings per photo, 1 to 700. 60 come in a page. |
| `includeDetails` | boolean | `true` | Opens offer pages of the closest matches for price tiers, exact MOQ, stock, all attributes and the gallery. About 3 a photo. Charged per row that gets them. |
| `excludeSponsored` | boolean | `false` | Leaves out 1688's paid placements. |
| `manufacturersOnly` | boolean | `false` | Keeps listings marked as manufacturer, super factory or factory inspected. |
| `proxyCountry` | string | `CN` | Residential proxy country, `CN` or `HK`. Leave on China unless the run reports refusals. |

### What data do you get?

One row per listing per photo, in 1688's result order, with `rank` to keep that order.

#### Listing and match

| Field | What it is |
|---|---|
| `offer_id` | 1688 offer id, the number in the product link |
| `title` | Listing title as published (Chinese) |
| `offer_url` | Link to the product page on detail.1688.com |
| `image_url` | Main listing picture |
| `match_distance` | 1688's visual distance to your photo. Lower is closer, about 0.02 is the same picture. Compare rows of one photo with each other, not across photos: a strong match can read 0.15 on one photo and 0.75 on another. Empty on sponsored rows, where 1688's number is not a visual distance |
| `is_sponsored` | True for a paid placement |
| `rank` | Position in 1688's order, which mixes similarity, sales and paid placements |
| `page` | Result page, 60 matches a page |
| `total_matches` | Matches 1688 reports for this photo, at most about 700 |
| `query_image` | The photo this row was found for |
| `query_image_index` | Position of that photo in your input, from 1 |

#### Price, order and demand

| Field | What it is |
|---|---|
| `price_cny` | Lowest unit price in CNY |
| `price_max_cny` | Highest unit price in CNY |
| `price_tiers` | Quantity ladder with `min_quantity`, `max_quantity` (empty means and above) and `price_cny`. On rows with `details_scraped` true |
| `moq` | Minimum order quantity, from the offer page when read, otherwise from the card |
| `moq_text` | The card's text, such as 1件起批 |
| `unit` | Selling unit, such as 件, 台, 双 |
| `stock` | Units available (offer page) |
| `sales_count` | Units sold as 1688 counts them |
| `sales_text` | The card's text, such as 1.9万+件 |
| `orders_booked` | Number of orders |
| `repurchase_rate_percent` | Share of buyers who ordered again, in percent |

#### Supplier

| Field | What it is |
|---|---|
| `supplier_name` | Company name (Chinese) |
| `supplier_type` | 生产加工 is a manufacturer, 经销批发 a wholesaler. Filled on about 7 rows in 10 |
| `supplier_years` | Years on 1688 |
| `supplier_score` | 1688's composite service score |
| `supplier_province`, `supplier_city` | Location |
| `shipping_from` | Where the goods ship from (offer page) |
| `shop_url` | Supplier shop link |
| `supplier_login_id`, `supplier_member_id`, `supplier_user_id` | Supplier ids |
| `is_factory_inspected`, `is_business_inspected`, `is_super_factory` | 1688's badges |
| `is_trust_pass_member`, `mixed_wholesale` | Trust Pass member, mixed orders allowed (offer page) |

#### Product

| Field | What it is |
|---|---|
| `attributes` | Name and value pairs (Chinese). A few on the card, all of them with an offer page |
| `tags` | 1688's listing badges, such as 7天无理由 |
| `images`, `video_url` | Gallery and video (offer page) |
| `category_id` | 1688 category id (offer page) |
| `service_labels` | Service promises (offer page) |
| `details_scraped` | True when the offer page was read for this row |
| `details_error` | Why it is missing: `verification_page`, `not_found` or `fetch_error` |
| `scraped_at` | When the row was read, UTC |

#### Stable fields for automations

These were present in every listing row of our test runs (400 rows from 20 photo searches), and their names will not change:

| Field | What it is |
|---|---|
| `offer_id` | The key to store and join on |
| `title` | Listing title |
| `offer_url` | Product link |
| `image_url` | Main picture |
| `price_cny` | Lowest unit price |
| `moq` | Minimum order |
| `sales_count` | Units sold |
| `supplier_name` | Supplier company |
| `is_sponsored` | Paid placement or not |
| `rank` | Position in 1688's order |
| `query_image` | Your photo |

Rows with a `_type` field (`summary`, `info`, `error`) are not listings and are never charged. Skip them with `if not row.get("_type")`.

#### Output examples

A closest match with its offer page read (arrays trimmed):

```json
{
  "offer_id": "1017987012707",
  "title": "袜子纯棉中高筒瑜伽袜四季运动袜子健身跑步篮球袜休闲长筒袜诸暨",
  "offer_url": "https://detail.1688.com/offer/1017987012707.html",
  "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01PMZ36s1DPltjNNXhM_!!2220334940209-0-cib.jpg",
  "price_cny": 4.3,
  "price_max_cny": 4.8,
  "price_tiers": [
    { "min_quantity": 3, "max_quantity": 19, "price_cny": 4.8 },
    { "min_quantity": 20, "max_quantity": 199, "price_cny": 4.6 },
    { "min_quantity": 200, "max_quantity": null, "price_cny": 4.3 }
  ],
  "moq": 3,
  "moq_text": "3件起批",
  "unit": "双",
  "stock": 11998398,
  "sales_text": "3200+件",
  "orders_booked": 333,
  "repurchase_rate_percent": 82,
  "match_distance": 0.1814,
  "is_sponsored": false,
  "rank": 5,
  "total_matches": 700,
  "supplier_name": "义乌市同锐针织有限公司",
  "supplier_years": 2,
  "supplier_score": 4.5,
  "supplier_province": "浙江",
  "supplier_city": "金华市",
  "shop_url": "http://shop1093721397o45.1688.com",
  "shipping_from": "浙江金华",
  "attributes": { "面料名称": "精梳棉", "主面料成分": "棉", "功能": "透气,吸汗,吸湿排汗" },
  "details_scraped": true
}
```

A card row, with no offer page read:

```json
{
  "offer_id": "996706752023",
  "title": "跨境欧美女2026春夏季新款 时尚百搭纯色褶皱无袖套头半高领T恤",
  "offer_url": "https://detail.1688.com/offer/996706752023.html",
  "price_cny": 12.5,
  "moq": 1,
  "moq_text": "1件起批",
  "sales_count": 1557,
  "sales_text": "1500+件",
  "orders_booked": 536,
  "repurchase_rate_percent": 61,
  "match_distance": 0.8616,
  "is_sponsored": false,
  "rank": 5,
  "supplier_name": "义乌市圣绍服装厂",
  "supplier_type": "生产加工",
  "supplier_years": 3,
  "supplier_score": 4,
  "supplier_province": "浙江",
  "supplier_city": "金华市",
  "details_scraped": false
}
```

The last row of each run is the summary, also saved as `OUTPUT` in the key-value store: photos with matches, rows delivered, offer pages read and why the run stopped if it stopped early.

### Pricing

Pay per event: you pay for each photo that returns matches, plus a flat $0.003 per run, whatever memory you choose.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `image-search` | Once per photo that delivered rows. Covers the first page of 60 matches | $0.0045 | $0.0045 | $0.00432 | $0.00405 |
| `results-page` | Once per further page of up to 60 matches | $0.0045 | $0.0045 | $0.00432 | $0.00405 |
| `offer-details` | Once per row whose offer page was read in this run | $0.0027 | $0.00243 | $0.00216 | $0.00189 |
| `run-start` | Once per run, after the first rows reached your dataset | $0.003 | $0.003 | $0.003 | $0.003 |

Examples on the Free plan: one photo, 20 rows and 3 offer pages cost $0.003 + $0.0045 + 3 x $0.0027 = $0.0156. Ten photos with offer pages off cost $0.003 + 10 x $0.0045 = $0.048.

Never charged:

- a link that is not a readable picture (each gets an error row);
- a photo 1688 refuses, or a network failure after three tries;
- listings your filters remove, and listings past `maxResultsPerImage`;
- a row that reuses an offer page already read in the same run;
- the summary, info and error rows;
- a run with no valid input, or one that delivers no rows: the start fee is charged only once rows have reached your dataset;
- anything past your "Max cost per run". The actor checks the budget before each photo and each page and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every Monday at 08:00, for example).
3. Compare runs on `offer_id` and `price_cny` to see new suppliers and price changes for a product.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

1688.com's own search by photo, the same one behind the camera icon on the site, and the public offer pages of the closest matches.

#### How good are the matches?

On products with a clear look they are strong. In our test a white clog, a logo cap, a sneaker and a laptop stand all came back with lookalikes in the top rows. A picture that 1688 already lists came back at a distance of about 0.02. A puffer jacket worn by a model came back as the right kind of jacket, not the same one. Visual similarity does not prove two listings are the same product or come from the same factory: check the photo and order a sample.

#### Will a branded photo return that brand?

A branded photo can return unbranded lookalikes and listings that copy the logo. Treat those as a question for your own legal and compliance review. `match_distance` says nothing about whether a listing is authorised.

#### Does a poor photo return nothing?

1688 always returns its closest listings, so a blank or unclear picture still gets rows, with poor matches. Check the top rows of a photo before you trust the whole list.

#### Why do only some rows have price tiers?

A search card has one price and the MOQ text. The full ladder is on the offer page. 1688 answers with a verification page after a few offer pages from one connection, usually about 3 per photo. The actor stops there for that photo and does not try to get around it. It spends those pages on the closest organic matches, and you pay per row that got one. Every other row keeps price, MOQ, sales and supplier. For a full ladder on a listing you picked, give its offer id to [1688 Wholesale Scraper](https://apify.com/themineworks/1688-wholesale-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

#### Why does a row have a price but only one tier?

That listing publishes one price for any quantity.

#### How many matches can I get per photo?

Up to about 700, which is where 1688 stops. Set `maxResultsPerImage`. Each 60 is a page.

#### Are titles in English?

No. Titles, supplier names and attributes come back as 1688 publishes them, in Chinese. Translate them in your own pipeline.

#### How long does a run take?

About 26 seconds a photo in our test runs with offer pages on. Photos are read one after another, so 10 photos take about 4 minutes.

#### Do I need an account, cookies or a proxy?

No 1688 account and no cookies. The actor uses Apify residential proxy inside the price.

#### Which formats can I download?

JSON, CSV, Excel, XML and RSS from the Console, or through the API.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/1688-image-search-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http 1688-image-search-scraper "https://mcp.apify.com/?tools=themineworks/1688-image-search-scraper"`

#### Is it legal to scrape 1688.com?

The actor reads only public listings that anyone can see without logging in, mostly business information that suppliers publish to be found. You are responsible for how you use the data, including 1688's terms and data protection law such as GDPR and CCPA. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's listings to a sheet with Apify's Google Sheets integration; one row per listing fits a sheet as is.
- **Make, Zapier and n8n**: start a run per product photo and read its dataset with the Apify apps and nodes, for example "new product in our catalog, find its factories".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Carsales.com.au Scraper](https://apify.com/themineworks/carsales-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [eBay Product Listings Scraper](https://apify.com/themineworks/ebay-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Shopify Store Scraper](https://apify.com/themineworks/shopify-store-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [🛒 TikTok Shop Scraper](https://apify.com/themineworks/tiktok-shop-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Walmart Product & Price Scraper](https://apify.com/themineworks/walmart-product-price-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Vinted Scraper](https://apify.com/themineworks/vinted-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a photo that returns poor matches when 1688's own site does better, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search 1688.com by product photo and get every matching listing back as one row, with price, MOQ, sales and the supplier's type, location and badges, plus price tiers on the closest matches, no login.*

# Actor input Schema

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

Public links to product photos (.jpg, .png, .webp, .gif, up to 15 MB), one per line, from Amazon, AliExpress, Shopify, TikTok Shop or your own site. A base64 data: link also works. Each photo is one search. Up to 200 photos a run.

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

How many listings to return for each photo, in 1688's order. 1688 gives 60 a page and up to about 700 a photo. The photo price covers the first page; each further page is charged as a results page.

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

Open the offer pages of the closest matches for the full quantity price tiers, exact MOQ, stock, every attribute and the gallery. Charged per row that gets them. 1688 usually allows about 3 such pages per photo; the other rows keep their price, MOQ, sales and supplier from the search card. Turn off to pay for the photo only.

## `excludeSponsored` (type: `boolean`):

Drop 1688's paid placements from the results. They are never charged.

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

Keep only listings 1688 marks as a manufacturer (生产加工), a super factory or factory inspected. Removed listings are never charged.

## `proxyCountry` (type: `string`):

Residential proxy country. Leave on China unless the run reports refusals.

## Actor input object example

```json
{
  "imageUrls": [
    "https://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"
  ],
  "maxResultsPerImage": 20,
  "includeDetails": true,
  "excludeSponsored": false,
  "manufacturersOnly": false,
  "proxyCountry": "CN"
}
```

# Actor output Schema

## `results` (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://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"
    ],
    "maxResultsPerImage": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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 = {
    "imageUrls": ["https://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"],
    "maxResultsPerImage": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/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 '{
  "imageUrls": [
    "https://m.media-amazon.com/images/I/71gHzHhVhOL.jpg"
  ],
  "maxResultsPerImage": 20
}' |
apify call themineworks/1688-image-search-scraper --silent --output-dataset

```

## MCP server setup

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