Chinagoods Image Search Scraper

🚀 Chinagoods Image Search Scraper: Find Yiwu Market Products by Image

Search by image on Chinagoods, the official online platform of the Yiwu International Trade City, and get every visually similar product as clean JSON, CSV or Excel. The Chinagoods Image Search Scraper takes product photos and returns matching Yiwu market products with wholesale price in CNY, quantity price tiers, minimum order, supplier, the supplier's physical booth in Yiwu and a similarity score. Use it to find a product by image, to shortlist Yiwu suppliers, or as a simple alternative to a Chinagoods API.

🎯 Use Cases

• Find product by image in the Yiwu market: turn a photo from your catalogue, a competitor's store or social media into the Yiwu wholesalers who sell the same item.
• Yiwu suppliers shortlist: see every shop that offers the product side by side, with per-piece price, price tiers, minimum order, shop level and years on the market.
• Yiwu market visit planning: get the market district, gate, floor, street and booth number of each supplier before a buying trip to Yiwu International Trade City.
• Price benchmarking: compare AliExpress, Alibaba, Amazon or 1688 listings against the Yiwu wholesale price of the same product.
• Sourcing agent workflows: a Yiwu sourcing agent can run a client's whole photo list in one go and hand over supplier options in a spreadsheet.
• Find similar products by image: discover look-alike variants and alternative suppliers for products you already sell.

✨ Features

• Photo in, products out: any direct image URL (JPG, PNG, WebP, GIF or AVIF up to 10 MB) or a data: URL; one search per image, many images per run.
• Similarity-ranked results: each image returns Chinagoods' own set of visually similar products (usually 30–40, cut off by similarity), each with a similarity score and its position.
• Wholesale pricing: price per piece in CNY, quantity price tiers, minimum order quantity and market price where the supplier lists them.
• Supplier and booth location: shop name, shop page, shop level, points and years on the market, plus the market district, gate, floor, street and booth number split out of the booth address.
• Demand signals: units sold, orders, favourites, views, stock, video and new-product flags.
• Sorting: best match, sales, or price low/high, the same options as the image search on Chinagoods.
• No duplicates: a product that appears twice in one result set is saved once.
• Fair billing: one price per image searched. Images that fail to load or return no matches are free, and the run stops cleanly at your maximum charge.

🛠️ How It Works

1. Paste image URLs of the products you want to source.
2. Pick the sort order and Max results per image (default 40).
3. Run the scraper and download one row per matching product, grouped by the image that found it, or pull the results through the API.

⚙️ Input

Field	What it does
Image URLs	Photos to search with: direct image URLs or data: URLs. Empty input runs one example image.
Max results per image	Matches kept per image. Default 40, maximum 100.
Sort	best_match (default), sales, price_asc or price_desc.

{
    "imageUrls": [
        "https://cdnimg.chinagoods.com/img/ylbm/img/ibank/O1CN012RXqV81NBFIM7sEDT_!!3845871531-0-cib.jpg",
        "https://cdnimg.chinagoods.com/aimg/mt/im/94168/0836187d1828cdc5a4e7f239959a132f.jpg"
    ],
    "maxResultsPerImage": 40,
    "sort": "best_match"
}

💰 Pricing

Pay per image searched. No monthly rental.

Event	Price	What you get
Image search	$0.02 per image	One image searched and its full set of matches (up to 100).
Actor start	$0.00005 per run	Charged once when the run starts.

Examples: 1 image = $0.02 · 10 images = $0.20 · 100 images = $2.00 (plus $0.00005 per run). Images that cannot be loaded or return no matches are not charged.

📊 Sample Output Data

One row per matching product. A real row (image list trimmed):

