1688 Image Search Scraper: Find Suppliers by Photo
Pricing
from $4.05 / 1,000 photo searches
1688 Image Search Scraper: Find Suppliers by Photo
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.
Pricing
from $4.05 / 1,000 photo searches
Rating
0.0
(0)
Developer
The Mine Works
Maintained by CommunityActor stats
0
Bookmarked
5
Total users
2
Monthly active users
16 days ago
Last modified
Categories
Features
Share
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
maxResultsPerImagehigher 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_distanceis 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.
Part of The Mine Works E-commerce and marketplaces family: Ozon.ru Scraper, ⭐ Amazon Reviews Scraper, Amazon Product Scraper, Etsy Listings Scraper, AliExpress Scraper, Kleinanzeigen.de Scraper.
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:
{"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
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_countandorders_bookedcome 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
includeDetailson (the default), the actor opens the offer pages of the closest organic matches forprice_tiers, exactmoq,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_sponsoredmarks 1688's paid placements. About 1 row in 5 was sponsored in our test.excludeSponsoredremoves them, free. - Manufacturers only.
manufacturersOnlykeeps 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
{"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
{"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, which takes offer ids:
{"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
{"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):
{"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:
{"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
- Open the actor in Apify Console, set your input and click Save as a new task.
- In the task, open Schedules, click Add schedule and pick how often (every Monday at 08:00, for example).
- Compare runs on
offer_idandprice_cnyto see new suppliers and price changes for a product. - 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.
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
- ⭐ Amazon Reviews Scraper
- Amazon Product Scraper
- Etsy Listings Scraper
- AliExpress Scraper
- Kleinanzeigen.de Scraper
- Carsales.com.au Scraper
- eBay Product Listings Scraper
- Shopify Store Scraper
- 🛒 TikTok Shop Scraper
- Walmart Product & Price Scraper
- Vinted Scraper
Social media and video
Leads and business directories
Marketing, SEO and reviews
Real estate
Science, health and government data
Jobs and hiring
Company and business data
Food and local services
Developer and AI tools
More tools
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.

