1688 Image Search Scraper: Find Suppliers by Photo avatar

1688 Image Search Scraper: Find Suppliers by Photo

Pricing

from $4.05 / 1,000 photo searches

Go to Apify Store
1688 Image Search Scraper: Find Suppliers by Photo

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

The Mine Works

Maintained by Community

Actor stats

0

Bookmarked

5

Total users

2

Monthly active users

16 days ago

Last modified

Features

Limited permissions

Share

20 1688 listings matched to one product photo in 26 seconds

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

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_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

{
"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

ParameterTypeDefaultWhat it does
imageUrlsarray of stringsrequiredPublic links to product photos, or base64 data: links. One search each, up to 200 a run.
maxResultsPerImageinteger20Most listings per photo, 1 to 700. 60 come in a page.
includeDetailsbooleantrueOpens 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.
excludeSponsoredbooleanfalseLeaves out 1688's paid placements.
manufacturersOnlybooleanfalseKeeps listings marked as manufacturer, super factory or factory inspected.
proxyCountrystringCNResidential 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

FieldWhat it is
offer_id1688 offer id, the number in the product link
titleListing title as published (Chinese)
offer_urlLink to the product page on detail.1688.com
image_urlMain listing picture
match_distance1688'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_sponsoredTrue for a paid placement
rankPosition in 1688's order, which mixes similarity, sales and paid placements
pageResult page, 60 matches a page
total_matchesMatches 1688 reports for this photo, at most about 700
query_imageThe photo this row was found for
query_image_indexPosition of that photo in your input, from 1

Price, order and demand

FieldWhat it is
price_cnyLowest unit price in CNY
price_max_cnyHighest unit price in CNY
price_tiersQuantity ladder with min_quantity, max_quantity (empty means and above) and price_cny. On rows with details_scraped true
moqMinimum order quantity, from the offer page when read, otherwise from the card
moq_textThe card's text, such as 1件起批
unitSelling unit, such as 件, 台, 双
stockUnits available (offer page)
sales_countUnits sold as 1688 counts them
sales_textThe card's text, such as 1.9万+件
orders_bookedNumber of orders
repurchase_rate_percentShare of buyers who ordered again, in percent

Supplier

FieldWhat it is
supplier_nameCompany name (Chinese)
supplier_type生产加工 is a manufacturer, 经销批发 a wholesaler. Filled on about 7 rows in 10
supplier_yearsYears on 1688
supplier_score1688's composite service score
supplier_province, supplier_cityLocation
shipping_fromWhere the goods ship from (offer page)
shop_urlSupplier shop link
supplier_login_id, supplier_member_id, supplier_user_idSupplier ids
is_factory_inspected, is_business_inspected, is_super_factory1688's badges
is_trust_pass_member, mixed_wholesaleTrust Pass member, mixed orders allowed (offer page)

Product

FieldWhat it is
attributesName and value pairs (Chinese). A few on the card, all of them with an offer page
tags1688's listing badges, such as 7天无理由
images, video_urlGallery and video (offer page)
category_id1688 category id (offer page)
service_labelsService promises (offer page)
details_scrapedTrue when the offer page was read for this row
details_errorWhy it is missing: verification_page, not_found or fetch_error
scraped_atWhen 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:

FieldWhat it is
offer_idThe key to store and join on
titleListing title
offer_urlProduct link
image_urlMain picture
price_cnyLowest unit price
moqMinimum order
sales_countUnits sold
supplier_nameSupplier company
is_sponsoredPaid placement or not
rankPosition in 1688's order
query_imageYour 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.

EventWhen it is chargedFree planBronze (Starter)Silver (Scale)Gold (Business)
image-searchOnce per photo that delivered rows. Covers the first page of 60 matches$0.0045$0.0045$0.00432$0.00405
results-pageOnce per further page of up to 60 matches$0.0045$0.0045$0.00432$0.00405
offer-detailsOnce per row whose offer page was read in this run$0.0027$0.00243$0.00216$0.00189
run-startOnce 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.

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"

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

Social media and video

Leads and business directories

Marketing, SEO and reviews

LinkedIn

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.