{
    "searchImage": "https://cdnimg.chinagoods.com/aimg/mt/im/94168/0836187d1828cdc5a4e7f239959a132f.jpg",
    "position": 6,
    "productId": "1839581857311690754",
    "title": "hi, cat! Cute cat hair clips, girlish bangs, side clips of acrylic hair clips, duckbeak hair clips, hair accessories",
    "url": "https://en.chinagoods.com/product/1839581857311690754",
    "image": "https://cdnimg.chinagoods.com/img/ylbm/img/ibank/O1CN013GSbIE1ohl3FpQFgw_!!3547335257-0-cib.jpg",
    "images": [
        "https://cdnimg.chinagoods.com/img/ylbm/img/ibank/O1CN013GSbIE1ohl3FpQFgw_!!3547335257-0-cib.jpg",
        "https://cdnimg.chinagoods.com/img/ylbm/img/ibank/O1CN01JWnTpG1ohl3GdgdeG_!!3547335257-0-cib.jpg",
        "…"
    ],
    "price": 1.2,
    "marketPrice": null,
    "currency": "CNY",
    "minOrderQuantity": 1,
    "priceTiers": [
        { "minQuantity": 1, "price": 1.4 },
        { "minQuantity": 20, "price": 1.3 },
        { "minQuantity": 100, "price": 1.2 }
    ],
    "similarityScore": 75,
    "sold": null,
    "orderCount": 0,
    "favorites": 0,
    "views": 1,
    "stock": 2993796,
    "hasVideo": false,
    "isNew": false,
    "isAd": false,
    "foreignTrade": false,
    "categoryId": 4122,
    "shopId": 6303205,
    "shopName": "Yueya Accessories (Mizi Accessories",
    "shopUrl": "https://en.chinagoods.com/store/6303205",
    "shopLevel": "LV3",
    "shopPoints": 4545,
    "shopYears": 7,
    "market": "International Trade City District 1",
    "marketZone": "01",
    "boothLocation": "一区东扩8号门3楼7街103502A",
    "gate": "8",
    "floor": "3",
    "street": "7",
    "boothNumber": "103502A",
    "detectedObject": { "x": 0, "width": 800, "y": 0, "height": 780 },
    "scrapedAt": "2026-10-22T15:11:03.657Z"
}

Prices are in Chinese yuan (CNY) per piece, as listed on Chinagoods; price is the lowest tier. boothLocation is the address as the market writes it, and gate, floor, street and boothNumber are split out of it. detectedObject is the part of your photo that was matched, in pixels of the searched image (scaled to at most 800 px); it is null when the site does not report one.

Images that fail come back as { "searchImage": "...", "status": "image_error" | "failed" | "no_matches", "error": "..." } rows and are not charged.

🔁 Schedule and Integrate

Most sourcing jobs are one-off runs, but for supplier and price monitoring run the same photos once a week: each run is a dated snapshot of who sells the product in the Yiwu market and at what price. Set it up in Apify Schedules, and send the results to Google Sheets, Zapier, Make, n8n or a webhook with Apify integrations.

🤖 Use with AI Agents (MCP)

This Actor works as a tool in Claude, ChatGPT, Cursor and other MCP clients through the Apify MCP server (https://mcp.apify.com). An agent can call it with:

{ "imageUrls": ["https://cdnimg.chinagoods.com/aimg/mt/im/94168/0836187d1828cdc5a4e7f239959a132f.jpg"], "maxResultsPerImage": 10 }

❓ FAQ

Does Chinagoods have an official API? Chinagoods does not offer a public API for its image search. This Actor needs no key or account and returns the same public results a buyer sees on the site, with the booth address already split into gate, floor, street and booth number.

How do I search the Yiwu market by image? Put the photo's URL into Image URLs and run the Actor. Each image returns the visually similar Yiwu market products with prices, suppliers and booth locations, ranked by similarity.

Do I need a Chinagoods account? No.

How many results does one image return? Chinagoods returns one set of visually similar products per image, usually 30–40, cut off by similarity. There are no further pages; Max results per image keeps up to 100.

Why are sold, marketPrice or priceTiers empty? Many suppliers list no sales figure, no market price or a single price only. Those fields are null or an empty list then.

Can I find Yiwu suppliers outside Chinagoods? Yes: run the same photos through the Yiwugo, 1688 and Made-in-China image search scrapers below and compare suppliers across platforms.

🔗 Related Scrapers

• Yiwugo Image Search Scraper: the same photo search on Yiwugo, the other big Yiwu wholesale market site.
• 1688 Image Search Scraper: search China's domestic 1688 wholesale market by photo.
• AliExpress Image Search Scraper: retail prices for the same product on AliExpress.
• Alibaba Image Search Scraper: find Alibaba.com suppliers and manufacturers by photo.
• Made-in-China Image Search Scraper: Made-in-China.com suppliers by photo, with US$ price ranges and MOQ.